Guide Huangguo pour les agents

Catalogue public en lecture seule, sans connexion à un compte. Choisissez des titres à partir de faits sourcés, puis ouvrez le lecteur habituel. Les contrôles régionaux et d’âge existants s’appliquent.

Ce guide existe en 12 langues ; le paramètre locale de l’API n’accepte actuellement que zh (chinois simplifié) et en (anglais). Traduire le guide n’ajoute pas de langues à l’API.

MCP

Copiez ce point d’accès Streamable HTTP dans votre client MCP :

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

search_titles — Rechercher et filtrer les titres publiés
get_title — Informations et sources sur le titre
list_episodes — Vidéos publiées et liens de lecture

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'

Filtres et limites

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

genre utilise les identifiants de genre renvoyés. Les codes de langue proviennent des mesures des médias (par exemple zh, en, zh-Hans) ; les filtres audio/subtitle exigent que chaque vidéo publiée corresponde. completeness : complete, partial, unknown. Les durées sont en secondes ; duration_scope : published (par défaut) ou complete_work. locale : zh ou en ; featured : true ou false. Les valeurs inconnues ne satisfont jamais une contrainte obligatoire.

10 résultats par défaut, 20 au maximum par page ; 60 requêtes par IP et par minute au total pour HTTP et MCP. Recherche limitée à 160 caractères ; requêtes MCP limitées à 16 KiB. Erreurs : 400 entrée invalide, 403 Origin interdit, 404 titre inconnu/non publié, 413 corps trop volumineux, 429 limite de requêtes, 503 désactivé/indisponible. Les requêtes serveur sans Origin sont prises en charge.

Couverture et sources

834 titres publiés ; sélection fixe de 30 titres selon les démarrages de lecture sur sept jours. Date de capture de la sélection : 2026-09-20T10:46:04.829Z

Chaque réponse fournit updated_at et les dates de mesure. La langue de la page, celle du média, la durée publiée et celle de l’œuvre complète sont distinctes. Une donnée sans preuve vaut null. Les bandes-annonces et les publications partielles ne sont jamais présentées comme des séries complètes. Les lacunes concernant l’intrigue détaillée, les personnages et les avis sont indiquées ; le service n’appelle aucun modèle de recommandation.

Attribution et tests

watch_url est l’URL canonique. attributed_watch_url ajoute un marqueur signé par le serveur, lié au titre et valable 24 heures. Les requêtes, les arrivées dans le navigateur, les lectures réelles, les 30 secondes cumulées de visionnage et les clics vers l’épisode suivant sont mesurés séparément. Définissez X-Agent-Test: true pour les tests ; le marqueur signé conserve cet indicateur. Le nom du client et User-Agent sont des indices de diagnostic, pas une identité d’agent authentifiée.