About this project

Claude SEO is an open-source plugin for Claude Code that adds a suite of SEO analysis and planning tools behind /seo commands. The public version is MIT-licensed and can be installed through Claude Code's plugin marketplace, or with the supplied Unix/macOS/Linux and Windows installation scripts. The setup process creates an isolated Python environment and installs Playwright Chromium; a doctor command checks runtime readiness. The plugin provides 32 user-invocable commands and combines 25 sub-skills with 18 specialist agents. A full site audit can delegate work to up to 15 parallel agents and then synthesize the results into a prioritized action plan. Individual commands support deep page analysis, technical audits, content and E-E-A-T evaluation, content briefs, Schema.org detection and generation, XML sitemap analysis or generation, image optimization, programmatic SEO, competitor pages, and strategic plans for SaaS, local, ecommerce, publisher, and agency use cases. AI-search and content features include GEO/AEO analysis, passage citability scoring, question-based heading checks, structured-data coverage, entity-presence checks, and guidance aligned with Google's AI Optimization and helpful-content documentation. The schema tooling focuses on JSON-LD and covers types such as organization, article, product, local business, event, job, course, software application, service, Q&A, and video, while also flagging deprecated patterns. Local and maps features cover Google Business Profile signals, NAP citation consistency, reviews and sentiment, geo-grid rank tracking, competitor radius mapping, and LocalBusiness markup. Other workflows include hreflang and international SEO, ecommerce and marketplace analysis, backlink profile analysis, SERP-based semantic clustering, search experience optimization, and SQLite-based SEO drift monitoring with baselines and comparisons. Google integrations use a tiered credential model. With only an API key, the plugin can use PageSpeed Insights, CrUX, and CrUX history. OAuth or service-account credentials add Search Console and Indexing API access, GA4 configuration adds organic traffic analytics, and an Ads developer token adds Keyword Planner data. Credentials are stored locally under the Claude SEO configuration directory with restricted permissions. Reports are written as local Markdown and JSON files, with PDF generation through WeasyPrint and matplotlib; the repository description also lists Excel reporting. Optional extensions add Firecrawl crawling, DataForSEO data, AI image generation, Ahrefs data, AI share-of-voice tracking, LLM citation tracking, Bing Webmaster Tools and IndexNow submission, and multi-page Lighthouse runs. The implementation follows Claude Code's Agent Skills structure. Skills and agents are auto-discovered from local skill and agent directories, with a central orchestrator handling industry detection, parallel delegation, and final synthesis. Each recommendation is designed to include its supporting observation, dependency relationship, failure check, and leading indicator. The tool is intended for SEO agencies, in-house SEO teams, publishers, SaaS companies, ecommerce businesses, and freelance consultants, rather than operating as a standalone web application.