Agent Bridge

نظرة عامة

يتيح Agent Bridge لوكلاء AI (Claude Code وCursor وCowork وغيرها) التحكم عن بُعد في إضافة Web2MD لـ Chrome لتحويل مجموعة روابط دفعة واحدة — خصوصًا صفحات Reddit، والصفحات المُعالَجة بـ JS، والصفحات المحمية بتسجيل الدخول التي تمنع الوصول عبر API من جانب الخادم. بدلًا من استدعاء Web2MD API (الذي يحظره Reddit)، يرسل وكيل AI أوامر إلى إضافة Chrome المحلية لديك عبر Native Messaging. تفتح الإضافة كل صفحة في تبويب خلفي باستخدام جلسة المتصفح الحقيقية الخاصة بك — بملفات تعريف الارتباط (cookies) وحالة تسجيل الدخول — وتستخرج المحتوى، وتحوّله إلى Markdown، وتُرجع النتيجة.

يتطلب Agent Bridge خطة PRO ومضيف المراسلة الأصلية (native messaging host) مثبتًا على جهازك. يجب أن تكون الإضافة مفتوحة في Chrome.

البنية المعمارية

AI Agent ←MCP/stdio→ MCP Server ←TCP:12315→ Native Host ←NM→ Chrome Extension → Any Website

المكوّن	الدور
وكيل AI	Claude Code، Cursor، Cowork — يستدعي أدوات MCP
خادم MCP	يترجم استدعاءات أدوات MCP إلى رسائل TCP
المضيف الأصلي (Native Host)	ينقل البيانات بين TCP وChrome Native Messaging
إضافة Chrome	تفتح التبويبات، وتستخرج HTML، وتحوّله إلى Markdown

كل الاتصال محلي — لا شيء يغادر جهازك. يستمع المضيف الأصلي على localhost:12315 فقط.

الإعداد

الخطوة 1: بناء خادم MCP

cd packages/mcp-server
pnpm build

الخطوة 2: تثبيت مضيف المراسلة الأصلية

cd packages/mcp-server
./install.sh <your-extension-id>

اعثر على معرّف الإضافة (Extension ID) الخاص بك في chrome://extensions مع تفعيل وضع المطوّر (Developer Mode). ابحث عن Web2MD وانسخ سلسلة المعرّف (مثل ijmgpkkfgpijifldbjafjiapehppcbcn).

بعد التثبيت، يجب عليك إغلاق Chrome بالكامل (Cmd+Q على Mac) وإعادة فتحه. يقرأ Chrome ملفات manifest الخاصة بـ Native Messaging عند بدء التشغيل فقط — إعادة تحميل الإضافة وحدها لا تكفي.

يقوم سكريبت التثبيت بما يلي:

نسخ ملفات المضيف إلى ~/.web2md/ (لتجنب قيود macOS TCC على ~/Desktop)
تحديد المسار المطلق لـ node (يُطلق Chrome بمتغير PATH محدود)
كتابة ملف manifest الخاص بـ NM في مجلد NativeMessagingHosts التابع لـ Chrome

الخطوة 3: إعداد MCP

Claude Code
Cursor
Claude Desktop

أضف إلى ~/.claude/settings.json:

{
  "mcpServers": {
    "web2md-agent": {
      "command": "node",
      "args": ["/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "WEB2MD_API_KEY": "w2m_your_key_here"
      }
    }
  }
}

أضف إلى ~/.cursor/mcp.json:

{
  "mcpServers": {
    "web2md-agent": {
      "command": "node",
      "args": ["/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "WEB2MD_API_KEY": "w2m_your_key_here"
      }
    }
  }
}

أضف إلى إعدادات Claude Desktop الخاصة بك:

{
  "mcpServers": {
    "web2md-agent": {
      "command": "node",
      "args": ["/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "WEB2MD_API_KEY": "w2m_your_key_here"
      }
    }
  }
}

الخطوة 4: التحقق

في Chrome، افتح chrome://extensions ← انقر على رابط “Service Worker” الخاص بـ Web2MD ← تحقق من وحدة التحكم (Console):

[Web2MD] Service worker started
[Web2MD] Connected to native host
[Web2MD] Native host TCP relay ready on port 12315

إذا رأيت هذه الأسطر الثلاثة، فإن Agent Bridge يعمل.

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

يوفر Agent Bridge ثلاث أدوات MCP — اختر بناءً على النقل واحتياجات الدفعات. الأدوات الثلاث موثّقة بالكامل في صفحة خادم MCP؛ هذه مقارنة سريعة.

الأداة	النقل	الدفعات
`bridge_convert_url`	HTTP (تجلب الإضافة HTML، ويحوّله الخادم)	رابط واحد
`agent_convert`	Native messaging (بنية هذه الصفحة)	رابط واحد، مع معامل `skill` اختياري
`agent_batch_convert`	Native messaging	حتى 50 رابطًا، بالتتابع

agent_convert

تحويل رابط واحد باستخدام إضافة Chrome عبر Native Messaging.

المعامل	النوع	الوصف
`url`	string	الرابط المراد تحويله
`skill`	string (اختياري)	معرّف أو اسم Skill — يُلحَق محتواها بـ Markdown المُرجَع

يُرجع: محتوى Markdown مع العنوان والرابط المصدر وعدد الكلمات وزمن القراءة. الأنسب لـ: خيوط Reddit، الصفحات المحمية بتسجيل الدخول، المواقع المُعالَجة بـ JS.

agent_batch_convert

تحويل ما يصل إلى 50 رابطًا دفعة واحدة. تُعالَج الروابط بالتتابع — تفتح الإضافة كل صفحة في تبويب خلفي، وتستخرج المحتوى، وتغلق التبويب، ثم تنتقل إلى التالي.

المعامل	النوع	الوصف
`urls`	string[]	مصفوفة من الروابط المراد تحويلها (بحد أقصى 50)

يُرجع: نتائج كل رابط تُبَث فور اكتمالها، بالإضافة إلى ملخص. الأنسب لـ: سير عمل البحث — تحويل خيوط Reddit ومناقشات HN أو صفحات المنافسين دفعة واحدة لتحليل AI.

bridge_convert_url

تحويل رابط واحد عن طريق جلب HTML الخاص به عبر الإضافة باستخدام جسر HTTP محلي (بدلاً من Native Messaging)، ثم التحويل على جانب الخادم. مشابه وظيفيًا لـ agent_convert للتحويلات الفردية، لكنه لا يتطلب تثبيت مضيف المراسلة الأصلية — تحتاج فقط إلى تثبيت الإضافة وتشغيلها.

المعامل	النوع	الوصف
`url`	string	الرابط المراد تحويله
`extensionId`	string (اختياري)	تجاوز معرّف الإضافة (يُكتشَف تلقائيًا من مفتاح API الخاص بك إن لم يُحدَّد)

تُحفظ جميع التحويلات الناجحة تلقائيًا في سجل لوحة التحكم، مع ملخصات ووسوم مُولَّدة بواسطة AI.

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

تحويل خيط Reddit

أنت: حوّل خيط Reddit هذا إلى Markdown: https://www.reddit.com/r/LangChain/comments/1siwh6q/…الوكيل: (يستدعي agent_convert) إليك الخيط المحوَّل مع 7 تعليقات تناقش دقة RAG للمستندات القانونية…

تحويل دفعي لأغراض البحث

أنت: حوّل روابط Reddit الخمسة هذه دفعة واحدة ولخّص أهم النقاط:

الوكيل: (يستدعي agent_batch_convert) تم تحويل 5 من أصل 5 روابط بنجاح. إليك أهم النقاط…

تحويل صفحات محمية بتسجيل الدخول

أنت: حوّل صفحة الويكي الداخلية لشركتي على https://wiki.internal.com/architectureالوكيل: (يستدعي agent_convert) بما أنك مسجّل الدخول إلى هذا الموقع في Chrome، تمكّنت من استخراج المحتوى الكامل…

المواقع المدعومة

يستخدم Agent Bridge نفس أدوات الاستخراج الـ 27 الخاصة بمواقع محددة التي تستخدمها الإضافة — كل واحدة منها تعرف كيفية سحب محتوى نظيف من DOM أو API الخاص بالموقع بدلاً من الرجوع إلى HTML الخام للصفحة.

التواصل الاجتماعي والنقاش (7)

Reddit · Hacker News · Twitter/X · Quora · Xiaohongshu (小红书) · Zhihu (知乎) · Instagram

تصدير محادثات AI (2)

محادثات Claude · منصات دردشة AI أخرى (ChatGPT، Gemini، إلخ. عبر مستخرج DOM مشترك)

التوثيق وقواعد المعرفة (6)

Wikipedia · arXiv · OpenAI Docs · مواقع التوثيق المبنية على Mintlify · Notion · Google Docs

التطوير والبرمجة (3)

GitHub Issues/PRs · Stack Overflow · dev.to

النشر (3)

Medium · Substack · Product Hunt

منصات CJK (4)

WeChat (微信公众号) · Bilibili (哔哩哔哩) · Feishu (飞书) — بالإضافة إلى Xiaohongshu وZhihu أعلاه. يُصنّف الكود هذه الفئة بأكملها كأعلى مجموعة مستخرجات تمايزًا — منافسون قليلون يتعاملون مع هذه المنصات على الإطلاق.

الفيديو والوسائط (1)

YouTube (استخراج النص المكتوب/transcript)

العمل والإنتاجية (5)

Gmail · LinkedIn · Amazon (صفحات المنتجات) · Canvas LMS · منتديات XenForo

أي رابط بدون مستخرج مخصص يرجع إلى استخراج HTML للصفحة الكاملة — لا يزال يعمل، لكن دون التنظيف الخاص بالموقع (إزالة عناصر التنقل، والإعلانات، وأدوات التعليقات، إلخ) الذي تطبّقه المستخرجات المتخصصة. المواقع التي تعرض API عامًا (Reddit، Hacker News، GitHub، Stack Overflow) تُجلَب عبر ذلك الـ API عند الإمكان — أسرع وأكثر موثوقية من فتح تبويب خلفي. كل شيء آخر يفتح الصفحة في تبويب خلفي ويستخرج من DOM المُصيَّر.

استكشاف الأخطاء وإصلاحها

'Native host not installed' أو 'not found'

لم يُحمّل Chrome ملف manifest الخاص بـ NM. أغلق Chrome بالكامل (Cmd+Q) وأعد فتحه. مجرد إعادة تحميل الإضافة لا تكفي.

ظهور 'Native host has exited' فورًا

لا يستطيع Chrome تنفيذ سكريبت المضيف. الأسباب الشائعة:

عدم العثور على node — أعد تشغيل ./install.sh الذي يستخدم المسار المطلق لـ node
المضيف موجود في مجلد محمي بـ TCC (~/Desktop، ~/Documents) — أعد تشغيل التثبيت لنقله إلى ~/.web2md/

'Agent connection error' من MCP

خادم TCP الخاص بالمضيف الأصلي لا يعمل. تأكد من:

أن Chrome مفتوح
أن إضافة Web2MD مُحمَّلة
أن وحدة تحكم Service Worker تُظهر “TCP relay ready on port 12315”

'Failed to extract content from the page'

الإضافة غير مسجّلة الدخول. افتح نافذة Web2MD المنبثقة في Chrome وسجّل الدخول إلى حسابك PRO.

'Tab load timeout'

الصفحة الهدف تستغرق وقتًا طويلًا للتحميل. هذا طبيعي للمواقع البطيئة. تنتظر الإضافة حتى 15 ثانية لكل تبويب. يستخدم Reddit أداة استخراج JSON API ولا يحتاج إلى تبويب، لذا فإن انتهاء المهلة على Reddit يعني عادةً أن رابط المنشور غير صالح (404).

عدم ظهور التحويلات في سجل لوحة التحكم

يتطلب حفظ السجل أن تكون الإضافة مسجّلة الدخول بحساب PRO. عملية الحفظ من نوع “أرسل ولا تنتظر” (fire-and-forget) — إذا فشل استدعاء API بصمت، لن تظهر التحويلات. تحقق من أن رمز المصادقة (auth token) الخاص بك صالح.

الفرق بينه وبين خادم MCP

الميزة	`convert_url`	`bridge_convert_url`	`agent_convert` / `agent_batch_convert`
مكان التشغيل	استدعاء API من جانب الخادم	تجلب الإضافة HTML، ويحوّله الخادم	متصفح Chrome المحلي لديك (native messaging)
دعم Reddit	❌ محظور من قِبل Reddit	✅ يستخدم جلسة متصفح حقيقية	✅ يستخدم جلسة متصفح حقيقية
الصفحات المحمية بتسجيل الدخول	❌ لا يوجد وصول	✅ يستخدم ملفات تعريف الارتباط الخاصة بك	✅ يستخدم ملفات تعريف الارتباط الخاصة بك
الصفحات المُعالَجة بـ JS	❌ لا يوجد JavaScript	✅ عرض Chrome الكامل	✅ عرض Chrome الكامل
الإعداد المطلوب	مفتاح API فقط	تثبيت الإضافة وتشغيلها	تثبيت الإضافة ومضيف Native Messaging
الدفعات	—	رابط واحد فقط	حتى 50 رابطًا (`agent_batch_convert`)
يتطلب فتح Chrome	لا	نعم	نعم

قاعدة عامة: استخدم convert_url للصفحات العامة. استخدم bridge_convert_url عندما تريد جلسة متصفح الإضافة لكن دون تثبيت مضيف Native Messaging. استخدم agent_convert / agent_batch_convert لـ Reddit، والصفحات المُصادَق عليها، والمواقع كثيفة الاستخدام لـ JS، أو عندما تحتاج إلى معالجة دفعية — أو تريد تطبيق Skill عبر معامل skill في agent_convert.

البدء

الميزات الأساسية

متقدم

الخطط

نظرة عامة

البنية المعمارية

الإعداد

الخطوة 1: بناء خادم MCP

الخطوة 2: تثبيت مضيف المراسلة الأصلية

الخطوة 3: إعداد MCP

الخطوة 4: التحقق

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

agent_convert

agent_batch_convert

bridge_convert_url

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

المواقع المدعومة

استكشاف الأخطاء وإصلاحها

الفرق بينه وبين خادم MCP

​نظرة عامة

​البنية المعمارية

​الإعداد

​الخطوة 1: بناء خادم MCP

​الخطوة 2: تثبيت مضيف المراسلة الأصلية

​الخطوة 3: إعداد MCP

​الخطوة 4: التحقق

​الأدوات المتاحة

​agent_convert

​agent_batch_convert

​bridge_convert_url

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

​المواقع المدعومة

​استكشاف الأخطاء وإصلاحها

​الفرق بينه وبين خادم MCP

نظرة عامة

البنية المعمارية

الإعداد

الخطوة 1: بناء خادم MCP

الخطوة 2: تثبيت مضيف المراسلة الأصلية

الخطوة 3: إعداد MCP

الخطوة 4: التحقق

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

agent_convert

agent_batch_convert

bridge_convert_url

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

المواقع المدعومة

استكشاف الأخطاء وإصلاحها

الفرق بينه وبين خادم MCP