# agent01

> 台灣網站對 AI agent 的可達性實測資料。量的是 agent 實際去抓時發生什麼（狀態碼、正文抽得出來嗎、JS 空殼、登入牆、bot challenge），不是網站宣告了什麼。給 agent 用：出發抓某個台灣網站前先查一下，會被擋就別去，能繞就照建議繞。

分數 0–100 = 首頁層 × 0.5 + 任務層 × 0.5。首頁層看門口讓不讓 agent 進（Claude-User / ChatGPT-User 首頁 200、正文、robots、llms.txt），任務層看進門後能不能真的完成一件事（讀一篇新聞、看商品價、查票價）。每個觀測點各算一份，同站在台灣 IP 與境外 IP 的結果可能相反，不平均：你在台灣跑看 local-tw，在境外雲端跑看 gha-us。

目前資料：
- local-tw（台灣 IP）：391 站，平均 66.9，資料 2026-09-11
- gha-us（境外 IP）：391 站，平均 64.7，資料 2026-11-13

## 純 HTTP JSON（不需要 MCP，fetch 就能用）

- [單站分數](https://agent01.tw/api/site/thsrc.com.tw.json): `/api/site/{domain}.json`。回各觀測點的 score / grade / home_score / task_score / verdict / 三 UA 狀態碼 / advice（可執行的一句話）/ 深層頁任務結果 / 量測日期。domain 去掉 www.、只留網域；回 404 = 不在受測清單（清單見 /api/sites.json），不代表那個站抓不到。404 的 body 是首頁 HTML，只看狀態碼、別讀 body；要結構化的「不在清單」回應請用 MCP（found=false）。
- [全部站](https://agent01.tw/api/sites.json): 精簡版，所有站各觀測點的分數與態度
- [評分公式](https://agent01.tw/api/scoring.json): 權重、版本、task_state 語意
- [端點總覽](https://agent01.tw/api/index.json)

## MCP（remote，免安裝、免認證）

- endpoint `https://mcp.agent01.tw/mcp`（Streamable HTTP，只讀，有速率限制）。Claude Code：`claude mcp add --transport http agent01 https://mcp.agent01.tw/mcp`；Claude.ai：設定 → Connectors → 新增自訂 connector，貼上這個 URL
- tools：`get_site_score(domain, vantage)`（domain 可給整個 URL、www. 自動去掉；vantage 不給 = 全部觀測點）、`list_sites(vantage, category, grade, limit)`
- [Server card](https://agent01.tw/.well-known/mcp/server-card.json)

## 規則

- [評分規則（公開）](https://agent01.tw/scoring.md): 每一分怎麼來的，任何人可重算。觀測點與回報來源不公開
- [排行榜（給人看）](https://agent01.tw/): 同一份資料的頁面版

## Optional

- 境外 IP（gha-us）每日更新；台灣 IP（local-tw）不定期更新，看各觀測點的 date；HTTP cache max-age=300
- 目前沒有公開的回報端點（remote MCP 只讀）；抓完的實際體驗暫時無法回報。
- 探測不做任何反偵測，每站請求數固定、逾時 15 秒、不重試 4xx；被擋就記被擋
- agent01 是獨立評測，不賣修復方案