Guía de Huangguo para agentes

Catálogo público de solo lectura, sin inicio de sesión. Elige títulos con datos respaldados y abre el reproductor habitual. Se aplican los controles regionales y de edad existentes.

Esta guía está disponible en 12 idiomas; el parámetro locale de la API solo acepta actualmente zh (chino simplificado) y en (inglés). Traducir la guía no añade idiomas a la API.

MCP

Copia este endpoint Streamable HTTP en tu cliente MCP:

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

search_titles — Buscar y filtrar títulos publicados
get_title — Datos y fuentes del título
list_episodes — Vídeos publicados y enlaces de reproducción

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'

Filtros y límites

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

genre usa los ID de género devueltos. Los códigos de idioma proceden de mediciones del contenido multimedia (p. ej., zh, en, zh-Hans); los filtros audio/subtitle requieren que todos los vídeos publicados coincidan. completeness: complete, partial, unknown. Las duraciones se expresan en segundos; duration_scope: published (predeterminado) o complete_work. locale: zh o en; featured: true o false. Los valores desconocidos nunca cumplen una condición obligatoria.

10 resultados por defecto, máximo 20 por página; 60 solicitudes por IP y minuto entre HTTP y MCP. Búsquedas de hasta 160 caracteres; solicitudes MCP de hasta 16 KiB. Errores: 400 entrada no válida, 403 Origin no permitido, 404 título desconocido/no publicado, 413 cuerpo demasiado grande, 429 límite de solicitudes, 503 desactivado/no disponible. Se admiten solicitudes de servidor sin Origin.

Cobertura y fuentes

834 títulos publicados; selección fija de 30 títulos según los inicios de reproducción de siete días. Captura de la selección: 2026-09-20T10:46:04.829Z

Cada respuesta incluye updated_at y las fechas de medición. El idioma de la página, el del contenido, la duración publicada y la de la obra completa son datos distintos. La falta de evidencia se indica con null. Los tráileres y los estrenos parciales nunca se presentan como series completas. Se indican las carencias de información sobre la trama ampliada, los personajes y las reseñas; el servicio no invoca un modelo de recomendaciones.

Atribución y pruebas

watch_url es la URL canónica. attributed_watch_url añade un marcador firmado por el servidor, vinculado al título y válido durante 24 horas. Las solicitudes, las llegadas al navegador, las reproducciones reales, los 30 segundos acumulados de visualización y los clics al siguiente episodio se miden por separado. Usa X-Agent-Test: true en las pruebas; el marcador firmado conserva este indicador. El nombre del cliente y User-Agent son pistas de diagnóstico, no una identidad de agente autenticada.