Huangguo for agents

Public read-only catalog. No login required. Select titles using sourced facts, then open the regular player. Existing regional and age flows apply.

中文

MCP

Copy this Streamable HTTP endpoint into your MCP client:

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

search_titles — Search and filter published titles
get_title — Title facts and evidence
list_episodes — Released clips and playback links

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'

Filters and limits

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

genre uses returned genre IDs. Language codes use measured media values (e.g. zh, en, zh-Hans); audio/subtitle filters require every published clip to match. completeness: complete, partial, unknown. Durations are seconds; duration_scope: published (default) or complete_work. locale: zh or en; featured: true or false. Unknown values never satisfy a hard constraint.

Default 10 results, maximum 20 per page; 60 requests per IP per minute across HTTP and MCP. Search keywords ≤160 characters; MCP requests ≤16 KiB. Errors: 400 invalid input, 403 disallowed Origin, 404 unknown/unpublished title, 413 oversized body, 429 rate limit, 503 disabled/unavailable. Server requests without Origin are supported.

Coverage and evidence

513 published titles; 30 fixed featured records selected by seven-day playback starts. Cohort captured: 2026-09-20T10:46:04.829Z

Each response provides updated_at and measurement timestamps. Page language, media language, published duration and full-work duration are distinct. Missing evidence is null. Trailers and partial releases are never represented as a complete series. Extended plot, character and review gaps are disclosed; this service does not call a recommendation model.

Attribution and testing

watch_url is canonical. attributed_watch_url adds a server-signed, title-bound marker valid for 24 hours. Request counts, browser arrivals, actual plays, cumulative 30-second viewing and next-episode clicks are measured separately. Set X-Agent-Test: true for test calls; the signed marker preserves this flag. Client name and User-Agent are diagnostic hints, not authenticated agent identity.