{"id":50593373,"url":"https://github.com/metawhisp/amazing-seo-skill","last_synced_at":"2026-06-05T12:01:58.653Z","repository":{"id":356947574,"uuid":"1234657582","full_name":"metawhisp/amazing-seo-skill","owner":"metawhisp","description":"Comprehensive SEO + AEO + GEO audit skill for Claude Code. Real-browser Core Web Vitals, Schema.org validation, live LLM citation tracking across ChatGPT/Perplexity/Claude/Grok, internal link graph, hreflang, multi-page audits, growth opportunities. Works with any website.","archived":false,"fork":false,"pushed_at":"2026-05-18T14:35:15.000Z","size":396,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-18T16:33:28.519Z","etag":null,"topics":["aeo","ai-overviews","ai-seo","answer-engine-optimization","anthropic","claude","claude-code","claude-skill","core-web-vitals","generative-engine-optimization","geo","hreflang","llm","llms-txt","schema-markup","schema-org","seo","seo-audit","structured-data","technical-seo"],"latest_commit_sha":null,"homepage":"https://github.com/metawhisp/amazing-seo-skill","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/metawhisp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-10T13:26:36.000Z","updated_at":"2026-05-18T14:38:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/metawhisp/amazing-seo-skill","commit_stats":null,"previous_names":["metawhisp/amazing-seo-skill"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/metawhisp/amazing-seo-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metawhisp%2Famazing-seo-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metawhisp%2Famazing-seo-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metawhisp%2Famazing-seo-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metawhisp%2Famazing-seo-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/metawhisp","download_url":"https://codeload.github.com/metawhisp/amazing-seo-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metawhisp%2Famazing-seo-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33939227,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-05T02:00:06.157Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aeo","ai-overviews","ai-seo","answer-engine-optimization","anthropic","claude","claude-code","claude-skill","core-web-vitals","generative-engine-optimization","geo","hreflang","llm","llms-txt","schema-markup","schema-org","seo","seo-audit","structured-data","technical-seo"],"created_at":"2026-06-05T12:01:57.787Z","updated_at":"2026-06-05T12:01:58.644Z","avatar_url":"https://github.com/metawhisp.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Amazing SEO Skill — SEO + AEO + GEO Audit for Claude Code\n\nThe most comprehensive SEO skill for Claude Code: traditional SEO audit, AI\nOverviews readiness (GEO), live LLM citation tracking (AEO), Schema.org\nvalidation, real-browser Core Web Vitals, internal link graph analysis, and\ndata-driven growth opportunities — all from a single Claude Code prompt.\n\n[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n[![Claude Code Skill](https://img.shields.io/badge/Claude%20Code-Skill-purple)](https://docs.claude.com/en/docs/claude-code)\n[![SEO + AEO + GEO](https://img.shields.io/badge/SEO%20%2B%20AEO%20%2B%20GEO-✓-green)]()\n\n\u003e **Why this exists.** Standard SEO tools tell you a site is \"92/100\" while\n\u003e ChatGPT, Perplexity, Claude, and Grok don't cite it once for any of its core\n\u003e queries. This skill closes the gap by combining traditional SEO checks with\n\u003e live AI-search visibility testing.\n\n## What it does\n\n### Traditional SEO\n- **Smart crawler** via `tools/crawl.sh` — auto-selects between Screaming Frog (≤500 URLs free tier) and our own **`amazing-crawl`** (async Python, unlimited URLs, no GUI, works in CI/Docker)\n- **Full website audits** via `tools/site_audit.sh` — parallelises per-page audits across sampled sitemap URLs, emits unified Markdown report\n- **Single-page Health Score** via `scripts/page_score.py` — every L1 check on one URL, aggregated 0-100 with prioritized findings\n- **HTML visual report** via `scripts/render_html_report.py` — styled standalone HTML for stakeholder sharing\n- **Static dashboard** via `scripts/build_dashboard.py` + `tools/serve_dashboard.sh` — multi-domain overview with trend sparklines, runs history, drillable run-detail pages. No backend, no daemon, no cloud — opens locally or deploys to any static host.\n- **Audit history** via `scripts/audit_history.py` — SQLite store, score trends, diff between runs\n- **CMS / framework detection** — 24+ platforms (WordPress, Shopify, Webflow, Wix, Squarespace, Ghost, Drupal, Magento, HubSpot, BigCommerce, Next.js, Nuxt, Gatsby, Hugo, Astro, ...) with tailored SEO tips per platform\n- **JS rendering diff** — server-side HTML vs Playwright-rendered HTML structural comparison (canonical/robots/title/meta/schema deltas). Critical for SPA SEO\n- **Server log analysis** — Apache/Nginx logs (incl `.gz`): bot breakdown, crawl waste, error spikes, sitemap orphans/cold pages\n- **Real Core Web Vitals** via PageSpeed Insights API (CrUX field LCP/INP/CLS/FCP/TTFB at 75th-pct + Lighthouse lab)\n- **Security headers** — HSTS, CSP (with nonce/hash detection), X-Frame-Options, X-Content-Type-Options, Referrer-Policy, Permissions-Policy, mixed-content scan\n- **Schema.org validation** — required AND recommended fields per item, per-item 0-100 completeness, list of missing field names\n- **Broken-link checker** — every `\u003ca\u003e`, `\u003clink\u003e`, `\u003cscript\u003e`, `\u003cimg\u003e`, `\u003csource\u003e`, `\u003ciframe\u003e`, CSS bg; splits 4xx vs 5xx vs auth-gated 401/403\n- **Image audit** — alt coverage, format mix (WebP/AVIF vs ≥70% target), width/height for CLS, lazy on below-fold, size flags\n- **Content quality** — Flesch reading ease, sentence/paragraph length, keyword stuffing detection, AI-generation marker phrases, 134-200 word citable-passage extraction for AI Overviews, author byline + dates\n- **Local SEO** — NAP discoverability, LocalBusiness schema fields, Google Maps embed, GBP / Yelp / BBB citations, NAP consistency\n- **SerpAPI integration** (optional) — top-10 organic, SERP features, AI Overview citation check\n- **Hreflang / international SEO** — BCP-47, x-default, self-reference, parallel reciprocity validation\n- **Internal link graph analysis** — true-orphan detection, hub mapping, dead-end pages\n- **Sitemap validator** — XML validity, sitemap-index recursion, 50k URL / 50 MiB limits, HTTPS-only, lastmod sanity, deprecated tags, sample HTTP-200, robots cross-check\n- **Robots.txt + AI crawlers** — per-bot Allow/Disallow for 20 crawlers (GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-User, PerplexityBot, Google-Extended, meta-externalagent, Bytespider, etc.)\n- **Redirect chains** — per-hop trace, HTTP→HTTPS upgrade, 301/302 mix, loop detection, canonical alignment\n\n### AI search optimization (the new layer)\n- **AI Visibility Score** via `scripts/ai_visibility_score.py` — composite 0-100 across 6 components (AI crawler accessibility, SSR completeness, schema, llms.txt, hreflang, live Gemini citations)\n- **AEO — Answer Engine Optimization.** Live citation testing: query 5 LLM\n  surfaces (ChatGPT, Claude, Perplexity, Grok, **and Gemini with Google\n  Search grounding** — the closest publicly-available proxy for Google AI\n  Overviews / AI Mode) for your target queries and report which providers\n  cite your domain.\n- **GEO — Generative Engine Optimization.** Optimize for Google AI Overviews,\n  ChatGPT search, Perplexity search, and other generative answer engines.\n- **`llms.txt` validation** — checks existence, structure, AEO-language\n  signals, recommended sections.\n- **AI bot accessibility** — verifies `GPTBot`, `ClaudeBot`, `PerplexityBot`,\n  `Google-Extended`, `Apple-Extended` access in `robots.txt`.\n\n### Content quality (E-E-A-T)\n- **E-E-A-T framework** per the September 2025 Quality Rater Guidelines update\n- Author bylines, content dates, citations to authoritative sources\n- Reading level, word count, keyword stuffing, link density, text-to-HTML ratio\n- Industry-specific quality gates (SaaS, e-commerce, local, publisher, agency)\n\n### Growth (not just audit)\n- **Competitor keyword gap analysis** via the backlink/keyword data layer\n- **Top competitor pages by organic traffic** to identify content types you're\n  missing (comparison pages, alternatives pages, listicles, glossary)\n- **Opportunity scoring by impact ÷ effort** with KD (keyword difficulty)\n  filters\n- **Programmatic SEO planning** with thin-content safeguards\n\n## Why use this skill\n\n| | Standard SEO tools | Amazing SEO Skill |\n|---|---|---|\n| Findings per audit | 5–20 high-level | 50+ specific, actionable |\n| Real Core Web Vitals | Often missing | ✓ Playwright in-browser |\n| Schema recommended fields | \"X missing\" | Names every missing field |\n| Live LLM citation testing | ✗ | ✓ ChatGPT + Perplexity + Claude + Grok |\n| Internal link graph | ✗ | ✓ true-orphan detection |\n| Multi-page audit | Premium tier | ✓ free, scriptable |\n| Industry templates | Generic | 6 templates: SaaS, e-com, local, publisher, agency, generic |\n| Output format | Dashboard | Structured Markdown + JSON for piping |\n| Run as Claude Code skill | ✗ | ✓ |\n| Cost | $99–$999/mo | Free + your own API keys |\n\n## Architecture — 4-layer data model\n\n| Layer | Source | Purpose |\n|-------|--------|---------|\n| L0 | Claude reasoning + WebFetch | Analysis, prioritization, recommendations |\n| L1 | Python scripts (~29 deterministic checkers) | Reproducible verdicts on robots, sitemap, redirects, security headers, broken links, images, hreflang, schema, llms.txt, internal links, CWV, CMS detection, JS rendering, content quality, local SEO, log analysis, AI visibility |\n| L2 | Local CLI engines (configurable) | Real-browser CWV, 251-rule deep audit, live AEO citations |\n| L3 | External APIs (Ahrefs, GSC) | Backlink data, real keyword performance |\n| L4 | Multi-LLM ensemble (Anthropic, OpenAI, Perplexity, xAI, Google Gemini-with-Search) | Live AEO citation testing across all major AI surfaces |\n\nEach finding carries a confidence label: **Confirmed** (data-backed),\n**Likely** (data + reasoning), **Hypothesis** (reasoning fallback).\n\n## Installation\n\n### Lightweight mode (reasoning only — works on any Claude Code install)\n\n```bash\ngit clone https://github.com/metawhisp/amazing-seo-skill.git \\\n  ~/.claude/skills/amazing-seo-skill\n```\n\nThen in Claude Code, just say `сделай SEO аудит example.com` or\n`audit https://example.com` and the skill activates via its trigger keywords.\n\n### Check what's active\n\nAfter install, run the onboarding wizard — it probes prereqs, API keys,\nand runs live smoke tests, then reports which layers (L0-L4) you have:\n\n```bash\ncd ~/.claude/skills/amazing-seo-skill\n./tools/onboarding.sh\n```\n\nSee [ONBOARDING.md](ONBOARDING.md) for the full reference: what each layer\nunlocks, how to add API keys, troubleshooting.\n\n### Full mode (all 4 layers, real CWV + live AEO)\n\n```bash\ngit clone https://github.com/metawhisp/amazing-seo-skill.git \\\n  ~/.claude/skills/amazing-seo-skill\ncd ~/.claude/skills/amazing-seo-skill\n\n# Set engine package identifiers (your choice — installer is engine-agnostic)\nDEEP_AUDIT_ENGINE_PKG=\"\u003cnpm-pkg-for-deep-audit\u003e\" \\\nDEEP_AUDIT_ENGINE_BIN_NAME=\"\u003cbin-name\u003e\" \\\nAEO_CITATIONS_ENGINE_PKG_SPEC=\"\u003cpip-spec-for-aeo\u003e\" \\\nAEO_CITATIONS_ENGINE_BIN_NAME=\"\u003cbin-name\u003e\" \\\nAEO_CITATIONS_ENGINE_CONFIG_FILENAME=\"\u003cconfig-filename\u003e\" \\\n./install.sh\n```\n\nFor live AEO citation testing across 5 LLM surfaces, store API keys in\nmacOS Keychain:\n\n```bash\nsecurity add-generic-password -s anthropic-api-key      -a $USER -w\nsecurity add-generic-password -s openai-api-key         -a $USER -w\nsecurity add-generic-password -s perplexity-api-key     -a $USER -w\nsecurity add-generic-password -s x.ai-api-key           -a $USER -w\nsecurity add-generic-password -s google-gemini-api-key  -a $USER -w  # Gemini + Google Search grounding (AI Overviews proxy)\n```\n\nFor real Core Web Vitals via PageSpeed Insights API (improves rate limit\nfrom ~25/day keyless to ~25,000/day), also add:\n\n```bash\nsecurity add-generic-password -s google-psi-api-key     -a $USER -w\n```\n\n## Usage\n\nJust describe what you want. Claude picks up the skill automatically via\ntrigger keywords:\n\n```\naudit https://example.com                        — full site audit\npage https://example.com/blog/post               — single-page deep analysis\ntechnical https://example.com                    — technical SEO only\nschema https://example.com                       — Schema.org validation\ngeo https://example.com                          — AI Overviews readiness\naeo https://example.com \"best email tool\"        — live LLM citation check\nhreflang https://example.com                     — i18n / hreflang validation\ngrowth https://example.com                       — competitor gap + opportunities\nplan saas                                        — strategic planning\ncompetitor-pages generate                        — comparison page templates\n```\n\nOutput: **SEO Health Score (0–100)** + prioritized action plan\n(Critical / High / Medium / Low) with confidence labels.\n\n## Use cases\n\n- **Pre-launch audit** before shipping a new site or major redesign\n- **Quarterly SEO review** with month-over-month tracking\n- **AI search visibility audit** — find out if your domain is actually cited\n  by ChatGPT / Perplexity / Claude / Grok\n- **Competitor research** for content strategy\n- **Schema markup migration** when moving CMS or redesigning templates\n- **International SEO** before launching new locale versions\n- **Programmatic SEO planning** — quality gates prevent thin-content traps\n\n## Industry templates\n\nBuilt-in playbooks for 6 business types under `industry/`:\n\n- **SaaS** — pricing, features, integrations, free trial signals\n- **E-commerce** — product schema, faceted nav, OOS handling\n- **Local service** — NAP, LocalBusiness schema, service-area pages\n- **Publisher** — Article schema, author E-E-A-T, content velocity\n- **Agency** — case studies, portfolio, industry pages\n- **Generic** — fallback for hybrid models\n\nThe orchestrator auto-detects business type from homepage signals and applies\nthe right template.\n\n## Trigger keywords\n\nThe skill activates automatically when any of these appear in your prompt:\n`SEO`, `audit`, `schema`, `structured data`, `JSON-LD`, `Core Web Vitals`,\n`INP`, `LCP`, `CLS`, `sitemap`, `E-E-A-T`, `AI Overviews`, `GEO`, `AEO`,\n`technical SEO`, `content quality`, `page speed`, `hreflang`, `programmatic\nSEO`, `competitor pages`, `growth opportunities`, `keyword gap`,\n`llms.txt`, `AI search`, `LLM citations`.\n\n## Repository layout\n\n```\namazing-seo-skill/\n├── SKILL.md            # entry-point orchestrator (auto-loaded by Claude)\n├── README.md           # this file\n├── install.sh          # full-mode installer (engine-agnostic)\n├── skills/             # 13 sub-skill modules — each works standalone too\n├── agents/             # parallel sub-agents (growth-finder)\n├── scripts/            # Python deterministic checkers\n├── tools/              # user-facing wrappers (cwv-checker, aeo-citations, ...)\n├── .bin/               # internal engine wrappers (env-driven, brand-neutral)\n├── integrations/       # Ahrefs, GSC integration guides\n├── references/         # CWV thresholds, E-E-A-T, quality gates, schema types\n├── industry/           # 6 industry templates\n├── schema/             # JSON-LD templates\n├── hooks/              # optional pre-commit SEO validation\n└── docs/               # reference docs\n```\n\n## Status\n\nActive development. v0.7 series — 29 deterministic checkers + 6 orchestrator\ntools, all verified end-to-end on production sites. See [releases](https://github.com/metawhisp/amazing-seo-skill/releases) for changelog.\n\n## Contributing\n\nIssues and pull requests welcome. The skill is intentionally **engine-\nagnostic**: deep-audit and AEO-citations engines are configured per-environment,\nso you can swap implementations without forking.\n\n## License\n\nApache License 2.0 — see [LICENSE](LICENSE).\n\n## Tags\n\n`seo` `seo-audit` `ai-seo` `aeo` `geo` `claude-code` `claude-skill`\n`anthropic` `llm` `structured-data` `schema-markup` `schema-org`\n`core-web-vitals` `ai-overviews` `chatgpt-seo` `perplexity-seo`\n`generative-engine-optimization` `answer-engine-optimization`\n`technical-seo` `hreflang`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetawhisp%2Famazing-seo-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmetawhisp%2Famazing-seo-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetawhisp%2Famazing-seo-skill/lists"}