# AEO Scanner
> Free website AI-friendliness scoring tool. AEO, GEO, AIEO — Answer Engine Optimization, Generative Engine Optimization, AI Engine Optimization. Scans 8 metrics and generates ready-to-use fix code snippets.
AEO Scanner is an open web analysis service for AEO, GEO, and AIEO. It helps website owners understand and improve their site's visibility to AI answer engines such as ChatGPT, Claude, and Perplexity.
## Platform Statistics
- 10,229 websites scanned and indexed
- 45,186 AI crawler visits tracked
- 14 distinct AI bots detected
- 3 languages supported (Chinese, English, Japanese)
## What It Does
Given any public URL, AEO Scanner fetches the page, parses its HTML, and scores it across 8 Answer Engine Optimization metrics. It then returns a weighted composite score (0–100) and auto-generates ready-to-paste fix code. No login required.
## Scoring Methodology
Weighted sum formula. Each metric is scored 0–100 and multiplied by its weight:
- JSON-LD schema (30%): presence and type of structured data markup
- llms.txt (20%): whether the site has a /llms.txt file
- Open Graph (15%): og:title, og:description, og:image
- Meta tags (10%): title tag, meta description, canonical URL
- FAQ schema (10%): schema.org/FAQPage structured data
- Social cards (5%): Twitter/X Card meta tags
- Contact info (5%): presence of address, phone, or email
- Image alt text (5%): ratio of images that have alt attributes
## How to Use the API (for AI agents)
Scan a website:
POST https://aeo.codecity.com.tw/api/scan
Body: { "url": "https://example.com" }
Returns: score (0-100), per-metric scores, fix code snippets (JSON-LD, OG tags, FAQ schema, llms.txt)
List scanned sites (leaderboard):
GET https://aeo.codecity.com.tw/api/sites?page=1&limit=20&sort=score
Get a single site's details:
GET https://aeo.codecity.com.tw/api/sites/{id}
Get global statistics:
GET https://aeo.codecity.com.tw/api/stats
Returns: total scans, total sites, average score, active AI crawlers
Get tool metadata (capabilities, scoring model, data freshness):
GET https://aeo.codecity.com.tw/api/meta
## Example Scan Response (abbreviated)
{
"id": 42,
"url": "https://example.com",
"score": 73.5,
"scores": { "meta": 90, "og": 80, "content": 70, "jsonLd": 60, "image": 75, "faq": 50, "contact": 80, "llmsTxt": 0, "social": 85 },
"snippets": { "jsonLd": "", "og": "", "llmsTxt": "# example.com\n..." }
}
## Limitations
- Only publicly accessible URLs can be scanned (no auth-protected pages)
- JavaScript-rendered content may not be fully analyzed (scraper uses static HTML)
- llms.txt detection is based on an HTTP request to the target site's /llms.txt path
- Scores reflect the page state at scan time; rescan to get updated results
## Data
- Scan results are stored persistently and used to build the leaderboard
- No user accounts — scans are anonymous
- Data freshness: each scan is real-time; historical scans are retained
## Full API Documentation
https://aeo.codecity.com.tw/openapi.json
## Plugin Manifest (for ChatGPT / AI agents)
https://aeo.codecity.com.tw/.well-known/ai-plugin.json
## AI-Readable Directory
https://aeo.codecity.com.tw/ai-directory
## AI Visitors — Live Crawler Tracking
https://aeo.codecity.com.tw/ai-visitors
See which AI bots (GPTBot, ClaudeBot, PerplexityBot, etc.) are actively visiting the AEO Scanner platform, their visit counts, and which sites they crawl most.
## RSS Feeds
Blog feed (new articles): https://aeo.codecity.com.tw/feed.xml
Recently scanned sites: https://aeo.codecity.com.tw/feed/sites.xml
## Blog — AEO / GEO / AIEO Tutorials
https://aeo.codecity.com.tw/blog (Chinese — 繁體中文)
https://aeo.codecity.com.tw/en/blog (English)
https://aeo.codecity.com.tw/ja/blog (Japanese — 日本語)
Covers topics: What is AEO, GEO guide, llms.txt standard, ChatGPT Search optimization, JSON-LD for AEO, Perplexity optimization, Google AI Overviews, FAQ Schema, Open Graph, Taiwan e-commerce AEO, AI content strategy, and more. Available in 3 languages.
## AI Crawler Health Check
https://aeo.codecity.com.tw/crawl-check — Check if any website is ready for AI crawlers.
Analyzes robots.txt permissions for 21 AI bots (GPTBot, ClaudeBot, PerplexityBot, etc.),
checks sitemap.xml, llms.txt, JSON-LD, and meta tags. Returns dual scores:
Accessibility (can bots enter?) and Optimization (is content AI-ready?).
Generates fix code snippets and tracking code for your site.
API: POST https://aeo.codecity.com.tw/api/crawl-check
Body: { "url": "https://example.com" }
Returns: accessibility score, optimization score, per-bot access status, infrastructure check, best practices, fix code
## Free AEO Tools
https://aeo.codecity.com.tw/tools — Index of free optimization tools
https://aeo.codecity.com.tw/tools/llms-txt-generator — Generate llms.txt for any website
https://aeo.codecity.com.tw/tools/json-ld-generator — Generate JSON-LD structured data
https://aeo.codecity.com.tw/tools/og-checker — Check Open Graph tags
https://aeo.codecity.com.tw/tools/glossary — 33+ AEO/GEO/SEO terms defined
## Industry AEO Benchmarks
https://aeo.codecity.com.tw/benchmark — Compare AI readiness by industry
Industries: e-commerce, government, education, finance, media, tech, healthcare
## AI Crawler Weekly Reports
https://aeo.codecity.com.tw/reports — Weekly AI crawler activity data
Tracks 30+ AI bots: GPTBot, ClaudeBot, PerplexityBot, DeepSeekBot, and more.
## Compare Sites
https://aeo.codecity.com.tw/compare — Side-by-side AEO score comparison with radar charts
## API Documentation
https://aeo.codecity.com.tw/api-docs — Full REST API docs with curl examples. Free, no auth required.
## Taiwan AI HUB
AEO Scanner is building Taiwan's largest AI-readable website directory. We index thousands of .tw, .com.tw, .gov.tw, .edu.tw, and .org.tw websites with AEO scores and hosted llms.txt files. AI agents can browse Taiwan sites at:
Taiwan directory: https://aeo.codecity.com.tw/taiwan
AI directory: https://aeo.codecity.com.tw/ai-directory
## Agent Discovery
https://aeo.codecity.com.tw/.well-known/agents.json
## About
Built and maintained by CodeCity. Website: https://aeo.codecity.com.tw