2outube
للمطورين وبُناة الوكلاء

لماذا يفشل طلب YouTube Transcript API لديك.

إذا كان سكربت يعمل على الخادم — youtube-transcript-api أو أداة استخراج أو طلبك الخاص إلى نقطة نهاية timedtext في يوتيوب — يُرجع نتائج فارغة أو محجوبة، فهذا ليس خطأً في شيفرتك. يحجب يوتيوب طلبات النصوص القادمة من نطاقات IP السحابية ومراكز البيانات، بما في ذلك AWS وGCP وAzure وCloudflare Workers.

النص الكامل خلال ثوانٍ — قابل للبحث، بطوابع زمنية، ولك أن تحتفظ به.

هذا الحجب قائم على IP لا على الحساب: الطلب نفسه الذي ينجح من اتصال منزلي يُرجع لا شيء (أو 429/403) من الخادم. ولهذا فإن المكتبات المجتمعية التي تستخرج نقاط نهاية الترجمة في يوتيوب مباشرة صارت أقل موثوقية باطراد عند تشغيلها في السحابة.

يتجاوز 2outube ذلك بالدفع لمزوّد مُدار يمتلك أسطولاً من الوكلاء السكنيين (residential proxy)، فيبدو الطلب كمتصفح عادي لا كمركز بيانات. هذه تفصيلة تنفيذ داخلية — راجع الملاحظة الصريحة أدناه لتعرف ما يعنيه ذلك لك وما لا يعنيه.

ما هو 2outube فعلاً (وما ليس هو)

إنه أداة متصفح، لا واجهة برمجية للمطورين. لا توجد نقطة نهاية عامة، ولا مفتاح API، ولا التزام بوقت تشغيل اليوم. إن كان استخدامك يتطلب وصولاً برمجياً إلى النصوص، فأنت بحاجة إلى مزوّد مُدار خاص بك يدعم الوكلاء السكنيين (مدفوع) — أما تشغيل youtube-transcript-api أو أداة استخراج خام من خادم سحابي فسيظل يفشل لسبب حجب IP المذكور أعلاه، لا لأن شيفرتك خاطئة.

أسئلة، وإجاباتها.

لماذا لا تُرجع youtube-transcript-api (أو أداة الاستخراج الخاصة بي) شيئاً عند تشغيلها على خادم؟

يحجب يوتيوب طلبات الترجمة/النصوص الصادرة من نطاقات IP لمراكز البيانات والسحابة. وغالباً ما تعمل الشيفرة نفسها بسلاسة من اتصال إنترنت منزلي، ولذلك تبدو كخطأ متقطّع بدلاً من حقيقتها: حجب قائم على IP.

هل يمتلك 2outube واجهة API عامة يمكنني استدعاؤها؟

ليس اليوم. 2outube أداة ويب — الصق رابطاً، واحصل على النص في المتصفح. لا توجد نقطة نهاية موثّقة، ولا مفتاح API، ولا وقت تشغيل ملتزم به للاستخدام البرمجي.

ماذا ينبغي أن أستخدم بدلاً من استخراج يوتيوب مباشرة؟

مزوّد نصوص مُدار يشغّل الطلبات عبر وكلاء سكنيين (مدفوع) — نفس فئة الخدمة التي يعتمد عليها 2outube داخلياً.

هل يوجد حل مجاني موثوق؟

ليس واحداً يعمل من خادم سحابي. الحجب القائم على IP هو تحديداً ما يجعل أساليب الاستخراج المجانية غير متسقة — قد تعمل اليوم وتفشل غداً مع تعديلات يوتيوب.

هل سيضيف 2outube واجهة API عامة؟

لا خطط مؤكدة للإعلان عنها. وإن تغيّر ذلك، فسيظهر على 2outube.com/llms.txt، الذي يسرد ما هو موجود فعلاً اليوم.