XHS-Downloader

نظرة عامة

XHS-Downloader (بواسطة JoeanAmier) هو أداة بايثون مفتوحة المصدر شهيرة مخصصة لمنصة شياوهونغشو (小红书، وتعرف أيضًا باسم REDnote أو XHS). تتفوق الأداة في استخراج الروابط، وجمع معلومات المنشورات، وتنزيل ملفات الوسائط عالية الجودة (صور، فيديوهات، Live Photos) بدون علامات مائية.

يدعم المشروع العمليات المجمعة لمنشورات المستخدمين، والمجموعات، والإعجابات، والألبومات، ونتائج البحث. المهم أيضًا، أنه يتضمن وضع خادم MCP (بروتوكول سياق النموذج) الأصلي، مما يسمح لوكلاء ومساعدات البرمجة الذكية (مثل Claude Desktop، Cursor، إلخ) بالتحكم مباشرةً في مهام التنزيل، الاستخراج، وجمع المحتوى.

الميزات الرئيسية

استخراج الروابط: استخراج روابط المنشورات المنشورة، والمفضلة، والإعجابات، والألبومات، ونتائج البحث، وروابط المستخدمين.

• جمع معلومات المنشورات: جمع البيانات الوصفية التفصيلية لمنشورات شياوهونغشو.

تنزيل بدون علامات مائية: تنزيل الصور والفيديوهات وصور Live Photos بجودة عالية.

العمليات المجمعة وإزالة التكرار: تخطي المنشورات التي تم تنزيلها مسبقًا تلقائيًا باستخدام قاعدة بيانات محلية.

وضع خادم MCP: التشغيل كخادم MCP (python main.py mcp) للتكامل مع الوكلاء الذكيين.

استئناف من نقطة التوقف والتسمية المخصصة: دعم التنزيل القابل للاستئناف وصيغ أسماء الملفات القابلة للتخصيص.

دعم API ونصوص المستخدم: يعمل مع نصوص مستخدم المتصفح لدفع المهام بنقرة واحدة.

أوضاع CLI + GUI: تشغيل البرنامج بسهولة أو تشغيل الكود المصدري.

كيفية عمله (وضع MCP)

1. قم بتشغيل خادم MCP:

   python main.py mcp
   

2. يستمع الخادم على الرابط http://127.0.0.1:5556/mcp/ (أو المنفذ المُكوَّن).
3. أضف خادم MCP إلى تكوين عميل الذكاء الاصطناعي الخاص بك.
4. يمكن للوكلاء الذكيين استدعاء الأدوات لاستخراج الروابط، أو جمع بيانات المنشورات، أو تشغيل التنزيلات مباشرةً.

هذا يجعل XHS-Downloader خلفية قوية لسير العمل الموجه بالوكلاء الذي يتضمن محتوى من شياوهونغشو.

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

الأرشفة المدعومة بالذكاء الاصطناعي: السماح للوكلاء الذكيين بجمع وتنزيل منشورات مستخدمين أو مواضيع محددة تلقائيًا.

التنزيل المجمع للوسائط: البحث، التجميع، أو النسخ الاحتياطي لمنشورات شياوهونغشو على نطاق واسع.

حفظ الوسائط بدون علامات مائية: الحصول على أصول نظيفة للاستخدام الشخصي، التعليمي، أو الإبداعي.

أنابيب جمع البيانات: التكامل مع أدوات MCP أخرى لأبحاث أو تحليل اتجاهات XHS.

نصوص التشغيل الآلي: الدمج مع نصوص مستخدم المتصفح لسير عمل سلس.

بدء الاستخدام

التشغيل السريع (مُوصى به)

• قم بتنزيل أحدث إصدار من إصدارات GitHub.
• قم بفك الضغط وشغّل الملف القابل للتنفيذ (main على Windows/macOS).

الكود المصدري + وضع MCP

git clone https://github.com/JoeanAmier/XHS-Downloader.git
cd XHS-Downloader
pip install -r requirements.txt
python main.py mcp   # بدء خادم MCP

للحصول على جميع الميزات بما في ذلك نصوص المستخدم واستخدام API، راجع ملف README.

الفوائد

يتميز XHS-Downloader بموثوقيته، وإزالة التكرارات، وقابلية استئناف التنزيلات، ودعم MCP المباشر — مما يجعله أحد أكثر الأدوات مفتوحة المصدر تقدمًا للتعامل مع محتوى Xiaohongshu. إنه يخدم كلاً من المستخدمين اليدويين ونظم بيئة وكلاء الذكاء الاصطناعي بشكل فعال بينما يبقى خفيف الوزن ويتم صيانته بنشاط.

ملاحظة: استخدمه بمسؤولية واحترم شروط خدمة Xiaohongshu وحقوق النشر.