DEV Community

Cover image for كيفية تثبيت واستخدام Firecrawl CLI
Yusuf Khalidd
Yusuf Khalidd

Posted on • Originally published at apidog.com

كيفية تثبيت واستخدام Firecrawl CLI

#automation #cli #tutorial #webscraping

أداة Firecrawl CLI: أداة الطرفية الموحدة لاستخلاص البيانات من الويب

Firecrawl CLI هي أداة متقدمة للمطورين ووكلاء الذكاء الاصطناعي، تتيح لك استخراج البيانات، البحث، رسم خرائط المواقع، الزحف الآلي، وأتمتة المتصفح لأي موقع ويب، مع دعم تنسيقات ماركداون نظيف، JSON، لقطات شاشة، والمزيد، مع حفظ كل شيء مباشرة في نظام الملفات.

جرّب Apidog اليوم

يمكنك تشغيل Firecrawl CLI مباشرة عبر npx firecrawl (بدون تثبيت مسبق)، أو تثبيته عالميًا، ثم ربطه بكل من Claude Code أو Cursor أو OpenCode عبر أمر واحد firecrawl init لإضافة المهارة تلقائيًا.

💡 قبل تشغيل أول أمر Firecrawl CLI، احصل على Apidog مجانًا. ستتمكن من اختبار وتصحيح Firecrawl API بصريًا (مفاتيح API، معلمات مخصصة، أشكال الاستجابة) في واجهة واحدة نظيفة. هذا يوفر عليك الوقت عند إعداد أو استكشاف تكامل الوكلاء.

لماذا Firecrawl CLI؟

  • يقدم إخراج ماركداون نظيف أو JSON منظم أو HTML أو لقطات شاشة.
  • يعالج المواقع الديناميكية المعقدة ويدعم استخراج المحتوى من صفحات معروضة عبر JavaScript.
  • يمكن دمجه بسلاسة مع وكلاء مثل Claude Code و Cursor و OpenCode.
  • يدير التزامن، وحدود المعدل، والتخزين المؤقت تلقائيًا.
  • خيارات مرنة مثل تنسيقات الإخراج، مؤقتات الانتظار، وفلاتر دقيقة للمحتوى.

تحضير البيئة

  1. تأكد من وجود Node.js ≥18 تحقق عبر: 
   node --version
Enter fullscreen mode Exit fullscreen mode

إذا لزم الأمر، حدث عبر nvm أو مدير الحزم.

  1. إنشاء مشروع منظم للمخرجات 
   mkdir firecrawl-cli-projects && cd firecrawl-cli-projects
Enter fullscreen mode Exit fullscreen mode

هذا يسهل إدارة البيانات وربطها مع Git.

  1. اختياري: تعطيل القياس عن بعد 
   export FIRECRAWL_NO_TELEMETRY=1
Enter fullscreen mode Exit fullscreen mode

تثبيت Firecrawl CLI وتهيئة الوكلاء (الطريقة الموصى بها)

شغّل أمر التثبيت والتهيئة مرة واحدة:

npx -y firecrawl-cli@latest init --all --browser
Enter fullscreen mode Exit fullscreen mode
  • سيتم فتح متصفح للمصادقة، وتخزين مفتاح API، وتهيئة المهارات للوكلاء المدعومين.
  • أعد تشغيل الوكيل ليكتشف Firecrawl CLI.

للتثبيت العالمي (للاستخدام الدائم) 

npm install -g firecrawl-cli
Enter fullscreen mode Exit fullscreen mode

تحقق من التثبيت:

firecrawl --version
Enter fullscreen mode Exit fullscreen mode

المصادقة والتحقق

  1. تسجيل الدخول: 
   firecrawl login
Enter fullscreen mode Exit fullscreen mode

أو قم بتعيين مفتاح API يدويًا:

   export FIRECRAWL_API_KEY=fc-your-key-here
Enter fullscreen mode Exit fullscreen mode
  1. التحقق من الحالة: 
   firecrawl --status
Enter fullscreen mode Exit fullscreen mode
  1. عرض الإعدادات: 
   firecrawl view-config
Enter fullscreen mode Exit fullscreen mode
  1. تبديل الحسابات: 
   firecrawl logout
   firecrawl login
Enter fullscreen mode Exit fullscreen mode
  1. تشغيل محلي أو مستضاف ذاتيًا: 
   firecrawl --api-url http://localhost:3002
Enter fullscreen mode Exit fullscreen mode

أوامر Firecrawl CLI الأساسية

1. استخلاص البيانات (Scrape)

  • استخراج محتوى رئيسي من صفحة: 
  firecrawl scrape https://example.com --only-main-content
Enter fullscreen mode Exit fullscreen mode

للإخراج في ملف:

  firecrawl scrape https://example.com -o output.md --only-main-content
Enter fullscreen mode Exit fullscreen mode
  • استخراج بصيغ متعددة: 
  firecrawl scrape https://example.com --format markdown,json,html,links,images --pretty
Enter fullscreen mode Exit fullscreen mode
  • لقطات شاشة: 
  firecrawl scrape https://example.com --screenshot
Enter fullscreen mode Exit fullscreen mode
  • انتظار تحميل الصفحة: 
  firecrawl scrape https://example.com --wait-for 5000
Enter fullscreen mode Exit fullscreen mode
  • تصفية عناصر HTML مع تضمين/استبعاد: 
  firecrawl scrape https://docs.example.com --include-tags main,article --exclude-tags nav,footer,script
Enter fullscreen mode Exit fullscreen mode
  • قياس الأداء: 
  firecrawl scrape https://example.com --timing
Enter fullscreen mode Exit fullscreen mode

2. البحث عبر الويب

  • بحث ذكي واستخلاص النتائج: 
  firecrawl search "latest AI agent benchmarks" --scrape --limit 8 --scrape-formats markdown
Enter fullscreen mode Exit fullscreen mode
  • فلترة حسب الحداثة أو المصدر: 
  firecrawl search "موضوعك" --tbs qdr:w
Enter fullscreen mode Exit fullscreen mode

3. رسم خريطة الموقع (Map)

  • اكتشاف جميع روابط موقع: 
  firecrawl map https://example.com -o sitemap.json
Enter fullscreen mode Exit fullscreen mode

4. الزحف الكامل (Crawl)

  • زحف شامل وتحكم في العمق: 
  firecrawl crawl https://example.com --wait --progress -o crawl-output.json
Enter fullscreen mode Exit fullscreen mode

5. أتمتة جلسات المتصفح

  • فتح جلسة تفاعلية: 
  firecrawl browser launch-session
Enter fullscreen mode Exit fullscreen mode
  • تنفيذ إجراءات: 
  firecrawl browser execute "open https://news.ycombinator.com" --session <id>
  firecrawl browser execute "click .titleline > a" --session <id>
  firecrawl browser execute "scrape" --session <id>
Enter fullscreen mode Exit fullscreen mode

تخصيص الإعدادات والأعلام

  • تعيين عنوان API مخصص وتعديل التزامن: 
  firecrawl config --api-url https://your-custom-endpoint --concurrency 5
Enter fullscreen mode Exit fullscreen mode
  • إخراج JSON دائمًا أو تخصيص رؤوس الطلبات.
  • راقب الرصيد قبل العمليات الكبيرة: 
  firecrawl --status
Enter fullscreen mode Exit fullscreen mode
  • تصدير مفتاح API بملف الـ shell لجلسات مستمرة.

دمج Firecrawl CLI مع وكلاء الترميز

  • ثبّت المهارة مرة واحدة: 
  npx -y firecrawl-cli@latest init --all
Enter fullscreen mode Exit fullscreen mode
  • سيكتشفها الوكلاء تلقائيًا ويشغلون الأوامر عند الحاجة.
  • Firecrawl CLI يعيد مسارات الملفات بدلًا من محتوى خام، ما يحافظ على كفاءة نافذة السياق.

استكشاف المشاكل الشائعة

  • فشل المصادقة: أعد تشغيل firecrawl login.
  • بلوغ حدود المعدل: قلل التزامن أو حدّث خطتك من لوحة التحكم.
  • نتائج فارغة في مواقع ثقيلة JS: زد قيمة --wait-for أو فعّل --only-main-content.
  • تشخيص الأداء: استخدم --timing.
  • تبديل المفاتيح: امسح الاعتماديات بـ firecrawl logout.

أفضل الممارسات

  • استخدم دائمًا --only-main-content لمخرجات نظيفة.
  • اسم ملفات إخراج واضح ومجلدات منظمة.
  • اختبر على نطاق صغير قبل زحف كامل.
  • اتبع تدفق: بحث ← رسم خرائط ← زحف.
  • تحكم في إصدارات أدلة الإخراج لمجموعات بيانات قابلة للتكرار.
  • راقب رصيدك أسبوعيًا.

استكمال سير العمل مع Apidog

  • حمّل Apidog مجانًا.
  • استورد نقاط نهاية Firecrawl (scrape, search, crawl...) كـ collections.
  • Apidog يعرض الطلبات، يخزن مفتاح API كمتغير، يحاكي الاستجابات، ويشغّل اختبارات تلقائية.
  • اختبر إعدادات Firecrawl CLI المعقدة أو الحمولات الخاصة قبل التنفيذ الطرفي.
  • الجمع بين Firecrawl CLI و Apidog يمنحك بيانات ويب محدثة وسلوك API موثوق.

الخاتمة

مع Firecrawl CLI تستطيع التحكم الكامل في استخراج البيانات، البحث، رسم الخرائط، الزحف، وأتمتة المتصفح من خلال الطرفية، مع دعم ذكي للوكلاء والمطورين.

ابدأ بأمر init، جرب أول عملية استخلاص، وطور سير عملك تدريجيًا. الاستخدام الذكي للأعلام والتجربة العملية ينتج عنه نتائج أفضل.

جرّب Apidog مجانًا الآن لتعزيز اختبارات Firecrawl CLI والتحقق من الـ API.

ثبّت Firecrawl CLI وابدأ في استخلاص بيانات الويب بكفاءة في الوقت الفعلي.

موارد إضافية

Top comments (0)