Install
npx -y firecrawl-cli@latest init -y --browserلمن يناسب
هذا الدليل لمن يحتاج من طرفية محلية إلى بحث ويب، أو جلب صفحات، أو تفاعل مع الصفحة، أو زحف موقع، أو خرائط موقع، أو تشغيل مهام وكيل مباشرة. تصفه المادة الرسمية بأنه مدخل سطر أوامر وفي الوقت نفسه مهارة وكيل يمكن تثبيتها في محررات البرمجة المكتشفة.
إذا كان عملك أن تقرأ الصفحات العامة أولاً ثم تقرر هل تغيّر الشفرة — لا أن تبني بنفسك خدمة جلب — فهذا المسار أنسب. تذكر الملاحظات الرسمية أيضاً البحث في الأوراق ومواد المطوّرين. لا يناسب من يريد نقرات قليلة في واجهة رسومية ولا يستطيع تنفيذ أوامر الطرفية: المسار الموصى به يثبّت أداة سطر أوامر، ويُكمل تسجيل الدخول، ويكتب المهارات في المحررات المكتشفة.
المستودع الرسمي هو
https://github.com/firecrawl/cli
اتبع صياغة تلك الصفحة الحالية فقط. لا تنتقل إلى مثبّت أو مجلد مهارات لا يظهر هناك.
أول تجربة في 3 دقائق
اتبع المسار الرسمي الموصى به وحده.
المتطلبات: تستطيع الطرفية تشغيل npx، ولديك مسبقاً طريقة وصول إلى Firecrawl. تسمح الملاحظات الرسمية أيضاً بتعيين متغير البيئة FIRECRAWL_API_KEY؛ وinit مع --browser يستخدم تسجيل الدخول عبر المتصفح. قبل التنفيذ تأكد أنك ستسجل الدخول بحسابك أنت، ولاحظ أن الكتابة الافتراضية تصل إلى كل محررات البرمجة المكتشفة لا إلى مجلد مؤقت.
موضع التثبيت: تُثبَّت المهارات افتراضياً بشكل عام في المحررات المكتشفة. لاستهداف واحد فقط، الصيغة الرسمية تضيف --agent <agent>.
انسخ ونفّذ:
npx -y firecrawl-cli@latest init -y --browser
إشارة النجاح: ينتهي الأمر بشكل طبيعي، وتستطيع هذه الآلة استدعاء firecrawl، وتظهر مهارة جديدة في المحررات المكتشفة. لا تزحف موقعاً كاملاً بعد. بعد ذلك قم بتحقق قابل للعكس: نفّذ firecrawl setup core. تقول الملاحظات الرسمية إن هذه المجموعة توفر بدائيات scrape وsearch وcrawl وinteract إضافة إلى مهارات فهرسة؛ وskills اسم بديل لها. بعد قبول الأمر، اطلب من الوكيل المثبّت طلباً للقراءة فقط، مثلاً «استخدم Firecrawl للبحث عن عنوان وثيقة عامة، أظهر النتائج فقط، ولا تكتب ملفات». رؤية النتائج تعني أن المهارة وُجدت.
عندما تحتاج مهارات تكامل تطبيقات تخاطب واجهة Firecrawl API، نفّذ بعدها firecrawl setup build. عندما تحتاج وصفات من طرف إلى طرف مثل توليد العملاء المحتملين أو البحث العميق، نفّذ بعدها firecrawl setup workflows. في المرة الأولى ثبّت core فقط حتى لا تُكتب كل الوصفات دفعة واحدة.
أمثلة استخدام
المثال 1: إضافة بدائيات البحث والجلب إلى الوكيل الحالي. الإجراء الرسمي هو firecrawl setup core، ويثبّت بدائيات scrape وsearch وcrawl وinteract ومهارات الفهرسة. يناسب إذا كنت تعمل أصلاً في محرر مكتشف وتريد أن يبحث الوكيل في صفحات عامة أو يجلبها قبل أن تقرر تعديل المستودع. أنهِ init أعلاه أولاً، ثم ثبّت core فقط. عند النجاح ينبغي أن يطلق حوار عملية بحث أو جلب واحدة ويُظهر ملخص النتائج. المواد الرسمية لا تعطي مسار مجلد المهارات، فلا تخترع دليلاً لم يظهر.
المثال 2: تحتاج وصفات جاهزة لا بدائيات مفردة. الإجراء الرسمي هو firecrawl setup workflows؛ وتذكر المواد توليد العملاء المحتملين والبحث العميق. يناسب بعد أن يعمل core وتريد البحث وفق وصفة. أكّد نجاح init ثم نفّذ ذلك الأمر؛ وللتثبيت في محرر واحد أضف --agent <agent>. إشارة النجاح ظهور مجموعة المهارات هذه في المحرر المستهدف. خطوات الوصفة الداخلية غير مبسوطة؛ المادة الحالية تؤكد فقط أن workflows ثُبّت، ولا يمكن إكمال خطوات فرعية غير مكتوبة.
حدود الاستخدام
المادة الحالية تتوقف عند أوامر الطرفية، وتسجيل الدخول عبر المتصفح أو FIRECRAWL_API_KEY، ومجموعات التثبيت الثلاث core وbuild وworkflows. لا تفرض لغة إلزامية، ولا تجعل «المحررات المكتشفة» قائمة حصرية؛ لا تستنتج من نطاق التثبيت الافتراضي أن عدداً قليلاً فقط من العملاء يعمل.
لا تطبّق تهيئة npx هذه على بيئة تسمح فقط بنسخ ملفات المهارات يدوياً وليس فيها سطر أوامر عام. المادة أيضاً لا تعطي عنوان سوق ثانٍ ولا سراً نموذجياً.
init وsetup يكتبان مهارات في المحررات المكتشفة ولهما آثار جانبية. أكّد المحرر المستهدف أولاً؛ وبعد التنفيذ افحص فقط إن ظهرت المهارات — ولا تزحف فوراً موقعاً غير مصرّح به. الجلب والتفاعل والزحف تصل كلها إلى مواقع خارجية؛ تحقّق أولاً بصفحة عامة يمكنك فتحها مرة أخرى.
FIRECRAWL_API_KEY اسم متغير بيئة، وليس سراً نموذجياً للصقه في النص. لا تخترع أوامر فرعية أو أسماء مهارات أو مسارات تثبيت لم تظهر. لمزيد من التفصيل اتبع المستودع الرسمي:
https://github.com/firecrawl/cli