Guia do Huangguo para agentes
Catálogo público somente para leitura, sem login. Escolha títulos com base em fatos com fontes e abra o player habitual. As regras existentes de região e confirmação de idade continuam valendo.
Este guia está disponível em 12 idiomas; o parâmetro locale da API aceita atualmente apenas zh (chinês simplificado) e en (inglês). A tradução do guia não adiciona idiomas à API.
MCP
Copie este endpoint Streamable HTTP para seu cliente MCP:
https://huangguodrama.ai/api/agent/mcp/
search_titles— Buscar e filtrar títulos publicadosget_title— Dados e evidências do títulolist_episodes— Vídeos publicados e links de reprodução
HTTP
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'
Filtros e limites
q, genre, audio, subtitle, completeness, min_duration, max_duration, duration_scope, locale, featured, page, limit
genre usa os IDs de gênero retornados. Os códigos de idioma vêm de medições da mídia (por exemplo, zh, en, zh-Hans); os filtros audio/subtitle exigem correspondência em todos os vídeos publicados. completeness: complete, partial, unknown. As durações estão em segundos; duration_scope: published (padrão) ou complete_work. locale: zh ou en; featured: true ou false. Valores desconhecidos nunca atendem a uma condição obrigatória.
10 resultados por padrão, no máximo 20 por página; 60 solicitações por IP por minuto no total entre HTTP e MCP. Busca com até 160 caracteres; solicitações MCP de até 16 KiB. Erros: 400 entrada inválida, 403 Origin não permitido, 404 título desconhecido/não publicado, 413 corpo muito grande, 429 limite de solicitações, 503 desativado/indisponível. Solicitações de servidor sem Origin são aceitas.
Cobertura e evidências
834 títulos publicados; seleção fixa de 30 títulos conforme os inícios de reprodução em sete dias. Registro da seleção: 2026-09-20T10:46:04.829Z
Cada resposta fornece updated_at e horários das medições. Idioma da página, idioma da mídia, duração publicada e duração da obra completa são dados distintos. Sem evidência, o valor é null. Trailers e lançamentos parciais nunca são apresentados como séries completas. Lacunas de enredo detalhado, personagens e avaliações são informadas; o serviço não chama um modelo de recomendação.
Atribuição e testes
watch_url é a URL canônica. attributed_watch_url adiciona um marcador assinado pelo servidor, vinculado ao título e válido por 24 horas. Solicitações, chegadas ao navegador, reproduções reais, 30 segundos acumulados de visualização e cliques no próximo episódio são medidos separadamente. Use X-Agent-Test: true nos testes; o marcador assinado preserva esse indicador. Nome do cliente e User-Agent são pistas de diagnóstico, não uma identidade de agente autenticada.