ما هو Firecrawl Local؟ شغّل Firecrawl على جهازك الخاص

Firecrawl Local هو ملف تنفيذي واحد مكتوب بلغة Rust يجمع محتوى المواقع ويزحف إليها ويرسم خرائطها ويحوّلها إلى Markdown على جهازك، ويشغّل واجهة Firecrawl v2 API على localhost:3002. إليك ما يعمل محليًا، وما يُرسل إلى السحابة، وكيفية تثبيته، وأين تكمن حدوده.

INEZA Felin-Michel

INEZA Felin-Michel

19 نوفمبر 2026

ما هو Firecrawl Local؟ شغّل Firecrawl على جهازك الخاص

Apidog للمؤسسات

النشر على الخوادم المحلية

SSO و RBAC

متوافق مع SOC 2

استكشف Apidog للمؤسسات

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 Local split: scrape, crawl, map and PDF and Office parsing run on your machine with optional Chrome, while search, the blocked-page fallback and Alexandria data go to Firecrawl Cloud under FIRECRAWL_CLOUD=auto, switchable to search or off

يتحكم متغير البيئة FIRECRAWL_CLOUD في عملية التسليم:

القيمة التأثير
auto (الافتراضي) يعمل البحث والاحتياط للصفحات المحجوبة وAlexandria جميعًا
search البحث فقط يُوجَّه إلى Firecrawl Cloud
off لا شيء يُوجَّه إلى Firecrawl Cloud

تُحسب أي قيمة غير معروفة على أنها off. تحمل النتائج المجلوبة من السحابة "source": "firecrawl-cloud"؛ وإذا فشلت السحابة أيضًا، تحصل على "blocked": true.

تحمل استدعاءات السحابة معرّف تثبيت عشوائيًا واسم الأداة المستدعية، وهذه هي طريقة Firecrawl في عدّ عمليات التثبيت.

كيفية تثبيت Firecrawl Local

تحتاج إلى Rust ومترجم C. بعد ذلك:

  1. ثبّت أدوات البناء. على macOS شغّل xcode-select --install. على Debian أو Ubuntu ثبّت build-essential.
  2. أضف Chrome أو Chromium (اختياري) إذا كنت بحاجة إلى صفحات تُصيَّر بـ JavaScript أو لقطات شاشة.
  3. أضف Node.js 22 أو أحدث (اختياري) إذا أردت خادم MCP، الذي يشغّل حزمة npm ‏firecrawl-mcp عبر npx.
  4. سجّل الدخول (اختياري) عبر 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 ما هو ناقص:

للحصول على قوائم الانتظار والعمال وكل الصيغ، لا يزال الخادم الكامل في apps/api موجودًا، وهو مغطى في دليل الاستضافة الذاتية من Firecrawl.

إعدادات الأمان الافتراضية التي يجب أن تعرفها

تختلف الإعدادات الافتراضية حسب الأمر، لأن serve يستقبل طلبات من برامج أخرى:

يعمل Chrome في وضع headless ومعزول (sandboxed) بملف تعريف مؤقت. عند الزحف، يقرأ Firecrawl Local ملف robots.txt وفقًا لـ بروتوكول استبعاد الروبوتات، حيث يمكن لأصحاب المواقع مخاطبته باسم FirecrawlLocal.

لمن هذا Firecrawl Local؟

يُعد خيارًا أضعف إذا كنت تعتمد على استخراج 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.
Coding agent workflow: the agent starts firecrawl-local serve on localhost:3002, Apidog CLI imports the spec, creates test cases and runs them against POST /v2/scrape, POST /v2/map and GET /health, and writes a cli, json or junit report

يقرأ الوكيل المخطط، ويتحقق من صحّة الحمولة، ويشغّل أوامر مثل هذه:

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، وإجراءات المتصفح، والمهام الدائمة.

ممارسة تصميم API في Apidog

اكتشف طريقة أسهل لبناء واستخدام واجهات برمجة التطبيقات