Skip to main content

نظرة عامة

يتيح لك CLI الخاص بـ Web2MD تحويل أي رابط إلى Markdown نظيف مباشرة من الطرفية (Terminal). مرّر المخرجات إلى نماذج LLM، أو عالج قوائم روابط دفعة واحدة، أو أدرج المحتوى في مخزن Obsidian الخاص بك — كل ذلك دون فتح متصفح.
يتطلب CLI إصدار Node.js 18 أو أحدث. شغّل node -v للتحقق من إصدارك.

التثبيت

لا حاجة لأي تثبيت — فقط شغّله باستخدام npx:
أو ثبّته عالميًا لبدء تشغيل أسرع:

أوضاع التشغيل

يعمل CLI الخاص بـ Web2MD بثلاثة أوضاع حسب إعداداتك:

محلي

الوضع الافتراضي. لا يتطلب مفتاح API. يجلب الصفحات ويحوّلها محليًا. يعمل مع معظم المواقع العامة.

خادم (Server)

مع مفتاح API. اضبط WEB2MD_API_KEY لفتح دعم Reddit وFandom/Wikia وغيرها من المواقع المقيَّدة التي تتطلب معالجة من جهة الخادم.

جسر (Bridge)

مع علامة --bridge. يستخدم إضافة Chrome لجلب الصفحات التي تُعرَض عبر JS أو المحمية بتسجيل دخول والتي لا يمكن للجلب الثابت الوصول إليها.

العلامات (Flags)

الأوامر

إلى جانب تحويل الروابط، يحتوي CLI على أمرين فرعيين للمصادقة ومزامنة المكتبة:

login

يبدأ تدفق تفويض عبر الجهاز (device authorization) قائم على المتصفح: يفتح CLI عنوان https://web2md.org ويعرض رمزًا للموافقة عليه. بمجرد الموافقة، يُحفظ مفتاح API الخاص بك في ~/.web2md/config.json — دون الحاجة لتصدير WEB2MD_API_KEY في كل صدفة (shell). يقرأ خادم MCP من نفس الملف، لذا فإن تسجيل الدخول هنا مرة واحدة يُصادق أيضًا استدعاءات أدوات MCP. هل تفضّل لصق مفتاح مباشرة بدلاً من تدفق المتصفح؟
يطلب هذا مفتاحًا (w2m_...) عبر الإدخال القياسي (stdin) ويحفظه بنفس الطريقة. احصل على مفتاح من لوحة التحكم.

sync

يزامن مكتبتك — كل صفحة قمت بحفظها عبر الإضافة أو لوحة التحكم أو API — إلى مجلد محلي كملفات Markdown مع بيانات وصفية أمامية (frontmatter)، منظّمة حسب الوسم. يتطلب تسجيل الدخول (أو ضبط WEB2MD_API_KEY). المزامنة تزايدية افتراضيًا: تتبع مؤشرًا في <dir>/.web2md-sync.json وتسحب فقط العناصر الجديدة في عمليات التشغيل اللاحقة. وجّه Obsidian (أو أي أداة تقرأ Markdown) نحو المجلد الهدف لتصفح مكتبتك كملاحظات.

متغيرات البيئة

أضف هذه المتغيرات إلى ملف تهيئة الصدفة الخاص بك (~/.zshrc أو ~/.bashrc) لتبقى ثابتة بين الجلسات:

أمثلة على الاستخدام

تحويل أساسي

يطبع Markdown إلى الإخراج القياسي (stdout).

التمرير إلى نموذج LLM

الحفظ في ملف

تضيف علامة --meta ترويسة YAML تتضمن العنوان، رابط المصدر، عدد الكلمات، عدد الرموز، وقت القراءة، والتاريخ.

المعالجة الدفعية من ملف

أنشئ ملفًا باسم urls.txt:
ثم شغّل:
يُحفظ كل رابط كملف .md منفصل داخل مجلد ./research.

الإدراج في مخزن Obsidian

يحفظ هذا كل صفحة في ~/Documents/MyVault/raw/ ويحدّث ~/Documents/MyVault/INDEX.md بروابط لجميع الصفحات المحوَّلة.

Reddit بمفتاح API

يتطلب Reddit مفتاح API صالحًا. بدونه، ستفشل روابط Reddit بسبب قيود Reddit المضادة للبوتات.

وضع Bridge

استخدم إضافة Chrome للتعامل مع الصفحات المعروضة عبر JS أو المحمية بتسجيل دخول:
يتطلب وضع Bridge تثبيت إضافة Web2MD لمتصفح Chrome وتشغيل Chrome. يتواصل CLI مع الإضافة عبر بروتوكول المراسلة الأصلي (native messaging) الخاص بـ Chrome.

إخراج JSON

يُرجع مخرجات منظَّمة:
مفيدة للاستهلاك البرمجي أو للتمرير إلى jq:

المواقع المُحسَّنة

يتضمن Web2MD محوّلات مدمجة لهذه المواقع، ما ينتج مخرجات أنظف من التحويل العام:
  • Wikipedia — استخراج نظيف للمقالات، ومعالجة صناديق المعلومات (infobox)
  • arXiv — ملخصات الأبحاث وبياناتها الوصفية
  • Hacker News — المواضيع مع التعليقات
  • GitHub — الـ Issues والـ Pull Requests
  • Stack Overflow — الأسئلة والأجوبة
  • dev.to — تدوينات المطورين
  • Medium — المقالات (يتجاوز معاينة الاشتراك المدفوع)
  • Substack — منشورات النشرات البريدية
  • OpenAI Docs — صفحات التوثيق
  • مواقع التوثيق المبنية على Mintlify — مواقع التوثيق المبنية على Mintlify
  • Reddit — المنشورات والتعليقات (يتطلب مفتاح API)

سير عمل شائعة

وجّه دليل سياق (context) وكيل الذكاء الاصطناعي الخاص بك إلى ./context للحصول على إجابات مبنية على مصادر موثوقة.
ينشئ مخزن أبحاث مفهرسًا وقابلًا للبحث في Obsidian.
يزيل الصور والروابط لتقليل استهلاك الرموز (tokens) عند التمرير إلى نماذج LLM.