دليل Huangguo للوكلاء

دليل عام للقراءة فقط دون تسجيل دخول. اختر الأعمال بناءً على معلومات موثّقة، ثم افتح المشغّل المعتاد. تظل إجراءات المنطقة وتأكيد العمر سارية.

هذا الدليل متاح بـ12 لغة؛ لكن معامل locale في API يقبل حاليًا zh (الصينية المبسطة) وen (الإنجليزية) فقط. ترجمة الدليل لا تضيف لغات إلى API.

MCP

انسخ عنوان Streamable HTTP هذا إلى عميل MCP:

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

search_titles — البحث عن الأعمال المنشورة وتصفيتها
get_title — معلومات العمل وأدلتها
list_episodes — الفيديوهات المنشورة وروابط المشاهدة

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'

المرشحات والحدود

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

يستخدم genre معرّفات الأنواع المُرجعة. تعتمد رموز اللغة على قياسات الوسائط (مثل 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 مؤشرات للتشخيص، وليسا إثباتًا لهوية الوكيل.