# AEO Scanner
> Free website AI-friendliness scoring tool. AEO, GEO, AIEO — Answer Engine Optimization, Generative Engine Optimization, AI Engine Optimization. Scans 9 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.

## What It Does

Given any public URL, AEO Scanner fetches the page, parses its HTML, and scores it across 9 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:

- Meta tags (15%): title tag, meta description, canonical URL
- Content structure (15%): H1/H2 headings, paragraph count, readable length
- JSON-LD schema (15%): presence and type of structured data markup
- Open Graph (10%): og:title, og:description, og:image
- Image alt text (10%): ratio of images that have alt attributes
- FAQ schema (10%): schema.org/FAQPage structured data
- Contact info (10%): presence of address, phone, or email
- llms.txt (10%): whether the site has a /llms.txt file
- Social cards (5%): Twitter/X Card meta tags

## 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": "<script type=\"application/ld+json\">...</script>", "og": "<meta ...>", "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

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.

## 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