Skip to content

avalonreset/gemini-seo

Gemini SEO, open source SEO tools for Gemini CLI with 14 professional analysis workflows

Gemini SEO: Open Source SEO Tools for Gemini CLI

CI Version License

Most open source SEO tools are web apps that require hosting, databases, and ongoing maintenance. Gemini SEO takes a different approach: 14 professional-grade SEO analysis workflows, 6 multi-agent runners, and client-ready reporting that run directly inside the Gemini CLI with zero infrastructure. Just install the skill and start auditing.

Independent community project, not affiliated with or endorsed by Google. Original project and concept: AgriciDaniel/claude-seo

Table of Contents

SEO Workflows and Commands

Gemini SEO provides 14 SEO audit and analysis workflows, all orchestrated through a single master skill file:

Workflow What It Does
seo-audit Full-site health check across all SEO dimensions
seo-page Deep single-page analysis (on-page, meta, content)
seo-technical Crawlability, indexability, Core Web Vitals, security
seo-content E-E-A-T evaluation, readability, content depth
seo-schema Schema.org detection, validation, and JSON-LD generation
seo-images Alt text, file sizes, formats, responsive attributes
seo-sitemap XML sitemap audit and generation
seo-geo AI search readiness (Google AI Overviews, ChatGPT, Perplexity)
seo-plan Strategic SEO planning and content roadmaps
seo-programmatic Scaled-page analysis for thin content and index bloat
seo-competitor-pages Comparison and alternatives page strategy
seo-hreflang International SEO and hreflang validation
seo-performance Core Web Vitals (LCP, INP, CLS) measurement
seo-visual Screenshot capture and visual diagnostics

How It Works

Single Master Orchestrator

SKILL.md acts as a compact router that delegates to the exact reference guide needed for each request. No wasted context, no loading unnecessary files.

Progressive Disclosure

Each request pulls only the relevant tactical file (for example references/seo-schema.md), keeping context usage minimal even across complex multi-step audits.

Built-In Premium Reporting

Every workflow can output polished client-ready deliverables using assets/report-template.html. Outputs can be packaged as both HTML and PDF reports.

Installation

Gemini SEO is packaged as a standard Gemini CLI Skill.

  1. Download the latest gemini-seo.skill file from the Releases page.
  2. Install it using the Gemini CLI:
    gemini skills install path/to/gemini-seo.skill --scope user
  3. Reload your active Gemini CLI session:
    /skills reload
  4. Verify the installation:
    /skills list
    You should see gemini-seo in the output with all 14 workflows available.

Quick Start

Use natural language prompts inside the Gemini CLI:

Run a full SEO audit for https://example.com

The audit workflow fetches the page, analyzes on-page elements, checks technical SEO signals, evaluates content quality against E-E-A-T criteria, and produces a scored report with prioritized action items.

More examples:

  • Analyze this page deeply: https://example.com/about
  • Validate hreflang for https://example.com
  • Generate a sitemap from this URL list

Append "premium report" or "client deliverable" to any request to generate polished HTML/PDF output.

Output Artifacts

Depending on the task, Gemini SEO can produce:

Output Description
FULL-AUDIT-REPORT.md Complete site audit with scores and action items
ACTION-PLAN.md Prioritized SEO improvement roadmap
CLIENT-SEO-AUDIT.html Branded HTML report for client delivery
CLIENT-SEO-AUDIT.pdf PDF version of the client report

Architecture

gemini-seo/
├── SKILL.md                    # Single Master Orchestrator (routing + delegation)
├── references/                 # 14 specialized tactical guides (loaded on demand)
├── scripts/                    # Python utilities (fetch, parse, screenshot, analyze)
└── assets/                     # Premium HTML reporting templates

Documentation

Attribution

FAQ

What does Gemini SEO do?

Gemini SEO is a collection of 14 SEO analysis workflows that run inside the Gemini CLI. It performs full-site audits, technical SEO checks, schema validation, content quality scoring, and AI search readiness analysis without requiring a web app or external service.

How is this different from other SEO tools?

Traditional SEO tools like Screaming Frog or Ahrefs run as standalone applications or cloud services. Gemini SEO runs directly in your terminal as a CLI skill, loading only the specific analysis needed for each request. No browser, no subscription, no infrastructure.

Does this work with Google AI Overviews and ChatGPT?

Yes. The seo-geo workflow specifically analyzes your site's readiness for AI-powered search, including Google AI Overviews, ChatGPT web search, and Perplexity. It checks AI crawler accessibility, passage-level citability, and structured data signals.

Community

Join AI Marketing Hub Pro for access to exclusive projects (referral link).

Other Projects

codex-seo - Same firepower, built for Codex CLI. 12 workflows, 6 parallel agents, client-ready HTML/PDF reports from your terminal.

wan2gp-operator - CLI operator for Wan2GP text-to-video. VRAM-aware compose, headless batch runs, and a music video pipeline.

BenjaminTerm - Hacker-styled WezTerm distribution for Windows. Smart clipboard, paste undo, 86 curated dark themes, borderless glass mode.

License

MIT License. See LICENSE.

About

Open source SEO tools for Gemini CLI. 14 professional analysis workflows covering audits, technical SEO, schema markup, Core Web Vitals, E-E-A-T, and AI search readiness.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors