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.
The guide and API locale support all 12 languages: zh, en, zh-Hant, ja, id, es, ru, ar, fr, pt, vi, th
MCP
Copy this Streamable HTTP endpoint into your MCP client:
https://huangguodrama.ai/api/agent/mcp/
search_titles— Search and filter published titlesget_title— Title facts and evidencelist_episodes— Released clips and playback links
HTTP
curl 'https://huangguodrama.ai/api/agent/v1/search/?locale=en&subtitle=en&duration_scope=continuous&min_duration=600&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, subtitle_scope, completeness, min_duration, max_duration, duration_scope, locale, featured, page, limit
genre uses returned genre IDs. Audio codes come from measured media (e.g. zh, en, zh-Hans); audio requires all published clips to match. subtitle_scope defaults to all_published; any_published explicitly allows partial subtitle coverage. completeness: complete, partial, unknown. Durations are seconds; duration_scope: published (default), complete_work or continuous. continuous starts at episode 1, requires at least 2 episodes and stops at a gap, trailer, repeated source or language mismatch. Its duration and audio/subtitle filters cover only that path; any_published is incompatible. continuous_viewing reports exact episode numbers, duration and language coverage. locale: zh, en, zh-Hant, ja, id, es, ru, ar, fr, pt, vi, th; 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
3564 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.