https://github.com/dexuwang627-cloud/aeoptimize
CLI toolkit + Claude Code skills that transform SEO-optimized websites into AI-search-ready content
https://github.com/dexuwang627-cloud/aeoptimize
aeo ai-search ai-seo answer-engine-optimization claude-code-skill generative-engine-optimization json-ld llms-txt seo structured-data
Last synced: 20 days ago
JSON representation
CLI toolkit + Claude Code skills that transform SEO-optimized websites into AI-search-ready content
- Host: GitHub
- URL: https://github.com/dexuwang627-cloud/aeoptimize
- Owner: dexuwang627-cloud
- Created: 2026-04-07T06:28:03.000Z (20 days ago)
- Default Branch: main
- Last Pushed: 2026-04-07T08:10:05.000Z (20 days ago)
- Last Synced: 2026-04-07T08:28:11.323Z (20 days ago)
- Topics: aeo, ai-search, ai-seo, answer-engine-optimization, claude-code-skill, generative-engine-optimization, json-ld, llms-txt, seo, structured-data
- Language: TypeScript
- Size: 46.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# aeoptimize
[](https://www.npmjs.com/package/aeoptimize)
[](https://github.com/dexuwang627-cloud/aeoptimize/blob/main/LICENSE)
**CLI toolkit + Claude Code skills that transform SEO-optimized websites into AI-search-ready content.**
AI search engines (ChatGPT, Perplexity, Google AI Overview) don't rank pages — they **cite** content. `aeoptimize` helps you make your content citable.
```bash
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.
```bash
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.
```bash
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
```bash
npx aeoptimize generate ./dist --dry-run # Preview
npx aeoptimize generate ./dist # Write files
```
Generates:
- **llms.txt** — Machine-readable site summary ([llmstxt.org](https://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
## Claude Code Skills
```bash
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
## 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.
## Help
```bash
npx aeoptimize --help # All commands
npx aeoptimize scan --help # Scan options
npx aeoptimize generate --help # Generate options
```
## License
MIT