⌨️ CLI / الطرفية

أداة CLI لنصوص فيديوهات YouTube: استخرج النصوص من الطرفية

استخرج نصوص فيديوهات YouTube مباشرةً من سطر الأوامر. استخدم أوامر curl من سطر واحد أو حزمة NPM أو Python SDK الخاصة بنا لدمج استخراج النصوص في سكربتات Shell ومسارات CI/CD وسير عمل الأتمتة.

احصل على مفتاح API ←توثيق API

البدء السريع مع CURL

أسرع طريقة للحصول على نص من الطرفية، بأمر curl واحد:

Terminal

curl -H "x-api-key: YOUR_API_KEY" \
  "https://youtubetranscript.dev/api/v2/transcript?video=dQw4w9WgXcQ"

باستخدام حزمة NPM

لسير العمل الأكثر تعقيدًا، استخدم حزمة NPM في سكربتات Node.js:

JavaScript / Node.js

import { YouTubeTranscript } from "youtube-transcript-api";

const yt = new YouTubeTranscript({ apiKey: process.env.API_KEY });

const result = await yt.getTranscript("dQw4w9WgXcQ");
console.log(result.data?.transcript.text);

باستخدام Python SDK

سكربتات Python ممتازة لمسارات معالجة البيانات وتحليلها:

Python

from youtubetranscript import YouTubeTranscript
import os

yt = YouTubeTranscript(os.environ["API_KEY"])

result = yt.transcribe("dQw4w9WgXcQ")
print(result.text)

نصائح وحيل لسطر الأوامر

مرّر المخرجات إلى jq لمعالجة JSON

استخدم jq لاستخراج حقول محددة من استجابة JSON:

curl -H "x-api-key: KEY" \
  "https://youtubetranscript.dev/api/v2/transcript?video=ID" \
  | jq '.text'

الحفظ في ملف

أعد توجيه المخرجات لحفظ النصوص مباشرةً في ملفات:

curl -H "x-api-key: KEY" \
  "https://youtubetranscript.dev/api/v2/transcript?video=ID" \
  > transcript.txt

المعالجة الدفعية باستخدام xargs

عالج عدة روابط فيديو من ملف:

cat urls.txt | xargs -I{} curl -H "x-api-key: KEY" \
  "https://youtubetranscript.dev/api/v2/transcript?video={}"

التكامل مع سكربتات Shell

ابنِ سكربتات أتمتة تستخرج النصوص وتعالجها ضمن سير عمل أكبر.

حالات الاستخدام

مسارات CI/CD

استخرج النصوص ضمن مسارات معالجة المحتوى في GitHub Actions أو GitLab CI أو Jenkins.

سكربتات البحث

عالج روابط الفيديو دفعيًا للبحث الأكاديمي أو تحليل المحتوى أو بناء مجموعات البيانات.

أتمتة المحتوى

أتمت استخراج النصوص باستخدام مهام cron أو سكربتات Shell أو ملفات Makefile.

سير عمل المطورين

استخراج سريع للنصوص أثناء التطوير دون مغادرة الطرفية.

الأسئلة الشائعة

هل يمكنني استخراج نصوص فيديوهات YouTube من سطر الأوامر؟+

نعم. استخدم curl مع YouTubeTranscript.dev API لاستخراج النصوص بأمر واحد. ويمكنك أيضًا استخدام حزمة NPM أو Python SDK الخاصة بنا لسير عمل أكثر تعقيدًا في سطر الأوامر.

هل أحتاج إلى مفتاح API لاستخدام سطر الأوامر؟+

نعم. احصل على مفتاح API من إعدادات حسابك في YouTubeTranscript.dev، وأضفه في الترويسة x-api-key ضمن طلبات curl.

هل يمكنني معالجة عدة فيديوهات من ملف؟+

نعم. ضع روابط الفيديوهات في ملف نصي (رابط في كل سطر)، واستخدم xargs أو حلقة تكرار بسيطة لمعالجتها جميعًا. تتعامل API الخاصة بنا مع الطلبات المتزامنة ضمن حدود الطلبات في خطتك.

ما صيغ المخرجات التي يدعمها سطر الأوامر؟+

تُعيد API استجابة JSON افتراضيًا، ويمكنك معالجتها باستخدام jq. كما يمكنك طلب صيغ محددة (نص، SRT، VTT) عبر المعامل format.

ابدأ الاستخراج من الطرفية

أول نص لك على بُعد أمر curl واحد.

احصل على مفتاح API ←