Gemini SEO is a terminal-native SEO workflow suite for audits, technical diagnostics, content quality, schema, AI search readiness, local search, backlinks, international SEO, e-commerce SEO, and client-ready reporting.
Version 1.9.9 ships 25 sub-skills, 18 companion specialist notes, 30 Python execution scripts, schema templates, optional data extensions, and manifest consistency tests.
Independent community project. Not affiliated with or endorsed by Google. Adapted from AgriciDaniel/claude-seo, with upstream attribution retained in CONTRIBUTORS.md.
- What It Does
- Quick Start
- Commands
- Example Workflows
- Architecture
- Requirements
- Configuration
- Documentation
- Release Notes
- Frequently Asked Questions
- Contributing
- License
- Technical SEO: crawlability, indexability, security headers, redirects, canonicals, Core Web Vitals, and mobile checks.
- Content quality: E-E-A-T, topical depth, author signals, readability, thin content, and AI citation readiness.
- Structured data: JSON-LD detection, validation, schema generation, rich-result deprecation awareness, and video/live schema.
- GEO and AI search: crawler access,
llms.txt, passage citability, brand mentions, and answer-engine readiness. - Local and maps: GBP signals, NAP consistency, reviews, citations, geo-grid intelligence, and local schema.
- Backlinks: Moz, Bing Webmaster Tools, Common Crawl graph checks, backlink verification, and optional DataForSEO data.
- Strategy: roadmaps, content calendars, semantic clusters, competitor comparison pages, programmatic SEO, SXO, and drift monitoring.
- Reporting: Markdown, HTML, PDF, charts, Google SEO reports, and reusable schema/report templates.
Clone and run the installer:
git clone --depth 1 https://github.com/avalonreset/gemini-seo.git
bash gemini-seo/install.shWindows:
git clone --depth 1 https://github.com/avalonreset/gemini-seo.git
powershell -ExecutionPolicy Bypass -File gemini-seo\install.ps1The installer copies the skill tree, sub-skills, helper scripts, schema templates, optional extensions,
and companion specialist notes into user-level skill directories. It pins to the current release tag by
default; override with GEMINI_SEO_TAG=main when you intentionally want the branch tip.
For a packaged Gemini CLI install, download gemini-seo.skill from the release assets and install it
with:
gemini skills install path/to/gemini-seo.skill --scope user| Command | Description |
|---|---|
/seo audit <url> |
Full website audit with parallel specialist analysis |
/seo page <url> |
Deep single-page SEO analysis |
/seo technical <url> |
Crawlability, indexability, security, and Core Web Vitals |
/seo content <url> |
E-E-A-T, readability, depth, and AI citation readiness |
/seo content-brief <topic> |
SEO content brief with target keywords and outline |
/seo schema <url> |
Schema.org detection, validation, and JSON-LD generation |
/seo sitemap <url> |
XML sitemap audit or generation |
/seo images <url> |
Image SEO, lazy loading, formats, alt text, and SERP readiness |
/seo geo <url> |
AI search readiness for AI Overviews, ChatGPT, Perplexity, and similar surfaces |
/seo plan <type> |
Strategic roadmap by business model |
/seo programmatic [url|plan] |
Scaled-page strategy and thin-content controls |
/seo competitor-pages [url|generate] |
Comparison, alternatives, and roundup page strategy |
/seo local <url> |
Local SEO, NAP, citations, reviews, GBP, and local schema |
/seo maps [command] |
Maps intelligence, geo-grid checks, GBP audit, and competitor radius mapping |
/seo hreflang <url> |
International SEO, hreflang graph checks, and cultural profiles |
/seo google [command] [url] |
Search Console, PageSpeed, CrUX, GA4, Indexing API, and reports |
/seo backlinks <url> |
Backlink profile analysis with free and optional paid sources |
/seo cluster <seed-keyword> |
SERP-overlap semantic clustering and content architecture |
/seo sxo <url> |
Search Experience Optimization, intent fit, personas, and page type |
/seo drift baseline <url> |
Capture a change-monitoring baseline |
/seo drift compare <url> |
Compare current SEO state against a saved baseline |
/seo ecommerce <url> |
Product schema, category pages, marketplace intelligence, and feeds |
/seo flow [stage] [url|topic] |
FLOW framework prompts for Find, Leverage, Optimize, Win, and Local |
/seo dataforseo [command] |
Optional DataForSEO live data extension |
/seo firecrawl [command] <url> |
Optional Firecrawl full-site crawl extension |
/seo image-gen [use-case] <description> |
Optional SEO image planning and generation extension |
Run a full audit:
/seo audit https://example.com
Check AI search readiness for a single page:
/seo geo https://example.com/blog/guide
Generate a Google SEO report when credentials are configured:
/seo google report https://example.com
gemini-seo/
├── SKILL.md # Root skill entrypoint
├── skills/
│ ├── seo/ # Main orchestrator and shared references
│ └── seo-*/ # Specialized sub-skills
├── agents/ # Companion specialist instructions
├── scripts/ # Python execution helpers
├── schema/ # JSON-LD templates
├── extensions/ # Optional DataForSEO, Firecrawl, and image workflows
├── tests/ # Manifest, sync, and parser tests
└── docs/ # Installation, commands, architecture, troubleshooting
The orchestrator uses progressive disclosure: read skills/seo/SKILL.md first, then load only the
sub-skill and reference files needed for the task.
- Python 3.10+
- Git
- Optional: Playwright Chromium for screenshot and visual analysis
- Optional API credentials for Google APIs, DataForSEO, Firecrawl, Moz, Bing Webmaster Tools, and image generation workflows
Gemini SEO keeps local credentials out of the repository. Provider credentials and API keys should live in environment variables or user-level config files, depending on the workflow. See MCP Integration for external data sources and Troubleshooting for dependency checks.
v1.9.9 brings the project up to the upstream 1.x feature surface: the multi-skill layout, 18 companion specialist notes, optional extensions, Google and backlink APIs, drift monitoring, FLOW integration, manifest consistency tests, lazy-load detection fixes, and dependency floor updates.
Gemini SEO is a terminal-native SEO workflow suite that turns common audit, research, schema,
performance, local, backlink, and reporting tasks into reusable /seo commands.
No. Full audits are one workflow, but the individual commands can target a page, sitemap, schema block, content brief, backlink profile, local search footprint, or drift baseline.
No for the baseline workflows. API keys unlock richer live data from sources such as Google APIs, DataForSEO, Firecrawl, Moz, Bing Webmaster Tools, and image generation services.
Most workflows write Markdown, HTML, PDF, chart, or JSON outputs into the current working directory or the workflow-specific output path described by the command.
See CONTRIBUTING.md for contribution guidelines, local setup notes, and review expectations. Public releases retain upstream attribution in CONTRIBUTORS.md.
MIT. See LICENSE.
Upstream project and original concept: AgriciDaniel/claude-seo.