黃果 Agent 接入

公開唯讀目錄，無需登入。根據有依據的資料選劇，再進入一般播放器，繼續遵循地區與年齡確認流程。

本指南提供 12 種語言；API 的 locale 參數目前僅支援 zh（簡體中文）及 en（英語）。指南翻譯不代表 API 支援更多語言。

MCP

將此 Streamable HTTP 位址複製到 MCP 用戶端：

https://huangguodrama.ai/api/agent/mcp/

search_titles — 搜尋與篩選已發布作品
get_title — 作品資料與依據
list_episodes — 已發布影片及播放入口

HTTP

OpenAPI 3.1

curl 'https://huangguodrama.ai/api/agent/v1/search/?locale=en&limit=10'
curl 'https://huangguodrama.ai/api/agent/v1/titles/10438/?locale=en'
curl 'https://huangguodrama.ai/api/agent/v1/titles/10438/episodes/?page=1&limit=20'

篩選與限制

q, genre, audio, subtitle, completeness, min_duration, max_duration, duration_scope, locale, featured, page, limit

genre 使用傳回的題材 ID。音軌及字幕依實測語言代碼（如 zh、en、zh-Hans）篩選，要求每段已發布影片都符合。completeness：complete、partial、unknown。時長單位為秒，duration_scope 為 published（預設）或 complete_work。locale 為 zh 或 en；featured 為 true 或 false。未知值不符合硬性條件。

預設每頁 10 項，最多 20 項；HTTP 與 MCP 合計每個 IP 每分鐘 60 次。關鍵字不超過 160 字，MCP 請求不超過 16 KiB。錯誤碼：400 輸入無效、403 Origin 不允許、404 作品不存在或未發布、413 請求過大、429 限流、503 關閉或不可用。支援不帶 Origin 的伺服器端呼叫。

範圍與依據

834 部已發布作品；按七天實際開始播放次數固定 30 部精選。精選快照：2026-09-20T10:46:04.829Z

每筆資料提供 updated_at 與測量時間。頁面語言、媒體語言、已發布時長與完整作品時長分開表示。缺少依據時為 null。預告與部分發布不視為完整影集。延伸劇情、人物及評價資料不足會明確標示；服務不呼叫推薦模型。

歸因與測試

watch_url 為標準連結；attributed_watch_url 帶有伺服器簽署、綁定作品且 24 小時有效的標記。呼叫、瀏覽器抵達、實際播放、累計觀看 30 秒及下一集點擊分別統計。測試呼叫請設定 X-Agent-Test: true，簽署標記會保留測試屬性。用戶端名稱與 User-Agent 僅供診斷參考，並非 Agent 身分驗證。