Universal SEO skill for Claude Code. 26 sub-skills + 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.
Contributors
Claude SEO is created and maintained by @AgriciDaniel.
This project thrives thanks to community contributions from the AI Marketing Hub Pro Hub Challenge and open-source pull requests.
Pro Hub Challenge (v1.9.0)
The Pro Hub Challenge invited community members to build extensions for Claude SEO and Claude Blog. These submissions were reviewed, security-audited, and integrated into v1.9.0 with the contributors' permission.
| Contributor | Submission | Repo | Integrated As |
|---|---|---|---|
| Lutfiya Miller (Winner) | Semantic Cluster Engine | Drfiya/semantic-cluster-engine | seo-cluster (core skill) |
| Chris Muller | Multi-lingual SEO | Chriss54/claude-blog-multilingual | seo-hreflang enhancements (cultural profiles, locale formats, content parity) |
| Florian Schmitz | SXO Skill | tools-enerix/claude-sxo-skill | seo-sxo (core skill) |
| Dan Colta | SEO Drift Monitor | dancolta/seo-drift-monitor | seo-drift (core skill) |
| Matej Marjanovic | E-commerce + DataForSEO Cost Config + ASO + Platform Support | matej-marjanovic/claude-seo | seo-ecommerce (core), cost infrastructure, seo-aso (extension), AGENTS.md |
| Benjamin Samar | SEO Dungeon | n/a | Reviewed (not integrated in v1.9.0) |
Framework Integration (v1.9.5)
| Source | Type | License | Integrated As |
|---|---|---|---|
| FLOW by Daniel Agrici | 41 AI prompts + framework doc + bibliography | CC BY 4.0 | seo-flow skill + skills/seo-flow/references/ |
Attribution header on every bundled prompt file (automated by scripts/sync_flow.py).
Community Pull Requests
v2.6.0
| Contributor | PR | Contribution category | Review outcome |
|---|---|---|---|
| @lciolecki | #339, #340 | Proxy support for the Google API clients; REST transport for GA4 | Merged, with an error-classification follow-up fix |
v2.5.1
Credit is preserved when a patch was superseded by another fix for the same bug.
| Contributor | PR | Contribution category | Review outcome |
|---|---|---|---|
| @rudycelekli | #365, #367, #368, #369, #370, #371, #372, #373, #374, #375, #376, #377, #378, #379, #380, #381, #400 | Fifteen fixes across sitemaps, IndexNow, content checks, charset detection, schema validation and the /seo command |
15 merged; #365 and #367 superseded by #389 and #359, with a test from #365 carried over |
| @lab1207 | #358, #359 | JSON-LD @graph handling in the parser, skill and agent; first fix for the list-valued @type hook crash |
#359 merged; #358 superseded by #389, with its @graph test carried over |
| @deosiree | #389 | List-valued JSON-LD @type in the schema hook, with a warning for malformed values |
Merged |
| @Afloat16 | #403, #404, #405 | Drift URL and robots directive parsing; brand suffix word boundaries | Merged |
| @HelloWorld3326 | #384, #385 | UTF-8 BOM sitemaps; <base href> resolution for links and images |
Merged, with follow-up fixes |
| @switchcasestudio | #345, #346 | Inline-tag spacing in headings and link text; Natural Language v1 request field | Merged |
| @zhangkom | #408, #409 | IndexNow text-mode errors; Indexing API quota stop | Merged |
| @xunguangzlj-cloud | #393, #406 | CrUX zero-baseline trend; GA4 top-pages error reporting | Merged, with a report follow-up fix |
| @AdityaWagh06 | #413, #414 | Deprecated-types reference link; hook launcher skip for files without JSON-LD | Merged, with the skip scoped to the schema hook |
| @dajiaohuang | #387 | Google property selection bound to the audited domain | Merged, with follow-up fixes |
| @hboon | #364 | Backlink verification: exact target match, page-level nofollow, GET when HEAD fails | Merged, with follow-up fixes |
| @whatcodehaveyougit | #332 | Image format judged by the served bytes, not the URL extension | Merged, with follow-up fixes |
| @pucilpet | #418 | Common Crawl newest web graph release discovery | Merged |
| @Ethereal49 | #396 | Matomo top-pages error reporting | Merged |
| @angelocastellani | #386 | Merchant task polling while handed or queued | Merged, with a follow-up fix |
| @harshdazz | #383 | Windows venv swap retry | Merged |
| @connabyss | #392 | Strict --release value check |
Merged |
| @canermoral5-sys | #362 | seo-geo wording: correlations stated as correlations |
Merged |
| @agammann | #385, #387 | Review findings on the base URL and property selection changes | Both findings fixed in the follow-up commits |
| @joachimBrindeau | #318 | Port-bound DNS pin for local targets; stricter local target parser | The port-bound pin was reimplemented in the security follow-up commit; the rest of the PR is still under review |
| @hydraxman | #372 | Review finding on list-valued price specification types | Fixed in the follow-up commit |
2026 maintenance review cycle
These contributors supplied implementation work or substantive design proposals. Credit is preserved when a patch was superseded, selectively reimplemented, or not merged after review.
| Contributor | PR | Contribution category | Review outcome |
|---|---|---|---|
| @wonsukchoi | #165, #166, #167, #168, #169, #170, #171 | Image paths, runtime setup, sitemap discovery, DataForSEO permissions, Bing API redesign, and Windows launcher proposals | Findings informed current-base implementations; patches were superseded or consolidated after review |
| @powehi-ai | #162 | Codex manifest and documentation proposal | Reviewed; not integrated because the repository already uses its portable Codex surface |
| @maticyorg | #160 | Subagent model inheritance proposal | Reviewed; the proposed model value was not portable, so the patch was not integrated |
| @GilboBlagins | #159 | Optional external knowledge-directory design | Reviewed; not integrated because the trust boundary needs a stricter design |
| @voipcomjohn | #158 | Windows UTF-8 hook output | Reconciled into the current-base Windows encoding work |
| @MSADTP | #157 | Full JSON-LD extraction before output truncation | Reimplemented with bounded structured parsing and regression coverage |
| @lukababu | #154 | Grok Build installation documentation | Selectively integrated using current official Grok compatibility guidance |
| @kuhlsnu | #150 | Hosted-builder SPA detection and render timeout handling | Selectively reimplemented with bounded renderer behavior and tests |
| @SENTMarketing | #147 | Windows-safe OAuth token permissions | Superseded by the current guarded implementation and regression coverage |
| @BubblyWolf | #145 | Broken references, documentation accuracy, Windows portability, and CI review | Useful findings were reconciled selectively against the current release base |
| @mubashirsidiki | #141 | Bright Data extension proposal | Fully reviewed; not integrated because the extension needs a separate security and cost-control design |
| @mukulcodezz | #140 | Public marketplace branding correction | Superseded by the public branding already shipped on the release branch |
| @us | #136 | fastCRW crawling extension proposal | Fully reviewed; not integrated because installer, safety, and integration contracts need redesign |
v2.2.0
| Contributor | PR | What |
|---|---|---|
| @manishpaulsimon | #117 | Cross-platform drift_baseline fetch -> parse handoff (synthesis basis) |
| @solbergryan | #128 | Windows compatibility for drift scripts and installer |
| @GieriGuru | #111 | Handle Windows Store Python alias in install.ps1 |
| @Shieldxx | #115 | Windows + non-Latin-1 baseline portability |
| @imranaliraqi | #125 | Windows path + UTF-8 baseline portability |
| @eduardofortesr | #101 | Cross-platform JSON-LD validator hook (python3) |
| @fayerman-source | #104 | Move Google API key from URL to request header |
| @nickgraynews | #113 | Drop deprecated GSC Sitemaps indexed field |
| @PenthouseWaldkirchen | #118 | Add authors and keywords to pyproject.toml |
| @chat2deskmx | #123 | Add ruff config and lint cleanup |
v1.9.7
| Contributor | PR | What |
|---|---|---|
| @xiaolai | #62 | Sync extensions/dataforseo skill with core |
| @xiaolai | #63 | Sync extensions/banana seo-image-gen skill |
| @xiaolai | #64 | Pin MCP server package versions in extension installers |
| @CrepuscularIRIS | #67 | Detect marketplace plugin install path in DataForSEO extension |
| @evanlu14 | #69 | pagespeed_check KeyError fix (audit_details) |
| @EDSprog | #70 | Update README install section |
| @NicT89 | #73 | Migrate moz_api to v2 REST endpoints |
| @AndronMan | #74 | Add Write tool to seo-geo agent |
| @puneetindersingh | #56 | Add seo-content-brief skill |
v1.9.0 and earlier
| Contributor | PR | What |
|---|---|---|
| @edocltd | #50 | Ukrainian localization |
| @MalteBerlin | #45 | Sub-skills count correction |
| @olivierroy | #43 | Extension install fix |
Community Issue Reports
v2.5.1
| Reporter | Issue | Contribution category |
|---|---|---|
| @unterholzfrank | #357 | Schema hook crash on a list-valued @type |
| @soulalpaca-ctrl | #382 | Schema hook crash on a list-valued @type |
| @nickdumitru | #333, #334, #335 | @graph false positives, GBP verified status, news sitemap cap |
| @unisone | #394, #395 | priceSpecification list crash; Matomo top-pages error loss |
| @tomkor | #337 | Wrong-site GA4 and GSC data from the global default property |
| @zachlagden | #342 | /seo dropping the command word |
| @Krtgya | #348 | Windows WinError 5 at the venv swap, with diagnosis and fix shape |
| @osmosphuket-hub | #330 | Spaces dropped around inline tags |
| @toquedemidas | #322 | Entity extraction failing with HTTP 400 |
| @namaserajesh | #412 | Unlinked reference file |
| @upfastai | #402 | Install blocked by a scanner on a curl example |
| @Docrichards1 | #252 | Relative reference paths on Windows |
2026 maintenance review cycle
| Reporter | Issue | Contribution category |
|---|---|---|
| @DreaminginAI | #176 | Format-specific report dependency analysis and verification |
| @sam-fakhreddine | #174 | Managed virtual-environment bypass in agent script commands |
| @n-youn9 | #173 | GSC total-limit pagination hang and reproducible root-cause analysis |
| @jonathanlombi-debug | #163 | Banana extension script-path and install-layout analysis |
| @sohilshrestha0 | #161 | Missing render script path in delegated audit execution |
| @Kickermax | #153 | Bing Webmaster endpoint failure reproduction and method probing |
| @Arul-Raaj | #149 | Retired FAQ rich-result guidance report |
| @atahan150 | #137, #138, #139, #148 | Plugin provisioning, Windows Python resolution, portable script roots, and DataForSEO MCP permissions |
| @maulikvora | #142 | Non-default WordPress sitemap discovery |
Security Disclosures
Responsible disclosures incorporated into v2.2.0. Thank you for reporting privately or via issues:
| Reporter | Report | What |
|---|---|---|
| @Fushuling | #110 | SSRF parser-differential bypass in validate_url |
| @webgunnz | #122, #121 | Google API key leak in error output; UTF-8 double-encode |
| @fayerman-source | #130, #103 | GSC false "0 clicks" totals; NLP V1 entity metadata |
How to Contribute
See CONTRIBUTING.md for guidelines on submitting pull requests, creating extensions, and participating in future challenges.
Join the community: