# AEO Scanner — Full Documentation
> Taiwan's largest AI HUB. Free website AEO scoring tool analyzing 8 metrics across 10229 websites (6888 Taiwan .tw sites).

## Overview

AEO Scanner scans any public website and scores it on 8 Answer Engine Optimization metrics. It generates ready-to-use fix code snippets for JSON-LD, Open Graph, FAQ schema, and llms.txt. No login required.

## Scoring Methodology

Weighted sum formula (0-100):
- JSON-LD schema (30%): structured data markup presence
- llms.txt (20%): /llms.txt file availability
- Open Graph (15%): og:title, og:description, og:image, og:url, og:type
- Meta tags (10%): title, meta description, canonical URL
- FAQ schema (10%): FAQPage schema or <details> elements
- Social cards (5%): Twitter/X Card meta tags
- Contact info (5%): email, phone, or address presence
- Image alt text (5%): percentage of images with alt attributes

## API Reference

### POST https://aeo.codecity.com.tw/api/scan
Scan a website. Body: { "url": "https://example.com" }
Returns: score, 8 sub-scores, generated code snippets, suggestions.

### GET https://aeo.codecity.com.tw/api/sites?page=1&limit=20&sort=score
List scanned sites with pagination and sorting.

### GET https://aeo.codecity.com.tw/api/sites/{id}
Get detailed report for a specific site.

### GET https://aeo.codecity.com.tw/api/stats
Global statistics including total scans, indexed sites, Taiwan site count, active AI crawlers.

### GET https://aeo.codecity.com.tw/api/crawlers/activity
AI crawler visit activity grouped by bot, domain, and pages.

### GET https://aeo.codecity.com.tw/api/meta
Tool metadata including capabilities and scoring model.

## Top 20 Sites by AEO Score

1. 輔康企業｜真心關愛行無障礙 - 輔康企業｜台灣無障礙車、福祉車改裝 — Score: 100/100 (https://www.forkare.com/)
2. 首頁 - 創新軟體解決方案 — Score: 100/100 (https://codecity.com.tw)
3. 首頁 - 創新軟體解決方案 — Score: 100/100 (https://codecity.com.tw/)
4. 台中合庫當舖|台中合法北區當舖借款首選，免聯徵、快速放款 - 台中合庫當舖 — Score: 98/100 (https://www.tcb-pawnshop.com/)
5. TutorABC - 最專業的線上語言學習平台 | 線上英文、中文、檢定、遊留學專家 — Score: 96/100 (http://www.tutorabc.com)
6. 浯島金門-HO覓社會創新合作組合 -金門隊ING，整座島做為發展外擴關鍵支點浯島金門-HO覓社會創新合作組合 -金門隊ING，整座島做為發展外擴關鍵支點 — Score: 96/100 (https://homi.cc/quaw)
7. 新華米粉｜新竹百年傳承純米米粉，道地日曬風乾傳統美味 — Score: 96/100 (http://www.rice-noodle.com.tw/)
8. 馬爾地夫旅遊：蜜月、全包式度假、親子行程與海底餐廳攻略 - 博海旅行社Facebook Group — Score: 96/100 (http://www.mle.com.tw)
9. 統旺科技｜ 工業機器人系統整合專家與智慧製造解決方案 — Score: 95/100 (https://www.tovonn.com.tw/)
10. 馬尼通訊｜台南高雄手機門號申辦・手機維修・3C 穿戴專賣 — Score: 92/100 (https://www.money3c.com.tw/business.html)
11. 首頁 | NCH 亞太區 — Score: 91/100 (https://www.nchasia.com/zh-tw)
12. 寬達聯合會計師事務所– 深耕在地的優質選擇｜中壢｜桃園｜推薦 — Score: 91/100 (https://www.quandacpa.com/)
13. 音圓電腦伴唱機專家 | 歌單查詢下載、卡拉OK、KTV娛樂解決方案 — Score: 91/100 (http://www.inyuan.com.tw)
14. iPlace 艾普雷斯智能生活 | 一站式多合一專業全屋智能家居規劃服務 多品牌智能設備多合一整合控制 | 台中專業智能家居規劃師 | 各式智能設備情境設定，為您量身訂做專屬智慧家庭，擁有室內設計執照、及十年專業弱電經驗的在地台中智能家居、智慧家庭規劃團隊。 — Score: 91/100 (https://iplace.com.tw/)
15. KPMG安侯建業聯合會計師事務所 | KPMG in Taiwan - KPMG Taiwan — Score: 90/100 (http://kpmg.com/tw)
16. 鴻林興業股份有限公司 | 瀝青混凝土 | Taiwan, 屏東縣里港鄉三廍村 — Score: 90/100 (https://www.honlinasphalt.com/)
17. 立達徵信社-政府立案合法徵信社，網路評價專業首選 — Score: 90/100 (https://www.liidda.com.tw/)
18. 劦翊實業有限公司-水性壓克力球場材,防水塗料,外牆拉皮,內牆裝飾塗料,斷熱塗料 — Score: 90/100 (https://www.myshujun.com/)
19. DEBOLA 黛寶拉｜女人幸福SPA — Score: 90/100 (http://www.debola.com.tw)
20. 王佳膠帶SEAL KING - 包裝與工業膠帶Packaging and Industrial Tapes - Eco-friendly Materials, Committed to Sustainable Development — Score: 90/100 (http://www.sealking.com.tw)

## Taiwan AI HUB

AEO Scanner indexes 6888 Taiwan websites (.tw, .com.tw, .gov.tw, .edu.tw, .org.tw).
Browse: https://aeo.codecity.com.tw/taiwan

## Machine-Readable Resources

- OpenAPI: https://aeo.codecity.com.tw/openapi.json
- AI Plugin: https://aeo.codecity.com.tw/.well-known/ai-plugin.json
- Agents: https://aeo.codecity.com.tw/.well-known/agents.json
- Sitemap: https://aeo.codecity.com.tw/sitemap.xml
- AI Directory: https://aeo.codecity.com.tw/ai-directory
- Blog: https://aeo.codecity.com.tw/blog
- Taiwan AI HUB: https://aeo.codecity.com.tw/taiwan
- llms.txt (summary): https://aeo.codecity.com.tw/llms.txt

## Blog (3 Languages)

AEO Scanner publishes tutorials and guides in 3 languages:
- Chinese: https://aeo.codecity.com.tw/blog (17 posts)
- English: https://aeo.codecity.com.tw/en/blog (5 posts)
- Japanese: https://aeo.codecity.com.tw/ja/blog (8 posts)

Topics: AEO fundamentals, GEO guide, llms.txt, ChatGPT Search optimization, Perplexity SEO, Google AI Overviews, JSON-LD, FAQ Schema, Open Graph, Taiwan e-commerce AEO, AI content strategy, AI crawler monitoring.

## Free AEO Tools

- llms.txt Generator: https://aeo.codecity.com.tw/tools/llms-txt-generator
- JSON-LD Generator: https://aeo.codecity.com.tw/tools/json-ld-generator
- Open Graph Checker: https://aeo.codecity.com.tw/tools/og-checker
- AEO Glossary (33 terms): https://aeo.codecity.com.tw/tools/glossary
- All tools: https://aeo.codecity.com.tw/tools

## Industry Benchmarks

Compare AI readiness by industry: https://aeo.codecity.com.tw/benchmark
Industries: e-commerce, government, education, finance, media, tech, healthcare.

## AI Crawler Weekly Reports

Weekly AI bot activity data: https://aeo.codecity.com.tw/reports

## Site Comparisons

Side-by-side AEO score comparison: https://aeo.codecity.com.tw/compare

## API Documentation

Full REST API docs: https://aeo.codecity.com.tw/api-docs

## Hosted llms.txt

Each scanned site gets a hosted llms.txt file in multiple languages (zh, ja, en):
https://aeo.codecity.com.tw/aeo/shops/{domain-slug}/llms.txt?lang=zh

## Limitations

- Only publicly accessible URLs (no auth-protected pages)
- Static HTML analysis (JavaScript-rendered content may be incomplete)
- Scores reflect page state at scan time
- llms.txt detection via HTTP request to target /llms.txt

## Contact

Email: codecity0912@gmail.com
Website: https://aeo.codecity.com.tw