Firecrawl Local هو ملف Rust تنفيذي واحد يقوم بكشط المواقع والزحف إليها ورسم خرائطها وتحويلها إلى Markdown نظيف على جهازك. تُثبّته عبر cargo install firecrawl-local، ويمكنه تقديم Firecrawl v2 API على localhost:3002 دون مفتاح API، ودون قاعدة بيانات، ودون طابور مهام، ودون حاوية. لا يزال البحث وبعض الميزات الأخرى تُوجَّه إلى Firecrawl Cloud، ويمكنك تعطيل ذلك.
فيما يلي: ما يعمل على حاسوبك المحمول، وما يُرسَل إلى السحابة، وكيفية تثبيته، ومسارات API التي يقدّمها، وحدوده، وكيفية تمكين وكيل البرمجة الخاص بك من اختبار API المحلي باستخدام Apidog CLI.
ما هو Firecrawl Local؟
Firecrawl Local هو النسخة مفتوحة المصدر التي تعمل على الجهاز من Firecrawl. إنه ملف تنفيذي واحد يجلب صفحات الويب، وينظّفها بنفس كود تنظيف HTML الذي يستخدمه Firecrawl API المستضاف، ثم يعيد Markdown أو HTML أو روابط. يعمل كـ CLI، أو كخادم MCP لوكلاء الذكاء الاصطناعي، أو كنسخة محلية من Firecrawl v2 API.
أعلنت Firecrawl عنه في 18 نوفمبر 2026 في منشور إطلاق على X، والكود موجود في مجلد apps/local في مستودع Firecrawl. الحزمة منشورة على crates.io باسم firecrawl-local، والمستودع مرخّص بموجب AGPL-3.0.
تزعم Firecrawl أنه أسرع بـ 37 ضعفًا من Firecrawl المستضاف ذاتيًا، ويستهلك ذاكرة أقل بـ 230 ضعفًا (11 ميجابايت في وضع الخمول). لا ينشر ملف README أي منهجية قياس، لذا تعامل مع هذه الأرقام كادعاءات من المورّد.
إذا كنت تعرف الـ API المستضاف أو Firecrawl CLI، فالفكرة بسيطة: نفس الاستدعاءات، يُجاب عنها على جهازك.
كيف يعمل Firecrawl Local: ملف تنفيذي واحد وعشر أوامر
كل ميزة تقع خلف أمر فرعي من firecrawl-local. إليك القائمة الكاملة من README:
| الأمر | ما يفعله | يعمل على |
|---|---|---|
scrape <urls...> |
كشط عنوان URL واحد أو أكثر | جهازك |
crawl <url> |
تتبّع الروابط من عنوان URL للبداية | جهازك |
map <url> |
سرد عناوين URL الخاصة بموقع من ملفات sitemap وصفحة البداية | جهازك |
serve |
تشغيل Firecrawl v2 API على localhost | جهازك |
mcp |
تشغيل خادم Firecrawl MCP عبر stdio | جهازك، وبعض الأدوات على السحابة |
init |
إضافة خادم MCP إلى أدوات الذكاء الاصطناعي على هذا الجهاز | جهازك |
search <query> |
البحث في الويب | Firecrawl Cloud |
find-tools <query> |
البحث عن موفّري بيانات Alexandria | Firecrawl Cloud، مع تسجيل الدخول |
data <provider> <capability> |
تشغيل موفّر بيانات Alexandria | Firecrawl Cloud، مع تسجيل الدخول |
login |
تسجيل الدخول إلى Firecrawl في المتصفح | Firecrawl Cloud |
ثلاثة أوامر تغطي معظم الاستخدام اليومي:
# Print one page as markdown
firecrawl-local scrape https://example.com --markdown
# Crawl up to 50 pages and save one markdown file per page
firecrawl-local crawl https://docs.firecrawl.dev --limit 50 --out ./pages
# List every URL on a site
firecrawl-local map https://firecrawl.dev
بدون --markdown، يطبع scrape استجابة JSON الخاصة بـ Firecrawl API. يقبل --format القيم markdown وhtml وrawHtml وlinks. تتم معالجة ملفات PDF ومستندات Office محليًا أيضًا.
بالنسبة لصفحات JavaScript، يشغّل Chrome أو Chromium الموجود لديك بالفعل. وبدونه، تعمل الصفحات الثابتة، وتعيد الصفحة التي تحتاج إلى متصفح تحذيرًا. يحدد --browser auto|never|always متى يُستخدم Chrome.
ما يعمل محليًا وما يعمل في Firecrawl Cloud
الكشط والزحف ورسم الخرائط وتحليل المستندات تعمل على جهازك ولا تُرسل شيئًا إلى Firecrawl. تنتقل ثلاث ميزات إلى Firecrawl Cloud لأن الحاسوب المحمول لا يملك الفهرس أو الشبكة أو البيانات:
- البحث. لا يوجد فهرس بحث على جهازك. يعمل البحث بدون مفتاح لكنه محدود المعدّل.
- الصفحات التي ترفض جهازك. إذا حجب موقع ما كلاً من الجلب المباشر والمتصفح المحلي، تجلبه Firecrawl Cloud. لا حاجة إلى حساب.
- موفّرو بيانات Alexandria. يعملون على Firecrawl Cloud ويحتاجون إلى حساب مجاني. يغطي شرح Firecrawl Alexandria الخاص بنا ماهيتهم.

يتحكم متغير البيئة FIRECRAWL_CLOUD في عملية التسليم:
| القيمة | التأثير |
|---|---|
auto (الافتراضي) |
يعمل البحث والاحتياط للصفحات المحجوبة وAlexandria جميعًا |
search |
البحث فقط يُوجَّه إلى Firecrawl Cloud |
off |
لا شيء يُوجَّه إلى Firecrawl Cloud |
تُحسب أي قيمة غير معروفة على أنها off. تحمل النتائج المجلوبة من السحابة "source": "firecrawl-cloud"؛ وإذا فشلت السحابة أيضًا، تحصل على "blocked": true.
تحمل استدعاءات السحابة معرّف تثبيت عشوائيًا واسم الأداة المستدعية، وهذه هي طريقة Firecrawl في عدّ عمليات التثبيت.
كيفية تثبيت Firecrawl Local
تحتاج إلى Rust ومترجم C. بعد ذلك:
- ثبّت أدوات البناء. على macOS شغّل
xcode-select --install. على Debian أو Ubuntu ثبّتbuild-essential. - أضف Chrome أو Chromium (اختياري) إذا كنت بحاجة إلى صفحات تُصيَّر بـ JavaScript أو لقطات شاشة.
- أضف Node.js 22 أو أحدث (اختياري) إذا أردت خادم MCP، الذي يشغّل حزمة npm
firecrawl-mcpعبرnpx. - سجّل الدخول (اختياري) عبر
firecrawl-local loginللحصول على موفّري Alexandria.
ثبّت الملف التنفيذي من crates.io.
cargo install firecrawl-local
firecrawl-local --version
لبناء أحدث كود بدلًا من ذلك، شغّل cargo build --release في apps/local داخل نسخة مستنسخة من المستودع.
Firecrawl Local API: مسارات v2 على localhost:3002
يستجيب firecrawl-local serve لـ Firecrawl v2 API على المنفذ 3002. لا حاجة إلى مفتاح API للمسارات المحلية.
firecrawl-local serve
# in another terminal
curl -s http://localhost:3002/v2/scrape \
-H 'content-type: application/json' \
-d '{"url":"https://example.com","formats":["markdown"]}'
هذه المسارات تعمل على جهازك:
| المسار | ما يفعله |
|---|---|
POST /v2/scrape |
كشط عنوان URL واحد |
POST /v2/map |
سرد عناوين URL الخاصة بموقع |
POST /v2/crawl، وGET وDELETE /v2/crawl/{id} |
بدء زحف، والتحقق منه، وإلغاؤه |
POST /v2/batch/scrape، وGET وDELETE /v2/batch/scrape/{id} |
بدء كشط دفعي، والتحقق منه، وإلغاؤه |
GET /health |
فحص الحالة |
يُعاد توجيه كل مسار /v2 آخر، مثل /v2/search، إلى Firecrawl Cloud ما لم يحدد FIRECRAWL_CLOUD خلاف ذلك. لا تُقدَّم مسارات v0 وv1.
ينتقل الكود الحالي بتغيير إعداد واحد: وجّه عنوان URL الخاص بـ API في أي حزمة تطوير Firecrawl SDK إلى http://localhost:3002. يحتفظ أداة الكشط أو خط أنابيب RAG الخاص بك بكوده، وتتوقف عن استهلاك أرصدة السحابة أثناء التكرار. للحصول على نظرة أوسع على خطوط أنابيب الكشط، راجع دليل الكشط على الويب من Firecrawl.
Firecrawl Local كخادم MCP لوكلاء الذكاء الاصطناعي
يسجّل firecrawl-local init نسخة Firecrawl Local كخادم Model Context Protocol في كل أداة ذكاء اصطناعي يجدها. يتعرّف على Claude Code وClaude Desktop وCursor وWindsurf وGemini CLI وCodex، ويُنشئ نسخة احتياطية من كل ملف إعداد أولًا، ويقبل --dry-run لمعاينة التغييرات أو --agent cursor لإعداد أداة واحدة.
يحصل وكيلك على أدوات Firecrawl MCP القياسية: تعمل أوامر الكشط والزحف ورسم الخرائط والكشط الدفعي محليًا، والباقي يُوجَّه إلى Firecrawl Cloud.
إذا كان وكيلك يتصفّح مواقع لا تثق بها، فسجّله بأمر firecrawl-local mcp --public-only. وإلا فقد تدفع صفحة تحتوي على تعليمات مخفية الوكيلَ إلى فتح عنوان URL داخلي على شبكتك.
حدود Firecrawl Local
Firecrawl Local ليس خادم Firecrawl الكامل. يسرد README ما هو ناقص:
- لا توجد صيغتا
jsonأوsummaryمحليًا. تتخطاهما عمليات الكشط المحلية مع تحذير، لأنها تحتاج إلى نموذج. - لا توجد
actionsللمتصفح. تُتجاهَل خطوات النقر والتمرير والكتابة. - تتطلب لقطات الشاشة وجود Chrome.
- المهام تعيش في الذاكرة. تنتهي مهام الزحف والكشط الدفعي بعد ساعة من بدئها، وتُفقد عند إيقاف
serve. - لا توجد مسارات v0 أو v1 الخاصة بـ API.
للحصول على قوائم الانتظار والعمال وكل الصيغ، لا يزال الخادم الكامل في apps/api موجودًا، وهو مغطى في دليل الاستضافة الذاتية من Firecrawl.
إعدادات الأمان الافتراضية التي يجب أن تعرفها
تختلف الإعدادات الافتراضية حسب الأمر، لأن serve يستقبل طلبات من برامج أخرى:
- تعمل
scrapeوcrawlوmapوmcpلصالح من هو على لوحة المفاتيح، لذا يمكنها الوصول إلىlocalhostوشبكتك الخاصة. تقبلscrapeوcrawlوmcpخيار--public-onlyلرفض تلك العناوين. serveيرتبط بـ127.0.0.1ويرفض الأهداف المحلية والخاصة ما لم تمرّر--allow-private. يتطلب ربط عنوان آخر عبر--hostتمرير--token.- عناوين link-local والبيانات الوصفية للسحابة محظورة دائمًا، بما في ذلك بعد عمليات إعادة التوجيه وتحليل DNS.
يعمل Chrome في وضع headless ومعزول (sandboxed) بملف تعريف مؤقت. عند الزحف، يقرأ Firecrawl Local ملف robots.txt وفقًا لـ بروتوكول استبعاد الروبوتات، حيث يمكن لأصحاب المواقع مخاطبته باسم FirecrawlLocal.
لمن هذا Firecrawl Local؟
- المطوّرون الذين يبنون أدوات كشط أو خطوط أنابيب RAG ويريدون تكرارًا مجانيًا وسريعًا قبل الدفع مقابل حجم السحابة.
- مستخدمو وكلاء البرمجة الذين يريدون قراءة الويب داخل Claude Code أو Cursor أو Codex دون تمرير كل صفحة عبر طرف ثالث.
- الفرق التي لديها قواعد بيانات وتحتاج إلى إبقاء المحتوى المجلوب على الجهاز، باستخدام
FIRECRAWL_CLOUD=off.
يُعد خيارًا أضعف إذا كنت تعتمد على استخراج json، أو إجراءات المتصفح، أو مهام الزحف طويلة الأمد. وإذا كنت بحاجة إلى بحث للوكيل فقط، فراجع قائمتنا المجمّعة لـ البحث على الويب مفتوح المصدر لـ Claude.
اجعل وكيل البرمجة الخاص بك يختبر API المحلي باستخدام Apidog CLI
بمجرد تشغيل serve، يصبح لديك API HTTP حقيقي على localhost:3002. قبل ربط خط أنابيب به، تحقق من أن المسارات تستجيب بالطريقة التي يتوقعها كودك. أعطِ وكيل البرمجة الخاص بك Apidog CLI وأمرًا واحدًا بدلًا من النقر عبر الطلبات.
أعدّه مرة واحدة:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
ثم اطلب من وكيلك:
Start firecrawl-local serve in the background. Write an OpenAPI 3 file for its
local routes (POST /v2/scrape, POST /v2/map, GET /health) and import it into
Apidog project <id>. Create an environment pointing at http://localhost:3002,
add test cases that assert /health returns 200 and /v2/scrape returns
success: true with non-empty data.markdown for https://example.com, then run
them and summarize any failures.

يقرأ الوكيل المخطط، ويتحقق من صحّة الحمولة، ويشغّل أوامر مثل هذه:
firecrawl-local serve &
apidog import --project <id> --format openapi --file ./firecrawl-local-v2.yaml
apidog environment create firecrawl-local --project <id> --base-url http://localhost:3002
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <id> --file ./case.json
apidog run --test-case <caseId> --project <id> -e <envId> -r cli,json
يرسل Apidog CLI الطلبات من جهازك، لذا يكون localhost:3002 قابلًا للوصول. استبدل -r cli,json بـ -r junit لينضم التشغيل نفسه إلى CI؛ يوضح دليل Apidog CLI لـ CI/CD الإعداد، ويرشد Apidog CLI في Claude Code خلال جانب الوكيل. تغطي خطة Apidog المجانية فرقًا تصل إلى 4 مستخدمين.
الأسئلة الشائعة
هل Firecrawl Local مجاني؟ الملف التنفيذي مفتوح المصدر بموجب AGPL-3.0، والكشط والزحف ورسم الخرائط المحلية لا تحتاج إلى مفتاح API. يُوجَّه البحث والاحتياط للصفحات المحجوبة وAlexandria إلى Firecrawl Cloud، ويحتاج Alexandria إلى حساب مجاني.
هل يمكنني استخدام كود Firecrawl SDK الحالي مع Firecrawl Local؟ نعم، للمسارات المحلية. اضبط عنوان URL الخاص بـ API في SDK على http://localhost:3002. تعمل أوامر الكشط ورسم الخرائط والزحف والكشط الدفعي محليًا؛ ولا تُقدَّم مسارات v0 وv1.
كيف أوقف اتصال Firecrawl Local بالسحابة؟ اضبط FIRECRAWL_CLOUD=off. يتوقف البحث والاحتياط للصفحات المحجوبة عن العمل، ولا شيء يغادر جهازك باستثناء أمر login الصريح.
كيف يختلف Firecrawl Local عن Firecrawl المستضاف ذاتيًا؟ Firecrawl المستضاف ذاتيًا هو الخادم الكامل في apps/api، مع قوائم انتظار وعمال وكل الصيغ. Firecrawl Local هو ملف تنفيذي واحد أخف يتخلى عن صيغتي json وsummary، وإجراءات المتصفح، والمهام الدائمة.
