بوت تحميل تليجرام — بوت تنزيل فيديوهات من فيسبوك ويوتيوب وإكس وتيك توك

بوت تليجرام لتحميل الوسائط مبني على Hono و grammY و Cloudflare Workers. أرسل رابطًا من أي من عشر منصات مدعومة داخل المحادثة ويعيد لك الملف — بلا تطبيق، بلا علامة مائية، وبلا تحويل إلى صفحات إعلانات.

البوت متاح على @download_media_4bot .

كيف تستخدم بوت التحميل

1. افتح @download_media_4bot في تليجرام واضغط «بدء».
2. ألصق رابطًا من تيك توك أو إنستغرام أو يوتيوب أو إكس أو فيسبوك أو ثريدز أو ساوند كلاود أو سبوتيفاي أو بنترست أو غيت هاب.
3. اختر الجودة عند السؤال — ويصلك الملف داخل المحادثة. بلا تطبيق وبلا تسجيل.

المنصات المدعومة

• تيك توك — فيديو بدون علامة مائية، صوت بجودة عالية، وعروض الصور
• إنستغرام — الريلز والفيديو والصور ومنشورات الكاروسيل، والستوري باسم المستخدم
• تويتر / إكس — فيديو وصور بدقة عالية، إضافة إلى المقالات الطويلة والسلاسل
• يوتيوب — فيديو HD/SD واستخراج الصوت MP3
• فيسبوك — فيديو HD/SD
• ثريدز — فيديو وصور
• ساوند كلاود — مقاطع صوتية بجودة عالية
• سبوتيفاي — معاينات صوتية وتحميل المقاطع
• بنترست — فيديو وصور بدقة عالية
• غيت هاب — أرشيفات المستودعات والمجلدات والملفات الخام المفردة

ما يفعله أبعد من جلب الملفات

• اختيار الجودة — لوحة أزرار للمنصات التي توفر أكثر من نسخة، حتى لا تعود روابط يوتيوب وفيسبوك بأسوأ جودة بصمت. لوحات اختيار الجودة (يوتيوب وتيك توك وفيسبوك) للمشرف فقط؛ والضيوف يحصلون على أفضل جودة تلقائيًا.
• يعمل على الحافة — شبكة Cloudflare العالمية تختصر زمن الاستجابة أينما كان المستخدم.
• إحصاءات — عدد التحميلات وتتبع لكل مستخدم عبر Cloudflare KV و Analytics Engine، تظهر للمشرف عبر /stats.
• ثنائي اللغة — يكتشف لغة حساب المستخدم في تليجرام ويبدل بين العربية والإنجليزية.
• بوابة اشتراك — تحقق اختياري من الاشتراك في قناة قبل السماح بالتحميل، يضبطه المشرف أثناء التشغيل، مع عدد تحميلات مجانية مسموحة قبل البوابة (/setfreeuses).
• إعداد ذاتي — تسجيل الـ webhook وإعداد البوت يجريان تلقائيًا بعد النشر؛ زيارة /setup مرة واحدة تكمل الإعداد.
• محتوى طويل — مقالات إكس والسلاسل الطويلة تُنشر على Telegraph للقراءة داخل تليجرام، وتُعاد كاملة بصيغة Markdown عبر API/MCP.
• API وخادم MCP — نفس أداة التحميل متاحة كواجهة REST وكخادم MCP لوكلاء الذكاء الاصطناعي (انظر أدناه).

التقنيات المستخدمة

Hono لطبقة HTTP داخل الـ Worker، و grammY لجانب تليجرام، و Cloudflare Workers للتنفيذ، و Workers KV للتخزين المؤقت والحالة، و Analytics Engine للمقاييس اللحظية. الاختبارات على Vitest، والمستودع يفرض صيغة conventional commits ويشغل فحوصات CodeQL وجودة الكود مع كل دفعة.

الأوامر

• /start — عرض المنصات المدعومة
• /help — طريقة الاستخدام
• /story — تحميل ستوري إنستغرام باسم المستخدم (يقبل @username أو الاسم مباشرة أو الرابط)
• /lang — تغيير لغة البوت
• /cancel — إلغاء الإجراء الحالي
• إرسال رابط — وهذا كل شيء؛ لا حاجة لأي أمر

أوامر المشرف (في محادثة المشرف فقط): /stats — إحصاءات الاستخدام؛ /logs — التحميلات الفاشلة الأخيرة؛ /setchannel — تحديد قناة الاشتراك المطلوبة؛ /setfreeuses — تحديد التحميلات المجانية المسموحة قبل البوابة؛ /block و /unblock — حظر مستخدم أو إلغاء حظره بالمعرّف؛ /allowlist — إدارة النطاقات المسموحة؛ /broadcast — إرسال رسالة لكل المستخدمين؛ /reply — الرد على مستخدم بالمعرّف؛ /footer — تحديد تذييل تعليق إنستغرام.

تشغيل نسختك الخاصة

تحتاج حساب Cloudflare مفعلًا عليه Workers، وتوكن بوت من @BotFather ، و Node.js مع pnpm.

git clone https://github.com/EngDawood/download-media.git
cd download-media
pnpm install

# ضع معرف تليجرام الرقمي في ADMIN_TELEGRAM_ID داخل wrangler.jsonc ثم:
pnpm exec wrangler secret put TELEGRAM_BOT_TOKEN
pnpm exec wrangler secret put TELEGRAM_WEBHOOK_SECRET
# اختياري — يفعّل API وخادم MCP أدناه؛ ويبقيان معطّلين (503) ما لم يُضبط:
pnpm exec wrangler secret put PUBLIC_API_KEY

pnpm deploy

ثم زُر https://your-worker-url/setup مرة واحدة لتسجيل الـ webhook. وأمر pnpm dev يشغله محليًا، و pnpm test يشغل اختبارات Vitest.

API وخادم MCP

نفس أداة التحميل متاحة خارج تليجرام بطريقتين، تشتركان في نفس خط المعالجة والتحقق وسياسة المحتوى. وكلتاهما معطّلة حتى يُضبط PUBLIC_API_KEY، وتعيدان روابط فقط — لا تمر أي بايتات ملفات عبر الـ Worker.

• واجهة REST — POST /api/download مع ترويسة X-API-Key وجسم JSON (الحقل url مطلوب؛ و mode اختياري: auto أو audio أو hd أو sd).
• خادم MCP — POST /mcp يتكلم بروتوكول MCP Streamable HTTP (بلا جلسات). التحقق عبر ترويسة X-API-Key أو Authorization: Bearer أو كآخر مقطع في المسار (/mcp/<key>) للعملاء الذين لا يستطيعون ضبط ترويسات. الأدوات: download_media و get_media_info و list_supported_platforms.

المرجع الكامل، بما فيه رموز الحالة ومعاني الأخطاء، في ملف `CLAUDE-API.md` .

أسئلة شائعة

هل بوت التحميل مجاني؟

نعم — أرسل الرابط ويصلك الملف، بلا تسجيل وبلا صفحات إعلانات.

ما المنصات التي يدعمها بوت التحميل؟

تيك توك، إنستغرام، إكس، يوتيوب، فيسبوك، ثريدز، ساوند كلاود، سبوتيفاي، بنترست، وغيت هاب — فيديو وصورًا وصوتًا، إضافة إلى أرشيفات المستودعات والملفات الخام من غيت هاب.

هل يحمّل فيديوهات تيك توك بدون علامة مائية؟

نعم، تعود فيديوهات تيك توك نظيفة وبصوت عالي الجودة.

هل أستطيع تحميل مستودع من غيت هاب؟

نعم — أرسل رابط مستودع أو مجلد أو ملف خام مفرد ويعيد لك البوت الأرشيف أو الملف.

هل أستطيع قراءة مقالات إكس والسلاسل كاملة؟

نعم — المحتوى الطويل من إكس يُنشر على Telegraph لتقرأه داخل تليجرام؛ والنص الكامل بصيغة Markdown متاح عبر API/MCP.

هل توجد واجهة API أو خادم MCP؟

نعم — نفس أداة التحميل متاحة كواجهة REST (POST /api/download) وكخادم MCP (POST /mcp) لوكلاء الذكاء الاصطناعي. وكلاهما يحتاج ضبط PUBLIC_API_KEY على الـ Worker؛ انظر قسم API وخادم MCP أعلاه.

كيف أحمّل من إكس (تويتر)؟

ألصق رابط التغريدة في البوت ويرجع لك الفيديو أو الصورة بدقة عالية.

كيف أنزّل فيديوهات فيسبوك؟

ألصق رابط الفيديو في البوت ويصلك بجودة HD أو SD حسب المتاح.

مشروع ذو صلة: تحميل خط ثمانية .