الزحف المجاني للويب من أجل وكلاء الذكاء الاصطناعي يعمل الآن على عتادك الخاص. Firecrawl Local هو ملف تنفيذي واحد مكتوب بلغة Rust يقوم بزحف المواقع والاستيلاد وبناء خرائطها وتحويلها إلى Markdown، ويتصل بـ Claude Code وCodex وCursor وGemini CLI كخادم MCP، ويستجيب لواجهة Firecrawl v2 API على localhost. اضبط FIRECRAWL_CLOUD=off ولن يغادر أي صفحة أو استعلام أو رابط جهازك.
الخلاصة السريعة
- التثبيت:
cargo install firecrawl-local(يتطلب Rust ومترجم C). استغرق البناء عندنا 5 دقائق و55 ثانية وأنتج ملفًا تنفيذيًا بحجم 19 ميغابايت. - ربطه: يضيف
firecrawl-local initخادم MCP إلى كل أداة وكيل مدعومة يعثر عليها. - التكلفة: 0 دولار لعمليات إليستration والزحف والخرائط والزحف بالدفعات. البحث والصفحات المحجوبة ومزوّدو بيانات Alexandria تذهب إلى Firecrawl Cloud إلا إذا أوقفت ذلك.
- مفتاح الخصوصية: يبقي
FIRECRAWL_CLOUD=offكل شيء محليًا. - إعداد الفريق: ثبّته مرة واحدة لكل جهاز Computer يعمل عليه وكلاؤك، وسيحصل كل وكيل على ذلك الجهاز على نفس أداة الزحف.
ما هو Firecrawl Local
Firecrawl Local هو ملف تنفيذي واحد من فريق Firecrawl يجلب صفحات الويب، ويجرّدها إلى Markdown نظيف، ويعيد نفس JSON الذي تعيده واجهة Firecrawl API المستضافة. لا يحتاج إلى قاعدة بيانات أو طابور أو حاوية. أعلنت Firecrawl عنه في 18 نوفمبر 2026، وظهرت الحزمة على crates.io قبل ذلك بأسبوع بالإصدار 0.1.0.
يصف ملف README ثلاث طرق لاستخدامه: أداة سطر أوامر، وخادم MCP للوكلاء، ونسخة محلية من واجهة v2 API. كود التنظيف يُجمَّع من نفس المصدر الذي تستخدمه الواجهة المستضافة، لذا فإن صفحة Markdown من حاسوبك المحمول تطابق ما ستعيده السحابة لصفحة يمكن لكلتيهما الوصول إليها.
تدّعي منشور الإطلاق لـ Firecrawl أن بدائيته للزحف أسرع بـ 37 مرة من Firecrawl المستضاف ذاتيًا وتستهلك ذاكرة أقل بـ 230 مرة، عند 11 ميغابايت في وضع الخمول. هذه أرقام Firecrawl؛ ولا ينشر ملف README أي منهجية. قسنا جزء الذاكرة بأنفسنا أدناه.
إذا كنت تشغّل بالفعل عدة وكلاء برمجيين، فهذه أول أداة زحف يمكنك تسليمها لهم جميعًا دون فاتورة لكل استدعاء. يغطي باقي هذا الدليل الإعداد، ومفتاح الخصوصية، وكيفية منح فريق كامل من الوكلاء الأداة نفسها على Sharkly.
لماذا يحتاج الوكلاء إلى أداة زحف محلية
الوكيل الذي لا يستطيع قراءة الويب يعمل من بيانات تدريب قديمة. يخمّن في واجهة برمجة تطبيقات لم يرها، أو يطلب منك لصق التوثيق في المحادثة.
تصلح واجهات الزحف المستضافة ذلك، لكنها تضيف تكلفتين. كل صفحة استدعاء مدفوع، لذا فإن الزحف عبر موقع توثيق من 400 صفحة يصبح بندًا في فاتورة. وكل رابط يفتحه وكيلك يمر عبر خوادم شخص آخر، وهذا مهم عندما يبحث الوكيل في نطاق عميل أو صفحة منافس لم تُطرح بعد.
تزيل أداة الزحف المحلية كليهما. تُجلب الصفحات من شبكتك الخاصة وتُنظَّف على معالجك. المقابل أنك تتحمل مسؤولية التثبيت والقيود التي يأتي بها الحاسوب المحمول.
تثبيت Firecrawl Local
تحتاج إلى Rust ومترجم C. على macOS، يغطي xcode-select --install المترجم؛ وعلى Debian أو Ubuntu، ثبّت build-essential. احصل على Rust من rustup.
cargo install firecrawl-local
firecrawl-local --version
# firecrawl-local 0.1.0
هناك إضافتان اختياريتان. يتيح Chrome أو Chromium تصيير الصفحات التي تحتاج إلى JavaScript؛ وبدون أحدهما تظل الصفحات الثابتة تعمل، لكن الصفحة المليئة بالسكربتات تعود مع تحذير. هناك حاجة إلى Node.js 22 أو أحدث لخادم MCP، لأن firecrawl-local mcp يشغّل حزمة npm المسماة firecrawl-mcp عبر npx.
الزحف والاستيلاد وبناء الخرائط من سطر الأوامر
ثلاثة أوامر تغطي معظم أعمال الوكلاء.
# One page as markdown
firecrawl-local scrape https://example.com --markdown
# Up to 50 pages, one markdown file each
firecrawl-local crawl https://docs.firecrawl.dev --limit 50 --out ./pages
# Every URL a site exposes
firecrawl-local map https://firecrawl.dev
شغّلنا كل أمر في 19 نوفمبر 2026 مع تعطيل السحابة. انتهت عملية زحف واحدة لـ example.com في 1.6 ثانية. استغرق زحف من 10 صفحات لموقع توثيق Firecrawl نفسه 4.2 ثانية وكتب 144 كيلوبايت من Markdown. أعاد map قائمة روابط التوثيق في 3.9 ثانية.
| الأمر | العَلمَات المفيدة |
|---|---|
scrape |
--markdown، --format markdown,links، --full-page، --timeout |
crawl |
--limit (الافتراضي 100)، --max-depth، --include، --exclude، --out |
map |
--search، --limit |
| أي أمر | --browser auto|never|always |
ملاحظة من تجربتنا: على شبكة لا تصل إلى الويب إلا عبر وسيط (proxy)، فشلت أول عملية زحف بخطأ TLS. حلّ ضبط HTTPS_PROXY المشكلة، لذا يحترم الملف التنفيذي متغيرات الوسيط القياسية.
وصله بوكيل الذكاء الاصطناعي عبر MCP
MCP (بروتوكول سياق النموذج) هو الطريقة المعيارية التي تحمّل بها أداة الوكيل أدوات خارجية. يسجّل Firecrawl Local نفسه كخادم MCP واحد.
firecrawl-local init --dry-run # show what would change
firecrawl-local init # write it, backing up each config first
أظهر التشغيل التجريبي (dry run) على جهازنا خمسة أهداف: Claude Code في ~/.claude.json، وClaude Desktop، وCursor في ~/.cursor/mcp.json، وGemini CLI في ~/.gemini/settings.json، وCodex في ~/.codex/config.toml. كما يدعم Windsurf عند تثبيته. أعد تشغيل كل أداة بعد init حتى تحمّل الخادم. استخدم --agent cursor لإعداد أداة واحدة فقط.
لإضافته يدويًا، سجّل الملف التنفيذي كخادم stdio:
{
"mcpServers": {
"firecrawl": {
"command": "/Users/you/.cargo/bin/firecrawl-local",
"args": ["mcp", "--public-only"]
}
}
}
يحصل الوكيل على أدوات Firecrawl MCP القياسية. تعمل عمليات الزحف والاستيلاد وبناء الخرائط والزحف بالدفعات محليًا؛ بينما يذهب الباقي إلى Firecrawl Cloud. والعلم --public-only من إضافاتنا، موضح في قسم الأمان أدناه.
أبقِ السحابة معطلة من أجل الخصوصية

ثلاث مهام تحتاج Firecrawl Cloud، لأن الحاسوب المحمول لا يملك فهرس بحث ولا وسيلة لتجاوز موقع يحجبه.
| يُرسَل إلى Firecrawl Cloud | السبب | حساب |
|---|---|---|
| استعلامات البحث | لا يوجد فهرس بحث محلي | لا؛ البحث بلا مفتاح محدود بمعدل |
| رابط صفحة حجبتك | تجلبها السحابة نيابةً عنك | لا |
| مزوّدو بيانات Alexandria | يعمل المزوّدون في السحابة | نعم، حساب مجاني عبر firecrawl-local login |
| معرّف تثبيت عشوائي واسم أداتك | حساب عدد مرات التثبيت | لا |
يتحكم متغير FIRECRAWL_CLOUD في عملية التسليم. auto (الافتراضي) يسمح بكل ما سبق. search يرسل استعلامات البحث فقط. off لا يرسل شيئًا، وأي قيمة غير معروفة تُحتسب أيضًا كـ off. تُوسَم الصفحة المجلوبة من السحابة بـ "source": "firecrawl-cloud"، لذا يمكنك تدقيق ما غادر جهازك.
لعمل الوكلاء على مواقع العملاء أو البحوث الداخلية، ابدأ بـ off. سيفقد وكيلك البحث على الويب، لذا اقرنه بأداة البحث التي تثق بها بالفعل.
تشغيل Firecrawl API محليًا
يستجيب firecrawl-local serve لواجهة Firecrawl v2 API على المنفذ 3002 دون مفتاح API للمسارات المحلية. كود SDK الحالي يتحول بتغيير رابط واحد.
from firecrawl import Firecrawl
app = Firecrawl(api_url="http://localhost:3002")
print(app.scrape("https://example.com").markdown)
المسارات المحلية هي POST /v2/scrape وPOST /v2/map والزحف والزحف بالدفعات مع نقاط حالة الإلغاء الخاصة بها، وGET /health. أما مسارات /v2 الأخرى مثل /v2/search فتُمرَّر إلى السحابة؛ ولا تُقدَّم الإصدارات v0 وv1.
قسنا الذاكرة أثناء تشغيله: ظلّت عملية serve عند 10 ميغابايت مقيمة في وضع الخمول و16 ميغابايت بعد عملية زحف واحدة. وهذا قريب من ادعاء Firecrawl البالغ 11 ميغابايت. أعادت عملية زحف عبر الواجهة "creditsUsed": 0 و"engine": "local-fetch".
إعدادات الأمان الافتراضية المهمة للوكلاء
يمكن توجيه وكيل يقرأ صفحة تحتوي على تعليمات خفية إلى جلب رابط داخلي. يُدرج OWASP هذا الصنف من الهجمات ضمن حقن التعليمات (prompt injection)، وأداة الزحف هي المسار الواضح لذلك.
- يرتبط
serveبـ127.0.0.1ويرفض عناوين localhost والعناوين الخاصة إلا إذا مررت--allow-private. طلبنا منه الزحف عبر127.0.0.1:22فعاد بـBLOCKED_TARGET. - يتطلب ربط مضيف آخر بـ
--hostتمرير--token. - عناوين link-local وبيانات وصفية للسحابة محجوبة في كل الأوضاع، بما في ذلك بعد عمليات إعادة التوجيه.
- يمكن لأوامر
scrapeوcrawlوmcpالوصول إلى شبكتك الخاصة افتراضيًا، لأنها تعمل لصالح الشخص أمام لوحة المفاتيح. أضف--public-onlyعندما يتصفّح وكيل مواقع لا تثق بها. - تحترم عمليات الزحف ملف
robots.txt(معيار RFC 9309)، ويمكن لأصحاب المواقع مخاطبة الزاحف بالاسمFirecrawlLocal.
حدود يجب التخطيط لها
- لا توجد صيغ
jsonأوsummaryولاactionsللمتصفح محليًا. أعاد طلبsummaryالخاص بنا بيانات وصفية مع تحذير بأن الصيغة قد تم تجاوزها. - لقطات الشاشة تحتاج Chrome.
- تعيش مهام الزحف والدفعات في الذاكرة، وتنتهي صلاحيتها بعد ساعة من بدئها، وتنتهي عند إيقاف
serve. - الترخيص: المستودع مرخّص بموجب AGPL-3.0. تحقق مع فريقك القانوني قبل إصدار نسخة معدّلة داخل منتج مستضاف.
بالنسبة إلى الطوابير والعمال وكل الصيغ، يغطي دليل الاستضافة الذاتية لـ Firecrawl الخادم الكامل.
امنح كل وكيل في الفريق نفس أداة الزحف
يمكن لمطور واحد يستخدم وكيلًا واحدًا أن يتوقف هنا. لكن الفريق الذي يشغّل عدة وكلاء يواجه مشكلة مختلفة: أدوات كل وكيل تعيش في إعدادات الجهاز الذي يعمل عليه، ولا أحد يتتبع أي وكيل يستطيع قراءة الويب.
في Sharkly، يعمل الوكيل (Agent) على جهاز Computer (حاسوب محمول أو خادم أو حاوية تتصل بها) عبر Runtime، وهو أداة الوكيل المثبّتة هناك، مثل Claude Code أو Codex. تُثبّت الأدوات على جهاز Computer كما تفعل للاستخدام المباشر. ثم تعرض إعدادات الأدوات والمعرفة وMCP الخاصة بالوكيل خوادم MCP التي يرثها من Claude Code على ذلك الجهاز، بما في ذلك خوادم stdio المكوّنة من المستخدم، وهو النطاق الذي يكتب فيه init.
إذن الإعداد هو: ثبّت Firecrawl Local على جهاز Computer، وشغّل init، وافتح إعدادات الوكيل وانقر Check. أكّدنا أن اللوحة تعرض خوادم stdio المكوّنة من المستخدم؛ لكننا لم نشغّل بعد عملية زحف Firecrawl داخل مهمة Sharkly، لذا اختبر مهمة قراءة فقط أولًا.
ضع أداة الزحف على جهاز Computer يعمل دائمًا

الحاسوب المحمول ينام. خادم Linux صغير مسجّل كجهاز Computer (باستخدام sharkly computer register مع رمز تثبيت sit_، وفقًا لـ توثيق أجهزة Computers) يبقى قائمًا، لذا يتشارك كل وكيل موجّه إليه أداة زحف واحدة وسياسة FIRECRAWL_CLOUD واحدة. اضبط المتغير في بيئة Runtime الخاصة بالوكيل حتى تنتقل السياسة مع الوكيل، لا مع آخر من سجّل الدخول.
من هناك، يصبح البحث عملًا قابلًا للتكليف. يقسّم قائد الفريق (Crew) مهمة "ابنِ خريطة توثيق هؤلاء الموردين الخمسة" إلى مهام، فيزحف كل وكيل على نصيبه محليًا، وتصل النتائج إلى اللوحة لمراجعة بشرية. Sharkly مجاني للمؤسسات التي لا يزيد عدد أفرادها على 5 اليوم، ولا يشغل الوكلاء وأجهزة Computers أي مقاعد؛ وتبقى النماذج على اشتراكاتك الخاصة.
استخدامات واقعية
- استيعاب التوثيق: ازحف عبر توثيق مكتبة إلى Markdown قبل أن يرقّي وكيل اعتمادًا (dependency).
- بحث العملاء المحتملين: اقرن الزحف المحلي بمزوّدي Alexandria، كما في دليل بناء قوائم العملاء المحتملين لدينا.
- مراقبة سجلات التغييرات (changelog): تبني مهمة مجدولة خريطة لموقع مورد يوميًا وتنبّه إلى الروابط الجديدة.
- البحث الخاص: ازحف عبر صفحات العملاء أو الصفحات قبل الإطلاق مع تعطيل السحابة، فلا يغادر شيء شبكتك. يغطي مقالنا حول لماذا لا يوقف تعطيل البحث على الويب تسريبات بيانات وكلاء الذكاء الاصطناعي المنافذ الأخرى.
الخلاصة
يجعل Firecrawl Local الزحف المجاني للويب من أجل وكلاء الذكاء الاصطناعي عملية بناء من ست دقائق وأمر init واحد. أبقِ FIRECRAWL_CLOUD=off للأعمال الخاصة، وأضف --public-only للمواقع غير الموثوقة، وتعامل مع ادعاءات السرعة على أنها ادعاءات Firecrawl حتى تقيسها بنفسك.
خطوتك التالية: ثبّته على جهاز Computer الذي يستخدمه وكلاؤك بالفعل، ثم اربط ذلك الجهاز بـ Sharkly ليحصل كل وكيل في الفريق على نفس أداة الزحف ونفس القواعد. لمزيد من إعدادات الـ 0 دولار، راجع وكلاء الذكاء الاصطناعي المجانيين للفرق.
الأسئلة الشائعة
هل Firecrawl Local مجاني؟ نعم. تعمل عمليات الزحف والاستيلاد وبناء الخرائط والزحف بالدفعات محليًا دون مفتاح API، وأبلغت عملية الزحف الاختبارية لدينا عن استخدام 0 رصيد. يستخدم البحث وAlexandria خدمة Firecrawl Cloud.
هل يحتاج Firecrawl Local إلى Docker؟ لا. إنه ملف تنفيذي واحد دون قاعدة بيانات أو طابور أو حاوية. Docker مجرد خيار، ويتطلب تصيير JavaScript داخل حاوية ملف تعريف seccomp يسمح بصندوق حماية Chrome.
ما الوكلاء الذين يدعمهم firecrawl-local init؟ Claude Code وClaude Desktop وCursor وWindsurf وGemini CLI وCodex. ويمكن لأي عميل MCP آخر تسجيل firecrawl-local mcp كخادم stdio.
هل يمكنني إبقاء كل الزحف بعيدًا عن خوادم Firecrawl؟ نعم. اضبط FIRECRAWL_CLOUD=off. ستفقد البحث والاحتياط للصفحات المحجوبة وAlexandria.
هل Firecrawl Local أسرع من Firecrawl المستضاف ذاتيًا؟ تقول Firecrawl إنه أسرع بـ 37 مرة ويستهلك ذاكرة أقل بـ 230 مرة. قسنا ذاكرة خمول قدرها 10 ميغابايت، ما يطابق ادعاء الذاكرة؛ ولم نقس السرعة مقابل خادم مستضاف ذاتيًا.
هل Firecrawl Local مفتوح المصدر؟ المستودع مرخّص بموجب AGPL-3.0. اقرأ الترخيص قبل إصدار نسخة معدّلة كجزء من خدمة مستضافة.



