GEO-first SEO analysis tool. Optimizes websites for AI-powered search engines (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) while maintaining traditional SEO foundations. Performs full GEO audits, citability scoring, AI crawler analysis, llms.txt generation, brand mention scanning, platform-specific optimization, schema markup, technical SEO, content quality (E-E-A-T), and client-ready GEO report generation. Use when user says "geo", "seo", "audit", "AI search", "AI visibility", "optimize", "citability", "llms.txt", "schema", "brand mentions", "GEO report", or any URL for analysis.
インストールする前に、エージェントに与えられる指示の中身を確認できます。
Philosophy: GEO-first, SEO-supported. AI search is eating traditional search. This tool optimizes for where traffic is going, not where it was.
| Invocation | What It Does |
|---|---|
$geo-setup | Initialize plugin/classic runtime dependencies |
$geo-audit <url> | Full GEO + SEO audit with parallel agents first; skills fallback |
$geo page <url> | Deep single-page GEO analysis (listed for orchestrator routing; no dedicated sub-skill yet) |
$geo-citability <url> | Score content for AI citation readiness |
$geo-crawlers <url> | Check AI crawler access (robots.txt analysis) |
$geo-llmstxt <url> | Analyze or generate llms.txt file |
$geo-brand-mentions <url> | Scan brand mentions across AI-cited platforms |
$geo-platform-optimizer <url> | Platform-specific optimization (ChatGPT, Perplexity, Google AIO) |
$geo-schema <url> | Detect, validate, and generate structured data |
$geo-technical <url> | Traditional technical SEO audit |
$geo-content <url> | Content quality and E-E-A-T assessment |
$geo-report <url> | Generate client-ready GEO deliverable |
$geo-report-pdf <url> | Generate professional PDF report with charts and scores |
$geo quick <url> | 60-second GEO visibility snapshot |
$geo-prospect <cmd> | CRM-lite: manage prospects through the sales pipeline |
$geo-proposal <domain> | Auto-generate client proposal from audit data |
$geo-compare <domain> | Monthly delta report: show score improvements to client |
$geo-update | Pull latest GEO skill updates from upstream |
| Metric | Value | Source |
|---|---|---|
| GEO services market (2025) | $850M-$886M | Yahoo Finance / Superlines |
| Projected GEO market (2031) | $7.3B (34% CAGR) | Industry analysts |
| AI-referred sessions growth | +527% (Jan-May 2025) | SparkToro |
| AI traffic conversion vs organic | 4.4x higher | Industry data |
| Google AI Overviews reach | 1.5B users/month, 200+ countries | |
| ChatGPT weekly active users | 900M+ | OpenAI |
| Perplexity monthly queries | 500M+ | Perplexity |
| Gartner: search traffic drop by 2028 | -50% | Gartner |
| Marketers investing in GEO | Only 23% | Industry surveys |
| Brand mentions vs backlinks for AI | 3x stronger correlation | Ahrefs (Dec 2025) |
$geo-audit <url>)Phase 1: Discovery (Sequential)
Phase 2: Parallel Agents First, Skills Fallback
Run these 5 analysis tracks. Prefer launching the matching TOML agents in parallel when they are available under ~/.codex/agents/ or the active Codex environment. If an agent is missing or unavailable, execute only that track directly through the listed skills and rubrics. The scoring formula, findings structure, and output contract are identical in both modes.
| Track | Preferred Agent | Fallback Skills / Responsibility |
|---|---|---|
| AI Visibility | agents/geo-ai-visibility.toml | geo-citability, geo-crawlers, geo-llmstxt, geo-brand-mentions |
| Platform Analysis | agents/geo-platform-analysis.toml | geo-platform-optimizer for ChatGPT, Perplexity, Google AIO, Gemini, Bing Copilot |
| Technical GEO | agents/geo-technical.toml | geo-technical for Core Web Vitals, crawlability, indexability, rendering |
| Content Quality | agents/geo-content.toml | geo-content for E-E-A-T, readability, source quality, freshness |
| Structured Data | agents/geo-schema.toml | geo-schema for schema detection, validation, and generation |
Phase 3: Synthesis (Sequential)
| Category | Weight | Measured By |
|---|---|---|
| AI Citability & Visibility | 25% | Passage scoring, answer block quality, AI crawler access |
| Brand Authority Signals | 20% | Mentions on Reddit, YouTube, Wikipedia, LinkedIn; entity presence |
| Content Quality & E-E-A-T | 20% | Expertise signals, original data, author credentials |
| Technical Foundations | 15% | SSR, Core Web Vitals, crawlability, mobile, security |
| Structured Data | 10% | Schema completeness, JSON-LD validation, rich result eligibility |
| Platform Optimization | 10% | Platform-specific readiness (Google AIO, ChatGPT, Perplexity) |
Analyze homepage for patterns:
| Type | Signals |
|---|---|
| SaaS | Pricing page, "Sign up", "Free trial", "/app", "/dashboard", API docs |
| Local Service | Phone number, address, "Near me", Google Maps embed, service area |
| E-commerce | Product pages, cart, "Add to cart", price elements, product schema |
| Publisher | Blog, articles, bylines, publication dates, article schema |
| Agency | Portfolio, case studies, "Our services", client logos, testimonials |
| Other | Default — apply general GEO best practices |
Adjust recommendations based on detected type. Local businesses need LocalBusiness schema and Google Business Profile optimization. SaaS needs SoftwareApplication schema and comparison page strategy. E-commerce needs Product schema and review aggregation.
When a workflow needs bundled scripts, schema templates, or report templates, resolve GEO_ROOT in this order:
CODEX_GEO_ROOT if set.skills/geo/SKILL.md plus sibling scripts/, schema/, and templates/.${CODEX_HOME:-$HOME/.codex}/skills/geo.Use $geo-setup when dependencies are missing. In plugin mode, the virtual environment can live under ${CODEX_HOME:-$HOME/.codex}/geo-seo-codex/.venv; in classic installer mode it remains under ~/.codex/skills/geo/.venv.
| # | Skill | Directory | Purpose |
|---|---|---|---|
| 1 | geo-audit | skills/geo-audit/ | Full audit orchestration and scoring |
| 2 | geo-citability | skills/geo-citability/ | Passage-level AI citation readiness |
| 3 | geo-crawlers | skills/geo-crawlers/ | AI crawler access and robots.txt |
| 4 | geo-llmstxt | skills/geo-llmstxt/ | llms.txt standard analysis and generation |
| 5 | geo-brand-mentions | skills/geo-brand-mentions/ | Brand presence on AI-cited platforms |
| 6 | geo-platform-optimizer | skills/geo-platform-optimizer/ | Platform-specific AI search optimization |
| 7 | geo-schema | skills/geo-schema/ | Structured data for AI discoverability |
| 8 | geo-technical | skills/geo-technical/ | Technical SEO foundations |
| 9 | geo-content | skills/geo-content/ | Content quality and E-E-A-T |
| 10 | geo-report | skills/geo-report/ | Client-ready deliverable generation |
| 11 | geo-prospect | skills/geo-prospect/ | CRM-lite prospect and client pipeline management |
| 12 | geo-proposal | skills/geo-proposal/ | Auto-generate client proposals from audit data |
| 13 | geo-compare | skills/geo-compare/ | Monthly delta tracking and progress reports |
| 14 | geo-update | skills/geo-update/ | Pull latest updates from upstream repository |
| 15 | geo-setup | skills/geo-setup/ | Initialize or repair plugin/classic runtime dependencies |
These agents are the preferred fast path for full audits. Do not require them for plugin-only use; fall back to the matching skills when agents are unavailable.
| Agent | File | Skills Used |
|---|---|---|
| geo-ai-visibility | agents/geo-ai-visibility.toml | geo-citability, geo-crawlers, geo-llmstxt, geo-brand-mentions |
| geo-platform-analysis | agents/geo-platform-analysis.toml | geo-platform-optimizer |
| geo-technical | agents/geo-technical.toml | geo-technical |
| geo-content | agents/geo-content.toml | geo-content |
| geo-schema | agents/geo-schema.toml | geo-schema |
All invocations generate structured output:
| Invocation | Output File |
|---|---|
$geo-audit | GEO-AUDIT-REPORT.md |
$geo page | GEO-PAGE-ANALYSIS.md |
$geo-citability | GEO-CITABILITY-SCORE.md |
$geo-crawlers | GEO-CRAWLER-ACCESS.md |
$geo-llmstxt | llms.txt (ready to deploy) |
$geo-brand-mentions | GEO-BRAND-MENTIONS.md |
$geo-platform-optimizer | GEO-PLATFORM-OPTIMIZATION.md |
$geo-schema | GEO-SCHEMA-REPORT.md + generated JSON-LD |
$geo-technical | GEO-TECHNICAL-AUDIT.md |
$geo-content | GEO-CONTENT-ANALYSIS.md |
$geo-report | GEO-CLIENT-REPORT.md (presentation-ready) |
$geo-report-pdf | GEO-REPORT.pdf (professional PDF with charts) |
$geo quick | Inline summary (no file) |
$geo-prospect | Updates ~/.geo-prospects/prospects.json |
$geo-proposal | ~/.geo-prospects/proposals/<domain>-proposal-<date>.md |
$geo-compare | ~/.geo-prospects/reports/<domain>-monthly-<YYYY-MM>.md |
The $geo-report-pdf <url> invocation converts GEO-AUDIT-REPORT.md into a styled, client-ready PDF.
No Python dependencies required for PDF generation.
XX/100 values are automatically colored green/blue/amber/orange/redBundled under ${GEO_ROOT}/templates/:
geo-report-style.css — stylesheet (edit colors, fonts, layout here)geo-report-template.html — pandoc HTML template (edit cover fields here)$geo-audit <url> to produce GEO-AUDIT-REPORT.md$geo-report-pdf — extracts metadata from the report and runs:
pandoc GEO-AUDIT-REPORT.md \
--to html5 --standalone --embed-resources \
--template "$GEO_ROOT/templates/geo-report-template.html" \
--css "$GEO_ROOT/templates/geo-report-style.css" \
--metadata brand_name="..." --metadata geo_score="..." \
-o GEO-REPORT.html
"$GEO_CHROME" \
--headless=new --disable-gpu --no-sandbox \
--print-to-pdf="$(pwd)/GEO-REPORT.pdf" \
--print-to-pdf-no-header --no-pdf-header-footer \
--virtual-time-budget=5000 \
"file://$(pwd)/GEO-REPORT.html"
GEO-REPORT.pdf in the current directory# Full GEO audit of a website
$geo-audit https://example.com
# Check if AI bots can see your site
$geo-crawlers https://example.com
# Score a specific page for AI citability
$geo-citability https://example.com/blog/best-article
# Generate an llms.txt file for your site
$geo-llmstxt https://example.com
# Get a 60-second visibility snapshot
$geo quick https://example.com
# Generate a client-ready report
$geo-report https://example.com
まだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
Full website GEO+SEO audit with parallel agents first and skills fallback. Orchestrates a comprehensive Generative Engine Optimization audit across AI citability, platform analysis, technical infrastructure, content quality, and schema markup. Produces a composite GEO Score (0-100) with prioritized action plan.
日本語の概要は準備中です。原文の説明を表示しています。
Brand mention and authority scanner for AI visibility. Analyzes brand presence across platforms that AI models rely on for entity recognition and citation decisions. Produces a Brand Authority Score (0-100) with platform-specific recommendations.
日本語の概要は準備中です。原文の説明を表示しています。
AI citability scoring and optimization. Analyzes web page content to determine how likely AI systems (ChatGPT, Claude, Perplexity, Gemini) are to cite or quote passages from the page. Provides a citability score (0-100) with specific rewrite suggestions.
日本語の概要は準備中です。原文の説明を表示しています。
Monthly delta tracking and progress reporting for GEO clients. Compares two GEO audits (baseline vs. current), calculates score improvements across all categories, tracks action item completion, and generates a "here's your progress" client report. Use when user says "compare", "delta", "monthly report", "progress", "confronta", "progressi", "report mensile", or when running a monthly client check-in.
日本語の概要は準備中です。原文の説明を表示しています。
Content quality and E-E-A-T assessment for AI citability — evaluate experience, expertise, authoritativeness, trustworthiness, and content structure
日本語の概要は準備中です。原文の説明を表示しています。
AI crawler access analysis. Checks robots.txt, meta tags, and HTTP headers to determine which AI crawlers can access the site. Provides a complete access map and recommendations for maximizing AI visibility while maintaining appropriate control.
日本語の概要は準備中です。原文の説明を表示しています。