Panduan agen Huangguo

Katalog publik hanya-baca tanpa login. Pilih judul berdasarkan fakta bersumber, lalu buka pemutar biasa. Aturan wilayah dan konfirmasi usia tetap berlaku.

Panduan ini tersedia dalam 12 bahasa; parameter locale API saat ini hanya menerima zh (Mandarin sederhana) dan en (Inggris). Terjemahan panduan tidak menambah bahasa API.

MCP

Salin endpoint Streamable HTTP ini ke klien MCP Anda:

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

search_titles — Cari dan filter judul yang diterbitkan
get_title — Fakta dan bukti tentang judul
list_episodes — Klip yang diterbitkan dan tautan pemutaran

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'

Filter dan batasan

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

genre memakai ID genre yang dikembalikan. Kode bahasa memakai hasil pengukuran media (misalnya zh, en, zh-Hans); filter audio/subtitle mewajibkan semua klip yang diterbitkan cocok. completeness: complete, partial, unknown. Durasi dalam detik; duration_scope: published (bawaan) atau complete_work. locale: zh atau en; featured: true atau false. Nilai yang tidak diketahui tidak memenuhi syarat wajib.

Bawaan 10 hasil, maksimum 20 per halaman; total 60 permintaan per IP per menit untuk HTTP dan MCP. Kata kunci maksimal 160 karakter; permintaan MCP maksimal 16 KiB. Galat: 400 masukan tidak valid, 403 Origin tidak diizinkan, 404 judul tidak dikenal/belum diterbitkan, 413 isi terlalu besar, 429 batas permintaan, 503 dinonaktifkan/tidak tersedia. Permintaan server tanpa Origin didukung.

Cakupan dan bukti

858 judul diterbitkan; 30 pilihan tetap dipilih berdasarkan jumlah mulai pemutaran selama tujuh hari. Cuplikan data pilihan dicatat pada: 2026-09-20T10:46:04.829Z

Setiap respons memuat updated_at dan waktu pengukuran. Bahasa halaman, bahasa media, durasi yang diterbitkan dan durasi karya lengkap adalah hal berbeda. Bukti yang tidak ada bernilai null. Trailer dan rilisan sebagian tidak dianggap serial lengkap. Kekurangan rincian alur, tokoh dan ulasan dijelaskan; layanan ini tidak memanggil model rekomendasi.

Atribusi dan pengujian

watch_url adalah URL kanonis. attributed_watch_url menambahkan penanda bertanda tangan server, terikat pada judul dan berlaku 24 jam. Jumlah permintaan, kedatangan browser, pemutaran nyata, akumulasi tontonan 30 detik dan klik episode berikutnya dihitung terpisah. Gunakan X-Agent-Test: true untuk pengujian; penanda bertanda tangan mempertahankan atribut ini. Nama klien dan User-Agent hanya petunjuk diagnostik, bukan identitas agen terautentikasi.