Huangguoのエージェント接続ガイド

ログイン不要の公開読み取り専用カタログです。根拠のある情報で作品を選び、通常のプレーヤーを開いてください。既存の地域・年齢確認の手順が適用されます。

本ガイドは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など）を使い、audio/subtitleの条件には公開済みのすべての映像が一致する必要があります。completenessはcomplete、partial、unknownです。時間の単位は秒、duration_scopeはpublished（既定）またはcomplete_workです。localeはzhまたはen、featuredはtrueまたはfalseです。不明な値は必須条件を満たしません。

1ページあたり既定10件、最大20件。HTTPとMCPを合計して、IPごとに毎分60リクエストまでです。検索語は160文字以内、MCPリクエストは16 KiB以下です。エラー：400は入力不正、403は許可されないOrigin、404は作品が不明または未公開、413は本文サイズ超過、429は回数制限、503は無効または利用不可です。Originのないサーバーからのリクエストにも対応します。

収録範囲と根拠

公開作品は834件。7日間の実際の再生開始数に基づき選んだ30件の固定特集があります。対象集団の記録日時：2026-09-20T10:46:04.829Z

各応答にupdated_atと測定日時を含みます。ページ言語、メディア言語、公開分の時間、作品全体の時間は別の情報です。根拠がない値はnullです。予告や一部のみの公開を全話公開として扱いません。詳しいあらすじ・人物・評価の情報不足は明示し、推薦モデルは呼び出しません。

流入の計測とテスト

watch_urlは正規URLです。attributed_watch_urlにはサーバーが署名した作品ごとのマーカーが付き、24時間有効です。リクエスト数、ブラウザーの訪問、実際の再生、累計30秒の視聴、次のエピソードへのクリックは別々に計測します。テスト時はX-Agent-Test: trueを設定してください。署名付きマーカーにもこの属性が保持されます。クライアント名とUser-Agentは診断用の参考情報であり、エージェントの本人確認にはなりません。