AI SEO — AEO/GEO Optimization Plugin

Make websites discoverable and citable by AI search engines (ChatGPT, Claude, Perplexity, Google AI Overview).

Unlike traditional SEO (ranking in search results), AI SEO ensures AI systems recommend, cite, and accurately represent your content when answering user questions.

The Problem

Traditional SEO:  "best coffee shop tokyo" → Google shows 10 links → user clicks one
AI Search:        "best coffee shop tokyo" → ChatGPT gives ONE answer → cites 0-3 sources

Your site ranks #1 on Google but ChatGPT doesn't mention it. Why? AI engines need different signals: structured data, llms.txt, direct answers, not just keywords and backlinks.

The Solution

┌──────────────┐     ┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  Run audit   │ --> │  Score 5/8   │ --> │  Fix issues  │ --> │  Score 8/8   │
│  First time  │     │  + .ai-seo/  │     │  with hints  │     │  + delta +2  │
└──────────────┘     └──────────────┘     └──────────────┘     └──────────────┘
         │                   │                                        │
         └── config.json ────┘── history.json ────────────────────────┘
             (framework,          (score tracking,
              search paths)        issue diff)

Key Features

Feature	Description
4-Layer Audit	Technical, Content, Authority, Agentic scoring
Framework Detection	Auto-detects Vite, Next.js, Nuxt, Gatsby, static sites
Auto-Check Hook	Monitors robots.txt, llms.txt, HTML edits in real-time
Progress Tracking	`.ai-seo/history.json` — score delta across runs
Framework-Aware Hints	"Your Vite project should include a Sitemap directive..."
Zero Dependencies	Pure bash, runs anywhere with a shell

Installation

# From marketplace
/plugin install ai-seo@JHyeok5

# Or clone directly
git clone https://github.com/JHyeok5/claude-plugin-ai-seo.git
claude --plugin-dir ./claude-plugin-ai-seo

Note: Restart Claude Code after installation to activate hooks.

Usage

/ai-seo:ai-seo

Or just describe what you need — auto-triggers on AEO/GEO related tasks:

"Check if my site shows up in ChatGPT"
"Optimize my site for AI search engines"
"Add llms.txt to my project"
"Audit my site's AI discoverability"

Standalone Script

bash scripts/check-ai-readiness.sh /path/to/project

How It Works

[First Run]
  1. Detect framework (Vite/Next/Nuxt/Gatsby/static)
  2. Scan for robots.txt, llms.txt, sitemap, JSON-LD, meta tags
  3. Score 8 checks → create .ai-seo/config.json + history.json
  4. Output actionable report with framework-specific hints

[Subsequent Runs]
  1. Read .ai-seo/config.json → use saved searchPaths
  2. Run same 8 checks
  3. Compare with history → show delta (fixed/new issues)
  4. Update config + append history

[Hooks (automatic)]
  Edit robots.txt → warn if AI crawlers blocked
  Edit llms.txt   → warn if structure incomplete
  Edit .tsx/.html  → detect JSON-LD/SEO component patterns

4-Layer Framework

Layer	Focus	Example
1. Technical	AI can access the site	robots.txt, llms.txt, sitemap, JSON-LD
2. Content	AI understands the content	Q&A format, statistics, modularity
3. Authority	AI trusts the site	Reviews, citations, expert content
4. Agentic	AI uses the site as a tool	Public API, MCP server

Auto-Check Hook

When installed, the plugin automatically monitors edits to AI-relevant files:

File	What It Checks
`robots.txt`	Warns if AI crawlers (GPTBot, ClaudeBot) are blocked
`llms.txt`	Warns if missing required structure (`# heading`, `> description`)
`*.tsx/.jsx/.vue`	Detects JSON-LD, `<Helmet>`, `<Head>` patterns

Warnings are framework-aware — "Your Vite project should..." vs "Your Next.js project should...".

Self-Improvement

The plugin creates .ai-seo/ in your project on first run:

.ai-seo/
├── config.json    ← framework, search paths, asset flags
└── history.json   ← score + issues per run, delta tracking

Each subsequent run compares with previous scores and shows what changed.

Script Output Example

First run:

# AI SEO Readiness Check

**Project**: /home/user/my-site
**Date**: 2026-03-12T10:30:00Z
**Framework**: vite

ai-seo

Popularity

What's Inside

README

AI SEO — AEO/GEO Optimization Plugin

The Problem

The Solution

Key Features

Installation

Usage

Standalone Script

How It Works

4-Layer Framework

Auto-Check Hook

Self-Improvement

Script Output Example

Confidence

Similar Plugins

claude-rank

akii-seo-ai-search-optimizer

ultimate-seo-geo

seo-dungeon

claude-seo

bencium-aeo

More by jhyeok5

netlify-functions

i18n-audit