# xAgent R1 審計方法論（公開）

**文件狀態**：公開方法論頁，與 `agentx-r1-audit-report` 報告 schema 一一對應。任何一份 R1 報告中的分數與等級，都必須能夠用本文獻復算。

**版本**：v0.2（2026-08-20 生效），取代 v0.1（2026-07 首次上線）。版本沿革見第六節。

---

## 一、這份分數在量什麼

R1 審計量的是「一個公開網站對搜尋引擎、答案引擎與 AI Agent 的可讀與可協作程度」。它只觀察**公開可抓取的訊號**，不接入 Search Console、Bing Webmaster、GA4 等私有數據，也不預測 Google 排名。分數是通過率加權後的綜合讀數，不是搜尋引擎演算法的分數。

測量範圍以目標網站的主頁與根目錄公開資產為限：首頁 HTML、`robots.txt`、`sitemap.xml`、`llms.txt`、`.well-known/agent-card.json`、`.well-known/aeo-agent.json`。

## 二、四軸模型

審計將訊號分為四個軸，每一軸回答一個獨立的問題：

| 軸 | 回答的問題 | 觀察對象 |
|---|---|---|
| SEO（搜尋引擎優化） | 傳統搜尋引擎能否正確抓取、理解、預覽此站 | HTML head、元標記、結構化資料、站內結構 |
| AEO（答案引擎優化） | 答案引擎（ChatGPT、Perplexity、Google AI Overviews）能否直接引用此站的內容作答 | llms.txt、問答內容、摘要、AI 爬蟲政策 |
| GEO（生成式引擎優化） | AI 能否把此站對應到正確的商業實體並建立信任 | Organization/LocalBusiness 標記、sameAs、品牌與信任細節 |
| AGO（代理運作優化） | AI Agent 能否在頁面上操作與完成轉換 | Agent Card、宣告式表單、命名控制項、轉換動作 |

## 三、檢查項清單（30 項）

每一項檢查產生三個狀態之一：green（通過，1.0 分）、yellow（部分通過，0.5 分）、red（未通過，0.0 分）。未通過的項目附 `why_it_matters`（為什麼重要）與 `recommended_fix`（如何修復）兩個欄位，讓報告的每一行 red 都能獨立理解。

### SEO 軸（14 項）

| ID | 檢查項 | 判定條件（摘要） |
|---|---|---|
| seo_fetchable_html | 首頁可公開讀取 | 首頁回 HTTP 200 且 body 可讀 |
| seo_title | Title 清楚 | title 存在、長度 12–70 字 |
| seo_description | Meta description | description 存在、長度 50–180 字 |
| seo_canonical | Canonical URL | 正規 canonical 連結存在 |
| seo_sitemap | Sitemap 可讀 | sitemap.xml HTTP 200 且含有效 URL |
| seo_robots | robots.txt 可讀 | robots.txt HTTP 200 |
| seo_viewport | 行動裝置 viewport | viewport meta 存在 |
| seo_headings | H1 / H2 結構 | H1 恰好一個、至少一個 H2，且 H1 與 Title（或 Title 以 `-–—|:：·｜` 切分後的首段）一致 |
| seo_og | Open Graph 預覽 | og:title、og:description 存在 |
| seo_jsonld | Schema.org JSON-LD | 存在有效 JSON-LD（ld+json） |
| seo_internal_links | 內部連結深度 | 內部連結 ≥ 2 且深度不超過 3 層 |
| seo_breadcrumbs | Breadcrumb 結構 | BreadcrumbList JSON-LD 或結構化導航 |
| seo_author_profile | 作者 / 品牌資料 | 內容頁有作者與出版日期標記 |
| seo_date_consistency | 日期一致性 | HTML 日期與 JSON-LD 日期不衝突 |

### AEO 軸（6 項）

| ID | 檢查項 | 判定條件（摘要） |
|---|---|---|
| aeo_llms_txt | llms.txt | llms.txt 存在、非空、內容 > 100 字 |
| aeo_faq_or_qa | 問答型內容 | 存在 FAQ/問答詞彙訊號 |
| aeo_faq_answers_crawlable | FAQ 答案可爬取 | 答案內容對公開爬蟲可見（不藏在登入後） |
| aeo_direct_summary | 可直接引用摘要 | description 存在，或首段摘要 ≥ 80 字 |
| aeo_ai_crawler_policy | AI crawler 分流 | robots.txt 明訂 GPTBot / ClaudeBot / Google-Extended / PerplexityBot |
| aeo_structured_answer_source | 結構化答案來源 | JSON-LD 存在且含摘要或問答措辭 |

### GEO 軸（4 項）

| ID | 檢查項 | 判定條件（摘要） |
|---|---|---|
| geo_org_entity | Organization / LocalBusiness 實體 | JSON-LD 含 Organization、LocalBusiness 或 Corporation |
| geo_sameas | sameAs 外部身份連結 | JSON-LD 項目含 sameAs |
| geo_author_or_brand | 品牌 / 作者可識別 | 有標題且含品牌訊號 |
| geo_trust_details | 信任細節 | 文字含認證、獎項、評測、案例等信任措辭 |

### AGO 軸（6 項）

| ID | 檢查項 | 判定條件（摘要） |
|---|---|---|
| ago_agent_card | Agent Card | `.well-known/agent-card.json` HTTP 200 且為有效 JSON |
| ago_aeo_agent_descriptor | AEO Agent descriptor | `.well-known/aeo-agent.json` HTTP 200 |
| ago_webmcp_forms | Agent 可操作表單 | 含 `toolname` / `toolparamdescription` / `tooldescription` 的宣告式表單 |
| ago_named_actions | 按鈕與連結可被 Agent 理解 | 按鈕有文字、aria-label 或 title |
| ago_image_context | 圖片有 alt / 尺寸線索 | img 含 alt |
| ago_conversion_action | Agent 可找到轉換動作 | 頁面含詢價、聯絡、預約、購買等轉換措辭 |

## 四、加權與總分計算

計算規則按以下順序，確定且可復算：

1. **檢查項分數**：green = 1.0、yellow = 0.5、red = 0.0（`points` 欄位）。
2. **軸分數**：軸內檢查項 `points` 的算術平均 × 100，四捨五入到整數。軸內所有檢查項**等權**，不引入主觀權重；重要性（importance）欄位僅供讀者優先排序修復順序，不影響分數。
3. **總分**（`summary.overall`）：四軸分數的算術平均，以十進位四捨五入（ROUND_HALF_UP，.5 一律進位，例如 16.5 → 17）取整數（0–100）。四軸任一軸未量到時，總分為 null，不以 0 代替未量到的軸。
   - **企業檢查分數**（`summary.enterprise_check_score`）：企業報告檢查子集 `points` 的平均 × 100，是獨立欄位，不是總分，也不參與總分計算。
4. **等級**：A ≥ 90、B ≥ 75、C ≥ 60、D ≥ 40、F < 40。

**Google Agentic Browsing 對照**（第五個區塊，不計入總分）：將頁面對照 Google 公布的 Agentic Browsing 公開評分訊號逐項比對，作為「公開可觀察的訊號」呈現，並明訂本審計**不以 PageSpeed 分數冒充、不保證 AI 推薦、不取代 Search Console**。

## 五、誠實邊界

本方法論只覆蓋公開可抓取訊號。以下情形一律標記為 pending 或 red，不會以猜測填補：需要登入才能驗證的頁面、付費牆後內容、無法在 10 秒內抓取成功的來源、以及任何需要私有數據才能回答的項目。審計報告的 `non_claims` 欄位固定列出本審計「不宣稱」的三件事：guaranteed_100_score、guaranteed_ai_recommendation、replacement_for_pagespeed_or_search_console。

## 六、版本沿革

| 版本 | 生效日期 | 變更內容 |
|---|---|---|
| v0.1 | 2026-07 | 初版上線：四軸 28 項、加權公式、誠實邊界 |
| v0.2 | 2026-08-20 | 報告 schema 加入 `methodology_url` 與 `schema_version` 欄位；新增公開方法論頁（本文檔）；新增公開統計端點 `/api/agent/public_stats`；檢查項計數與程式碼對齊：AEO 軸為 6 項、四軸總計 30 項（v0.1 文檔曾標 28 項，以本表為準） |

方法論的變更會同時更新本文檔與報告 schema 的 minor 版本號，舊版報告保留其當時的 schema 版本號以確保可回溯。
