生活智慧王 » 旅遊小幫手

摘要¶

完成研究問題 Q6（Agoda 是否有可用的官方 API 或聯盟方案？爬蟲難度與反爬對策？）
的 primary → verifier → synthesizer 全調研管線，落地進 specs，並收斂業主
D-FILTER-2（C-3 跨平台評分門檻）。

背景 / 問題¶

住宿來源拼圖：Booking 路徑已於 ADR-003/ADR-004 完整，Agoda 待補。需界定
Agoda 是否有可用的結構化資料 API、個人非商業使用者能否取得、以及爬蟲難度。

調研結論（核心裁決）¶

• Agoda 有結構化官方 API（Affiliate Long Tail Search：reviewScore(0-10)/
  reviewCount/starRating/dailyRate，支援 zh-tw/TWD，缺座標）——幾乎正中 C-3 需求。
• 但個人本機工具在資格面拿不到 key（官方硬性要求：可驗證網站 + 強制網域驗證 +
  銀行資料）；primary 一度設想的 Travelpayouts 繞道經 verifier 證實不成立
  （其 Data API 僅機票欄位）。
• A 對 Agoda 同 Booking 本輪不採用，ADR-003 不推翻不降級（反而強化 A 否決的事實基礎）。
• Agoda C 管道（爬蟲）增量難度高於 Booking.com 且缺專屬反爬實測【假設】，
  不得升 ✅（同母公司反爬相似性不可外推 Booking 數值）。
• 座標須由 Content API 或既有 Google Maps key（OW-4）補，與 Q3 座標策略一致。

處理經過¶

1. research-primary：查得 Agoda 三條 API 路徑與欄位集、申請門檻；初設 Travelpayouts 繞道（標【假設】）。
2. research-verifier（部分採信，K=0 無幻覺）：推翻 Travelpayouts 繞道；
   以官方一手來源升級「資格面硬門檻」；price-comparison 措辭降二手；
   確認 Agoda 反爬無專屬實測、維持【假設】。
3. research-synthesizer：整合產出結論，建議 3 項 specs 變更 + 衍生 Q14/Q15 +
   業主 C-3 確認；建 q-6 決策樹節點。
4. 業主 D-FILTER-2：Agoda 套用與 Booking 同一 8.6 門檻。
5. system-architect 落地：ARCH-2 Agoda 註記（維持 ⏳）；ADR-003 補 Agoda 重啟
   前置門檻（ADR_UPDATED 非降級）；新增 C-13（OTA 聯盟 API 用途合規，條件性生效）；
   C-3 措辭擴為「Booking/Agoda ≥ 8.6 或 Google ≥ 4.1」+ glossary/ARCH-2 drift 校正。

變更檔案¶

• docs/research/reports/2026-06-05_Q6_agoda-api_report.md（新增）
• docs/research/verifications/2026-06-05_Q6_agoda-api_verification.md（新增）
• docs/research/conclusions/2026-06-05_Q6_agoda-api_conclusion.md（新增）
• docs/decisions/tree/research/q-6-agoda-api.md（新增）
• docs/decisions/ADR-003-accommodation-data-acquisition.md（補 Agoda 重啟門檻 + C-13 連動）
• docs/specs/constraints.md（新增 C-13；C-3 擴 Agoda 8.6）
• docs/specs/architecture.md（ARCH-2 Agoda 子面向；C-3 drift 校正）
• docs/specs/glossary.md（評分門檻 drift 校正）
• docs/decisions/tree/adr/adr-003-accommodation-data-acquisition.md（補 q-6 依賴 + C-13，re-verified）
• docs/decisions/tree/00-index.md（q-6 節點 + ADR-003 行 + 修訂歷史）
• docs/research/open-questions.md（Q6 ✅；新增 Q14/Q15）
• docs/owner-tracking/2026-06-04_owner-decision-package.md（D-FILTER-2）

衍生待辦（後續 ticket）¶

• Q14（P1，data-integration-engineer，需實測）：Agoda 反爬專屬實測，與 Booking 直接比較
• Q15（P2，data-integration-engineer）：Agoda 座標補全成本（Content API vs Maps key 反查）
• C-13 條件性生效：俟系統整合任一 OTA 聯盟 API 時生效（當前 no-op）
• qa-engineer：Agoda C 管道完整場景成功率須獨立驗證，不沿用 Booking 結果

驗收條件¶

• Q6 三段管線（primary/verifier/synthesizer）皆遵守研究鐵則（MCP 自檢 + 實抓 URL 清單 + 信心標籤）
• verifier 推翻項（Travelpayouts 繞道）已反映於結論，未沿用 primary 假設
• ADR-003 ADR_UPDATED 非降級，失效觸發與整體決策不變
• C-13 規則化（非個案禁止）、條件性生效、廣度限 OTA 聯盟 API
• 業主 D-FILTER-2 落地 C-3，無技術成熟度誤升（Agoda 反爬維持【假設】）
• 決策樹 q-6 節點 + index + open-questions 簿記完成