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

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

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

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

💡

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

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

ما يقدمه Firecrawl CLI ولماذا يتفوق على أدوات الويب التقليدية

يقوم Firecrawl CLI بعرض JavaScript بشكل طبيعي عبر المتصفحات السحابية، ويحترم حماية مكافحة الروبوتات، ويوفر استرجاعًا للمحتوى بنسبة تزيد عن 80% في المواقع المعقدة حيث تفشل نصوص Puppeteer الأساسية أو القائمة على cheerio. تحصل افتراضيًا على ماركداون محسن لـ LLM، مجرد من الأكواد الجاهزة، مما يقلل من ضغط نافذة السياق عند تغذية النتائج إلى الوكلاء.

يكتب Firecrawl CLI الملفات محليًا بدلاً من تدفق الأحمال الكبيرة، مما يتيح البحث المدعوم بواسطة bash على المحتوى المستخرج دون الحاجة إلى استدعاءات API متكررة. يمكنك دمج أوامر Firecrawl CLI scrape و search و map و crawl والمتصفح في البرامج النصية أو حلقات الوكيل بسلاسة. تلغي هذه الإمكانيات الحاجة إلى مكتبات منفصلة، أو مثيلات بدون واجهة رسومية (headless)، أو تدوير الوكلاء (proxy rotations). تؤدي القرارات الصغيرة مثل استخدام --only-main-content في Firecrawl CLI إلى مخرجات أنظف وأقل تكلفة تتراكم لتصبح مكاسب إنتاجية كبيرة.

تحضير بيئتك قبل تثبيت Firecrawl CLI

تتحقق من أن Node.js ≥18 لأن Firecrawl CLI يعتمد على ميزات npm الحديثة. قم بتشغيل node --version في جهازك الطرفي. قم بالتحديث عبر مدير الحزم الخاص بك أو nvm إذا لزم الأمر.

تقوم بإنشاء دليل عمل لتنظيم مخرجات Firecrawl CLI:

mkdir firecrawl-cli-projects && cd firecrawl-cli-projects

هذا يمنع الفوضى ويسهل تتبع مجموعات البيانات باستخدام Git. يمكنك اختياريًا تعطيل القياس عن بعد (telemetry):

export FIRECRAWL_NO_TELEMETRY=1

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

المسار الأسرع يثبت Firecrawl CLI، ويصادق، ويضيف مهارات الوكيل في خطوة واحدة. نفّذ:

npx -y firecrawl-cli@latest init --all --browser

يفتح Firecrawl CLI متصفحك لتسجيل الدخول إلى حساب Firecrawl (أو التسجيل)، ويقوم بإنشاء/تخزين مفتاح API الخاص بك بشكل آمن، ويهيئ المهارات لـ Claude Code و Cursor والوكلاء المتوافقين الآخرين. أعد تشغيل وكيلك بعد ذلك لكي يكتشف إمكانيات Firecrawl CLI الجديدة. هذه الطريقة تجهز Firecrawl CLI عالميًا وتمكن الوصول إلى متصفح MCP/بدون خادم.

تثبيت Firecrawl CLI عالميًا عبر npm للاستخدام المتكرر

للوصول الدائم ومنخفض الكمون عبر المشاريع، قم بتثبيت Firecrawl CLI عالميًا:

npm install -g firecrawl-cli

تحقق بواسطة:

firecrawl --version

يستجيب Firecrawl CLI الآن فورًا من أي دليل دون تحميل زائد من npx.

مصادقة Firecrawl CLI والتحقق من تكوينك

تفتح المصادقة ميزات Firecrawl CLI الكاملة. قم بالتشغيل:

firecrawl login

يطلب Firecrawl CLI مصادقة OAuth المستندة إلى المتصفح. بدلاً من ذلك، عيّن مفتاحك يدويًا:

export FIRECRAWL_API_KEY=fc-your-key-here

تحقق من الحالة في أي وقت:

firecrawl --status

يعرض هذا الرصيد، وحدود التزامن، وحالة المصادقة. لعرض التكوين الكامل:

firecrawl view-config

قم بتبديل الحسابات باستخدام firecrawl logout ثم أعد تسجيل الدخول. بالنسبة لنسخ Firecrawl المحلية/المستضافة ذاتيًا، استخدم --api-url http://localhost:3002 لتجاوز المصادقة السحابية والرصيد.

إتقان أمر Scrape في Firecrawl CLI

يمكنك استخراج المحتوى من أي عنوان URL باستخدام:

firecrawl scrape https://example.com --only-main-content

يعيد Firecrawl CLI ماركداون نظيفًا ويحفظه في ./output.md عند إضافة -o output.md. فضل دائمًا --only-main-content لإزالة التنقل والإعلانات والأشرطة الجانبية، مما يقلل من استخدام الرموز.

اطلب تنسيقات متعددة:

firecrawl scrape https://example.com --format markdown,json,html,links,images --pretty

يقوم Firecrawl CLI بإخراج JSON منظم يحتوي على جميع البيانات المطلوبة. لالتقاط لقطات الشاشة: --screenshot أو --full-page-screenshot. للتعامل مع التحميل البطيء استخدم --wait-for 5000.

قم بالفلترة بدقة:

firecrawl scrape https://docs.example.com --include-tags main,article --exclude-tags nav,footer,script

أضف --timing لقياس الأداء. يخزن Firecrawl CLI النتائج محليًا، جاهزة للتوجيه أو استيعاب الوكيل.

إجراء بحث عبر الويب باستخدام Firecrawl CLI

يمكنك البحث في الإنترنت واستخلاص أفضل النتائج معًا:

firecrawl search "latest AI agent benchmarks" --scrape --limit 8 --scrape-formats markdown

يجلب Firecrawl CLI النتائج، ويستخرج المحتوى، ويحفظ الملفات. قم بالفلترة حسب الحداثة (--tbs qdr:w) أو الموقع أو نوع المصدر. ادمج البحث مع جلسات المتصفح للتحقق الأعمق. وبالتالي، يدعم Firecrawl CLI دورات بحث كاملة في أداة واحدة.

رسم خرائط مواقع الويب باستخدام Firecrawl CLI

اكتشف جميع عناوين URL قبل الاستخراج العميق:

firecrawl map https://example.com -o sitemap.json

يعيد Firecrawl CLI قائمة منظمة تحتوي على بيانات وصفية. قم بتغذية عناوين URL المفلترة إلى أوامر الاستخلاص أو الزحف. يحترم Firecrawl CLI ملف robots.txt والزحف المهذب تلقائيًا.

الزحف إلى مواقع كاملة بشكل متكرر باستخدام Firecrawl CLI

قم بالزحف بشكل شامل:

firecrawl crawl https://example.com --wait --progress -o crawl-output.json

يتبع Firecrawl CLI الروابط الداخلية، ويستخرج الصفحات، ويخزن كل شيء محليًا. تحكم في العمق، والحد الأقصى للصفحات، والتزامن لإدارة التكاليف. يتيح لك تقرير التقدم في الوقت الفعلي مراقبة المهام الكبيرة أو إلغائها.

أتمتة جلسات المتصفح في Firecrawl CLI

تعامل مع التدفقات التفاعلية باستخدام المتصفحات السحابية:

firecrawl browser launch-session

يعيد Firecrawl CLI معرف جلسة. نفّذ الإجراءات:

firecrawl browser execute "open https://news.ycombinator.com" --session <id>
firecrawl browser execute "click .titleline > a" --session <id>
firecrawl browser execute "scrape" --session <id>

يدعم Firecrawl CLI النقرات والكتابة والتنقل والاستخراج بعد التفاعلات الديناميكية. أغلق الجلسات لتحرير الموارد. يستبدل Firecrawl CLI كود Puppeteer المعقد بأوامر بسيطة قابلة للقراءة بواسطة الوكلاء.

تكوين Firecrawl CLI المتقدم والأعلام العامة

قم بالتخصيص بشكل دائم:

firecrawl config --api-url https://your-custom-endpoint --concurrency 5

يطبق Firecrawl CLI هذه الإعدادات في كل عملية تشغيل. افرض إخراج JSON عالميًا أو اضبط الرؤوس (headers). راقب الرصيد قبل العمليات الكبيرة باستخدام --status. قم بتصدير FIRECRAWL_API_KEY في ملف تعريف shell الخاص بك لضمان جلسات سلسة.

دمج Firecrawl CLI مع وكلاء ترميز الذكاء الاصطناعي

قم بتثبيت مهارة Firecrawl CLI مرة واحدة (npx -y firecrawl-cli@latest init --all)، وسيكتشفها الوكلاء تلقائيًا. في وضع CLI + Skills، يقوم الوكلاء بتشغيل أوامر Firecrawl CLI صراحة عند الحاجة. في وضع MCP، يستدعي الوكلاء الأدوات الأصلية بشكل غير مرئي.

يعيد Firecrawl CLI مسارات الملفات المحلية بدلاً من المحتوى الخام، مما يحافظ على نوافذ السياق الخالية من التكدس. وبالتالي، يقوم الوكلاء بإجراء بحث ويب موثوق به دون الحاجة إلى توجيهات إضافية.

استكشاف مشكلات Firecrawl CLI وإصلاحها بكفاءة

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

أفضل الممارسات للحصول على أقصى استفادة من Firecrawl CLI

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

استكمال سير عمل Firecrawl CLI باستخدام Apidog

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

الخاتمة

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

قم بتشغيل أمر init اليوم، واختبر عملية استخلاص، وابنِ من هناك. يكافئ Firecrawl CLI الاستخدام الدقيق للأعلام والتجريب بنتائج أفضل بكثير.

قم بتنزيل Apidog مجانًا الآن لتعزيز اختبار Firecrawl CLI والتحقق من API. قم بتثبيت Firecrawl CLI، واستخدم Firecrawl CLI، وافتح إتقان الويب في الوقت الفعلي.

button

موارد إضافية

وثائق Firecrawl CLI → https://docs.firecrawl.dev/sdks/cli
الموقع الرئيسي لـ Firecrawl → https://www.firecrawl.dev
مستودع GitHub → https://github.com/firecrawl/cli
مرجع API → https://docs.firecrawl.dev/api-reference
لوحة التحكم / مفتاح API → https://app.firecrawl.dev
عميل Apidog API المجاني → https://apidog.com