The SEO + AI-search (GEO/AEO) optimization toolkit for Claude Code — two-score audit + opt-in fixer. Built for 2026-2027.
> /plugin marketplace add Hainrixz/claude-seo-ai> /plugin install claude-seo-ai@claude-seo-ai
Claude Code plugin that analyzes your project, asks 3 questions, and generates a complete payment integration (Stripe · Mercado Pago · Wompi · Lemon Squeezy + frontend + DB + signed webhook + customer portal + refund). Local-first, security-enforced via PostToolUse hooks. Bilingual ES/EN.
@hainrixzFAQ
claude-seo-ai is a Claude Code plugin with 29 hand-picked skills for marketing work, indexed on Flowy. Install it with the command on its page. It includes audit, fix, geo. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
Repo: Hainrixz/claude-seo-ai
Two scores, never blended. A page can rank well in Google yet be uncitable by ChatGPT, Perplexity, Google AI Overviews, Gemini, and Claude — or the reverse.
claude-seo-aimeasures both and tells you exactly what to fix.
🇪🇸 Resumen en español al final · guías completas en docs/es/.
AI answer engines now sit beside classic search as a primary discovery channel, and the rules for being cited differ from the rules for ranking. Most SEO tools treat AI search as a footnote and never write fixes back into your code. This one is built for 2026–2027: honest, agent-native, and able to both diagnose and (opt-in) fix.
It is original work — inspired by the patterns of community SEO tooling but copies no branding, text, or names from any other project. MIT-licensed.
As a Claude Code plugin (recommended):
/plugin marketplace add Hainrixz/claude-seo-ai
/plugin install claude-seo-ai@claude-seo-ai
/reload-plugins
Cross-agent (Cursor, Codex, Gemini CLI, Windsurf…) via Vercel Skills:
npx skills add Hainrixz/claude-seo-ai
The plugin works fully offline (Tier 0, no keys). See Data tiers for optional rendering and API integrations.
/claude-seo-ai:audit <url|path> [--render auto|static|js] [--vertical auto|saas|blog-publisher|local-business|ecommerce|docs]
/claude-seo-ai:geo <url|path> # AI-search (GEO/AEO) subset → AI Visibility score
/claude-seo-ai:score # recompute/show scores from the last audit
/claude-seo-ai:fix <url|path> [--category schema|meta|robots|sitemap|hreflang|alt|canonical|social|llms] [--dry-run]
audit is read-only and never touches your files. fix previews diffs by default and writes only after you confirm each change. Power users can call any module directly, e.g. /claude-seo-ai:seo-schema-jsonld.
Every audit reports two 0–100 scores with letter bands (A–F) and a one-line interpretation (details):
Severity gating caps a score at F if something critical fails (e.g. site-wide noindex). Conditional verticals re-normalize so a blog isn't penalized for lacking Product schema. needs_api checks are excluded from the math and counted separately as score confidence.
A skill-first, three-layer design (Claude is the runtime; the Node helpers are optional):
audit/geo/score/fix).seo-orchestrator builds a shared PageSnapshot, detects the site vertical, and dispatches read-only specialist subagents in parallel.seo-* modules each emit findings conforming to schema/finding.schema.json — with observed evidence and a runnable verification.reproduce command. See docs/en/architecture.md.A complete 2026 suite, grouped:
| Area | Modules |
|---|---|
| Crawl & index | crawlability/robots (M1), indexability + canonical + site health (M2/M3), rendering CSR/SSR/SSG (M4), sitemaps (M17) |
| Structured data | Tier-1 JSON-LD validate + generate (M5), entity/Knowledge-Graph sameAs (M6) |
| On-page & meta | title/meta/head (M7), mobile (M7b), headings (M7c), social cards (M8), images & alt (M9), internal linking (M10) |
| AI search (GEO/AEO) | answer extractability (M11), fact density & original data (M12), AI-crawler access + llms.txt (M14/M21) |
| Content & trust | E-E-A-T (M16), freshness (M13) |
| Performance | Core Web Vitals — LCP/INP/CLS (M15) |
| Verticals (conditional) | e-commerce/Product (M18), local (M19), international/hreflang (M20) |
The GEO/AEO modules score how citable your content is: self-contained answer blocks, fact density, original data, entity linking, and whether retrieval bots (OAI-SearchBot, Claude-SearchBot, PerplexityBot) can actually reach and render your page. See references/ai-crawlers.md.
The fixer (skills/fix) is disable-model-invocation: true — Claude can never trigger writes on its own. Only /claude-seo-ai:fix does, and only the one writer subagent (seo-fixer-writer) has Write/Edit; every auditor is read-only by tool allowlist.
<title>/meta description, answer-block/TL;DR rewrites, internal-link insertions, heading restructuring, generated image alt text.Dry-run by default · unified-diff preview · git-aware (refuses a dirty tree) · backups under ${CLAUDE_PLUGIN_DATA} · idempotent · re-verifies each change · never writes to .git/secrets/lockfiles (enforced by a PreToolUse hook).
This tool refuses to ship SEO myths:
sameAs identity links.confidence tier (established / directional / speculative); leaked/inferred guidance (e.g. NavBoost) ships only as directional.| Tier | Needs | Adds |
|---|---|---|
| 0 (default) | nothing | full offline audit via WebFetch + bundled scripts |
| 1 | a render MCP (Playwright/Firecrawl) and/or PSI_API_KEY | JS rendering for SPAs; real Core Web Vitals (CrUX field data) |
| 2 | Search Console / Merchant Center (OAuth) | indexation state, impressions, feed consistency |
See .mcp.json.example for opt-in render MCPs and docs/en/mcp.md.
The skills work as pure Markdown; the zero-dependency Node helpers in scripts/ sharpen accuracy and make verification.reproduce runnable (Node ≥ 18, no install step):
node scripts/parse-html.mjs --file tests/fixtures/blog-post.html
node scripts/validate-jsonld.mjs --url https://example.com
node scripts/parse-robots-sitemap.mjs --url https://example.com
node scripts/score.mjs --findings findings.json
node tests/run.mjs # 30 assertions over the fixtures
.claude-plugin/ plugin.json + marketplace.json
skills/ 4 command skills (audit, geo, score, fix → /claude-seo-ai:audit …)
+ orchestrator, vertical-detect, crawl-render, seo-score + ~20 audit modules
agents/ 5 subagents (4 read-only auditors + 1 writer)
hooks/ PreToolUse write guard
scripts/ optional zero-dep Node helpers (+ verification)
references/ scoring model, AI crawlers, schema, CWV, routing
schema/ finding + report JSON Schemas, JSON-LD templates
docs/en, docs/es bilingual guides
assets/ pixel-art images
tests/fixtures sample sites for verification
Built by Enrique Rocha — I help teams ship AI: consulting, automations, and agents. This is a community, MIT-licensed project: use it, fork it, open issues and PRs (see CONTRIBUTING.md).
MIT · Claude mascot artwork generated for this project in pixel-art style.
claude-seo-ai es la herramienta open-source de SEO + búsqueda con IA para Claude Code. Audita cualquier sitio en dos puntajes independientes — Search SEO clásico y Visibilidad en IA (GEO/AEO) — con hallazgos reproducibles, y opcionalmente aplica las correcciones seguras por ti (meta tags, JSON-LD, robots.txt para crawlers de IA, hreflang, sitemaps…), siempre con confirmación previa.
/plugin marketplace add Hainrixz/claude-seo-ai → /plugin install claude-seo-ai@claude-seo-ai. Cross-agente: npx skills add Hainrixz/claude-seo-ai./claude-seo-ai:audit <url> · :geo · :score · :fix (vista previa por defecto; nunca escribe sin tu confirmación).Guías completas en español: docs/es/ · hecho con cariño por tododeia.com.
.claude-plugin/
marketplace.json
plugin.json
.gitignore
.mcp.json.example
agents/
ai-search-geo-specialist.md
content-eeat-analyst.md
schema-generator.md
seo-fixer-writer.md
technical-auditor.md
assets/
about.png
ai-citations.png
dual-score.png
fixer.png
hero.png
how-it-works.png
CHANGELOG.md
CONTRIBUTING.md
docs/
en/
architecture.md
distribution.md
mcp.md
scoring.md
usage.md
es/
architecture.md
distribution.md
mcp.md
scoring.md
usage.md
hooks/
hooks.json
LICENSE
README.md
references/
ai-crawlers.md
cwv-thresholds.md
routing.md
schema-tier1.md
scoring-model.md
schema/
audit-report.schema.json
finding.schema.json
scripts/
check-answerblocks.mjs
check-freshness.mjs
factdensity.mjs
guard-write.mjs
hreflang-check.mjs
lib/
util.mjs
link-graph.mjs
package.json
parse-html.mjs
parse-robots-sitemap.mjs
psi-client.mjs
score.mjs
validate-jsonld.mjs
skills/
audit/
SKILL.md
fix/
SKILL.md
geo/
SKILL.md
score/
SKILL.md
seo-ai-crawlers/
SKILL.md
seo-core-web-vitals/
SKILL.md
seo-crawl-render/
SKILL.md
seo-crawlability/
SKILL.md
seo-ecommerce/
SKILL.md
seo-eeat/
SKILL.md
seo-entity-linking/
SKILL.md
seo-freshness/
SKILL.md
seo-geo-answerblocks/
SKILL.md
seo-geo-factdensity/
SKILL.md
seo-headings-structure/
SKILL.md
seo-images-media/
SKILL.md
seo-indexability/
SKILL.md
seo-internal-linking/
SKILL.md
seo-international/
SKILL.md
seo-local/
SKILL.md
seo-meta-onpage/
SKILL.md
seo-mobile/
SKILL.md
seo-orchestrator/
SKILL.md
seo-rendering/
SKILL.md
seo-schema-jsonld/
SKILL.md
seo-score/
SKILL.md
seo-sitemaps/
SKILL.md
seo-social-cards/
SKILL.md
seo-vertical-detect/
SKILL.md
tests/
fixtures/
blog-post.html
robots.txt
sample-findings.json
run.mjs© 2026 Flowy · Free and open source
Built for Claude Code · Not affiliated with Anthropic