Руководство Huangguo для агентов
Открытый каталог только для чтения, без входа в аккаунт. Выбирайте произведения по подтверждённым данным, затем открывайте обычный плеер. Действуют существующие ограничения по региону и проверка возраста.
Руководство доступно на 12 языках; параметр locale API сейчас принимает только zh (упрощённый китайский) и en (английский). Перевод руководства не добавляет языки в API.
MCP
Скопируйте этот адрес Streamable HTTP в клиент MCP:
https://huangguodrama.ai/api/agent/mcp/
search_titles— Поиск и фильтрация опубликованных произведенийget_title— Сведения о произведении и их основанияlist_episodes— Опубликованные видео и ссылки на просмотр
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'
Фильтры и ограничения
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. Неизвестные значения не удовлетворяют обязательным условиям.
По умолчанию 10 результатов, максимум 20 на странице; суммарно 60 запросов с IP в минуту для HTTP и MCP. Поисковая строка — до 160 символов; запрос MCP — до 16 KiB. Ошибки: 400 неверный ввод, 403 недопустимый Origin, 404 неизвестное/неопубликованное произведение, 413 слишком большое тело, 429 превышение лимита, 503 отключено/недоступно. Поддерживаются серверные запросы без Origin.
Охват и основания
Опубликовано произведений: 834. Фиксированная подборка из 30 произведений выбрана по числу начатых просмотров за семь дней. Дата снимка подборки: 2026-09-20T10:46:04.829Z
Каждый ответ содержит updated_at и время измерений. Язык страницы, язык медиа, длительность опубликованной части и всего произведения различаются. Если оснований нет, возвращается null. Трейлеры и частичные публикации не выдаются за полный сериал. Недостаток сведений о подробном сюжете, персонажах и отзывах указывается явно; сервис не вызывает рекомендательную модель.
Атрибуция и тестирование
watch_url — каноническая ссылка. attributed_watch_url добавляет подписанный сервером маркер, привязанный к произведению и действующий 24 часа. Запросы, переходы в браузер, реальные запуски, суммарные 30 секунд просмотра и переходы к следующей серии учитываются отдельно. Для тестов задайте X-Agent-Test: true; подписанный маркер сохраняет этот признак. Имя клиента и User-Agent — диагностические подсказки, а не подтверждённая личность агента.