aeoptimize

CLI toolkit + Claude Code skills that transform SEO-optimized websites into AI-search-ready content.

Why AEO?

	SEO	AEO
Goal	Rank higher	Get cited
Audience	Search crawler	Language model
Key metric	Position	Citation accuracy
Content style	Keyword-rich	Self-contained, structured
Structured data	Nice to have	Essential

67% of users now get their first answer from AI. If your content can't be extracted and cited, it's invisible.

AI search engines (ChatGPT, Perplexity, Google AI Overview) don't rank pages — they cite content. aeoptimize helps you make your content citable.

Quick Start

npx aeoptimize scan your-site.com

AEO Readability Report
Score: 61/100  AI Readability: Good

  Structure        ██████████████░░░░░░ 18/25
  Citability       ████████████░░░░░░░░ 16/25
  Schema           ███████░░░░░░░░░░░░░  7/20
  AI Metadata      ███████░░░░░░░░░░░░░  8/15
  Content Density  ███████████████░░░░░ 12/15

Top Suggestions:
  → Add FAQ section with question-format headings
  → Add AI-relevant schema types
  → Create and link an llms.txt file

Features

Scan — AI Readability Audit

17 rules across 5 dimensions, 0-100 score. Zero cost, offline capable, deterministic.

npx aeoptimize scan https://example.com          # Remote URL
npx aeoptimize scan ./dist --dir                   # Local directory
npx aeoptimize scan ./dist --dir --json            # Machine-readable

Dimension	Max	What it measures
Structure	25	Heading hierarchy, paragraph length, FAQ presence
Citability	25	Self-contained statements, data/stats, definitions
Schema	20	JSON-LD presence, completeness, AI-relevant types
AI Metadata	15	llms.txt, robots.txt AI config, meta description
Content Density	15	Content vs boilerplate, keyword stuffing detection

Multi-AI Scoring

Score with multiple AI engines simultaneously. Detects gemini and copilot CLIs, dispatches parallel scoring, merges with rule engine.

npx aeoptimize scan https://example.com --multi-ai

Score: 72/100 (Rule Engine: 61 | AI Consensus: 83)

  Rule Engine      ████████████░░░░░░░░ 61/100
  Claude           ████████████████░░░░ 85/100
  Gemini           ████████████████░░░░ 81/100

AI Insights:
  Claude:  "FAQ section lacks schema markup"
  Gemini:  "Missing llms.txt reduces discoverability"

Scenario	Weighting
Rule engine + 2+ AIs	50% rules + 50% AI average
Rule engine + 1 AI	60% rules + 40% AI
Rule engine only	100% rules

Generate — AI Infrastructure Files

npx aeoptimize generate ./dist --dry-run           # Preview
npx aeoptimize generate ./dist                    # Write files

Generates:

• llms.txt — Machine-readable site summary (llmstxt.org standard)
• llms-full.txt — Full content for deep AI consumption
• JSON-LD schemas — Article, FAQPage, BreadcrumbList
• robots.txt suggestions — AI crawler allow/deny rules

Transform — AI Content Restructuring (Claude Code Skill)

Uses your existing Claude subscription — zero extra cost:

• Split long paragraphs into citable statements
• Extract implicit Q&A into FAQ schema
• Remove keyword stuffing
• Fix dangling references ("This...", "It...", "They...")
• Inject structured data

Framework Plugins

Vite

// vite.config.ts
import { aeoPlugin } from 'aeoptimize/vite';

export default defineConfig({
  plugins: [aeoPlugin()]
});

Next.js

// next.config.mjs
import { withAeo } from 'aeoptimize/next';

export default withAeo({});

Build 時自動生成 llms.txt、llms-full.txt、_aeo/generated-schemas.json 並印出 AEO 分數。

Options: { silent?: boolean; outDir?: string }

Guardrails

Pre-commit Hook

npx aeoptimize hook install                # Default: min score 60
npx aeoptimize hook install --min-score 80 # Custom threshold
npx aeoptimize hook uninstall              # Remove hook

Automatically checks AEO score of staged .html and .md files before each commit. Blocks commit if any file scores below the threshold.

Works with husky too — add to your .husky/pre-commit:

npx aeoptimize scan ./dist --dir --json | node -e "const j=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')); if(j.overall.total<60){console.error('AEO score too low:',j.overall.total);process.exit(1)}"

GitHub Action

# .github/workflows/aeo.yml
name: AEO Check
on: [pull_request]
jobs:
  aeo:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dexuwang627-cloud/aeoptimize/action@v0.5.3
        with:
          path: dist
          min-score: 60

Claude Code Skills

claude plugin marketplace add dexuwang627-cloud/aeoptimize

• /aeo-scan — Interactive audit with multi-AI scoring
• /aeo-generate — Guided file generation with preview
• /aeo-transform — AI-powered content restructuring

Help

npx aeoptimize --help            # All commands
npx aeoptimize scan --help       # Scan options
npx aeoptimize generate --help   # Generate options

Contributing

Contributions are welcome! Feel free to open issues or pull requests.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing)
3. Run tests (npm test)
4. Commit your changes
5. Open a Pull Request

License

MIT