黄果 Agent 接入

公开只读目录，无需登录。根据有依据的资料选剧，再进入常规播放器，继续执行地区和年龄流程。

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 的服务端调用。

覆盖与依据

513 部已发布作品；按七天真实开始播放量固定 30 部精选。精选快照：2026-09-20T10:46:04.829Z

每条资料提供 updated_at 与测量时间。页面语言、媒体语言、已发布时长和完整作品时长分别表达。缺少依据时为 null。预告与部分发布不视作全剧。扩展剧情、人物和评价资料不足会明确标注；服务端不调用推荐模型。

归因与测试

watch_url 为规范链接；attributed_watch_url 携带服务端签名、绑定作品且 24 小时有效的标记。调用、浏览器抵达、实际播放、累计观看 30 秒和续集点击分别统计。测试调用请设置 X-Agent-Test: true，签名标记会保留测试属性。客户端名称和 User-Agent 仅作辅助信息，不是 Agent 身份证明。