بناء قائمة عملاء محتملين باستخدام وكلاء Claude Code وFirecrawl Alexandria

باختصار: لإنشاء قائمة عملاء محتملين باستخدام الوكلاء البرمجيين في Claude Code، قسّم العمل إلى أربع مهام على لوحة المهام: بحث مجاني عن الأشخاص عبر Apollo من خلال Firecrawl Alexandria، ومرحلة تأهيل بالاعتماد على الحقول التي أعادها البحث بالفعل، وإثراء مدفوع للبيانات عبر People Data Labs للمؤهلين فقط، ثم مراجعة بشرية قبل بدء أي تواصل. يغطي مفتاح Firecrawl واحد كافة مزودي البيانات، وتُبلّغ كل مهمة عن الأرصدة التي استهلكتها.

يمكنك إنشاء قائمة بالعملاء المحتملين بواسطة الوكلاء في جلسة واحدة طويلة عبر Claude Code؛ حيث تطلب "نواب رؤساء الهندسة في هذه الشركات العشر، مع عناوين بريدهم الإلكتروني الخاصة بالعمل"، فيقوم الوكيل بالبحث، والإثراء، وتسليمك ملف CSV. لكن المشكلة تظهر في الفاتورة: لقد دفع الوكيل تكلفة إثراء بيانات أشخاص كان بإمكانك استبعادهم بمجرد النظر إلى مسمياتهم الوظيفية.

تُسهّل Firecrawl Alexandria فرض مبدأ "البدء بالخطوات المجانية أولاً". فهي تجمع مئات مزودي البيانات خلف مفتاح Firecrawl API واحد، وقاعدتها واضحة: الاستكشاف مجاني بينما يكلف التنفيذ الأرصدة المحددة لكل أداة. يستعرض هذا المقال هذا المسار التسلسلي في صورة مهام على Sharkly، باستخدام Claude Code أو Codex كبيئة تشغيل، ويوضح تكلفة كل مرحلة من الأرصدة.

ما تقدمه Firecrawl Alexandria لوكيل جمع العملاء المحتملين

Firecrawl Alexandria هي مكتبة لمزودي البيانات يمكن للوكيل استدعاؤها عبر مفتاح Firecrawl واحد. تضم صفحة Alexandria ‏430 مزوداً و2,461 إمكانية برمجية. يستكشف الوكيل الأداة مجاناً، ويطّلع على مدخلاتها وتكلفتها، ثم يُشغّلها عبر نفس نقطة النهاية scrape التي يستخدمها لصفحات الويب.

بالنسبة لقوائم العملاء المحتملين، تُعد فئة الأشخاص (People) هي الأهم؛ إذ تضم 12 مزوداً، من بينهم Apollo وPeople Data Labs وFullEnrich وData Legion لإثراء البيانات، بالإضافة إلى مصادر عامة مثل قوائم العقوبات وسجل NPI. ويستخدم هذا المقال اثنين منهم:

تعرض صفحة Apollo الخاصة على Alexandria مهارة مدمجة باسم "Search-first prospect list" (قائمة عملاء محتملين تبدأ بالبحث). وتُلخص نبذتها الاستراتيجية بالكامل في سطر واحد: ابحث مجاناً أولاً، واكشف بيانات الأشخاص الذين يستحقون الدفع فقط، ثم ابحث عن رسائل البريد الإلكتروني المهنية المؤكدة بترتيب التكلفة. وتُحوّل اللوحة أدناه هذا السطر إلى أربع مهام مع تحديد المسؤولين عنها.

لماذا يحتاج بناء قائمة العملاء إلى مراحل وليس إلى مطالبة واحدة

تُخفي الجلسة الفردية الواحدة القرار الحاسم الذي يتحكم في التكلفة: من يتم استبعاده قبل إجراء الاستدعاء المدفوع. وتُبرز أسعار Firecrawl هذا الفارق بوضوح.

لنفترض أن Apollo أعادت 40 شخصاً عبر نطاقاتك العشرة المستهدفة. سيكلف إثراء بياناتهم جميعاً بواقع 60 رصيداً للشخص 2,400 رصيد، وهو أكثر من ضعف الرصيد الشهري للخطة المجانية (1,000 رصيد). أما إذا احتفظت مرحلة تأهيل المسميات الوظيفية بـ 12 شخصاً فقط، فستكلف عملية الإثراء 720 رصيداً، وهو ما يقع بالكامل ضمن حدود الخطة المجانية.

قاعدة الاستبعاد هذه قرار تجاري بحت؛ إذ يقرر شخص ما إن كان "رئيس قسم المنصة" (Head of Platform) يُعد مشترياً مستهدفاً أم لا. فعندما يكون هذا القرار مدفوناً داخل مطالبة برمجية، لا يراجعه أحد. أما عندما يكون مهمة محددة مع مسؤول (Assignee)، فإنه يمتلك مالكاً، وحالة واضحة، وسجلاً بكل ما طرأ عليه من تغييرات.

كيفية بناء قائمة عملاء محتملين باستخدام الوكلاء: المهام الأربع

إليك المسار التسلسلي موزعاً كمهام على لوحة العمل. اربط بينها باستخدام خاصية تمنع / معطلة بواسطة (blocks / is blocked by) لكي تنتظر كل مرحلة اكتمال المرحلة التي تسبقها.

الخطوة 1: تحويل ملف العميل المثالي إلى بحث مجاني على Apollo

تُحوّل المهمة الأولى ملف العميل المثالي (ICP) إلى مدخلات بحث يفهمها Apollo. تقبل هذه الإمكانية المعاملات person_titles وq_keywords وq_organization_domains_list وpage وper_page، بحد أقصى 100 نتيجة لكل صفحة. وتُظهر بيئة اختبار Apollo هذا الاستدعاء بتكلفة 0 رصيد.

عملية الاستكشاف مجانية أيضاً. فإذا لم يكن الوكيل يعرف الأداة المناسبة للاستخدام، يسأل Alexandria باستخدام sources: ["alexandria"]. وتشير وثائق Firecrawl إلى أن إضافة "web" إلى المصادر تعيد أيضاً نتائج ويب مدفوعة، لذا احرص على قصر الاستكشاف على الأدوات فقط.

# Free tool discovery: tools only, no paid web results
curl https://api.firecrawl.dev/v2/search \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "find people by job title at a company", "sources": ["alexandria"], "limit": 3}'

# Apollo people search at the target domains (listed at 0 credits)
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "apollo",
    "capability": "people/search",
    "options": {
      "person_titles": ["VP of Engineering", "Head of Platform"],
      "q_organization_domains_list": ["example-one.com", "example-two.com"],
      "page": 1,
      "per_page": 100
    }
  }
}'

تظهر النتيجة تحت المسار alexandria[0].data. وتوصي وثائق Firecrawl بالتحقق من أخطاء كل نتيجة أداة قبل استخدامها، لذا اجعل ذلك جزءاً من معايير القبول: لا تكتمل المهمة إلا بعد أن ينشر الوكيل عدد الصفوف وأي خطأ واجهه.

الخطوة 2: التأهيل بناءً على الحقول التي أعادها البحث بالفعل

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

ضع قواعد الاستبعاد في مكان يقرأه كل وكيل. تجمع ميزة Skill في Sharkly تعليمات قابلة لإعادة الاستخدام لعمل الوكلاء، وبذلك تصبح القواعد مهارة واحدة مرتبطة بكل وكيل لقوائم العملاء، كما هو موضح في مقال المهارات في Sharkly.

# lead-rules.md (owner: the person who approves the send)
keep_titles: ["VP of Engineering", "Head of Platform", "Director of Engineering"]
drop_if: [title_not_in_keep_titles, company_domain_not_in_list, duplicate_person]
max_enrich_calls_per_run: 15
pdl_min_likelihood: 6
every_task_reports: [rows_in, rows_out, credits_spent, errors]

الخطوة 3: إثراء بيانات المؤهلين فقط

هذه هي المرحلة المدفوعة؛ حيث تُسعّر إمكانية person/enrich في People Data Labs بـ 60 رصيداً لكل استدعاء. وتقبل pdl_id أو email أو email_hash كمدخلات كافية، بالإضافة إلى 18 حقلاً اختيارياً آخر. اطلب من الوكيل قراءة شروط المدخلات بالكامل باستخدام findTools قبل ربط حقول البحث بمدخلات الإثراء.

أفضل إعداد لتوفير التكلفة هو min_likelihood، ويتراوح بين 1 و10 وقيمته الافتراضية 2، حيث تشير Firecrawl إلى أن احتمالية صحة التطابق لا تتعدى 10 إلى 30% عند هذه القيمة. رفع هذا المعامل يحول التطابق الضعيف إلى خطأ 404، وتوضح صفحة المزود فائدة ذلك صراحةً: "الخطأ 404 مجاني هنا، بينما السجل الخاطئ ليس مجانياً".

// One enrich call per qualified person; client set up with $FIRECRAWL_API_KEY
const result = await firecrawl.scrape({
  alexandria: {
    provider: "people-data-labs",
    capability: "person/enrich",
    options: {
      email: person.email,      // or pdl_id / email_hash
      min_likelihood: 6,        // weak matches 404 instead of billing a wrong record
      titlecase: true,
    },
  },
});
const record = result.alexandria[0];
if (record.error) report.errors.push(record.error);

تفرض People Data Labs أيضاً حصة استخدام عبر Alexandria: 50,000 استدعاء API سنوياً لكل مؤسسة عميل، مشتركة بين نقاط نهاية الأشخاص والشركات. وتُحسب محاولات إعادة الطلب ضمن هذه الحصة، وتتجدد في 1 يناير حسب توقيت UTC. وهذا سبب إضافي لتحديد سقف لاستدعاءات الإثراء لكل تشغيلة في ملف القواعد.

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

الخطوة 4: مراجعة بشرية قبل التواصل

المهمة الأخيرة يتولاها إنسان؛ حيث يُرفق الوكيل القائمة المُثرَاة ويترك المهمة في انتظار المراجعة البشرية. يتحقق المراجع من عينة بمقارنتها بالملفات الشخصية العامة، ويستبعد أي شخص لا ينبغي التواصل معه، ثم يمنح موافقته.

هذه هي البوابة نفسها التي بيّناها في مقال وكلاء البرمجة مع التدخل البشري (human-in-the-loop). فالقائمة مجرد بيانات، أما التواصل مع شخص ما فهو قرار يوقّعه إنسان.

فاتورة الأرصدة لكل مرحلة

مع تحديد 10 نطاقات مستهدفة، والعثور على 40 شخصاً، وتأهيل 12 منهم، تُعطي الأسعار المعلنة هذه الفاتورة:

يعتمد تحويل الأرصدة إلى دولارات على نوع الخطة، لذا احسبها بدقة بدلاً من التقريب. وفقاً لأسعار Firecrawl بالفوترة الشهرية، تبلغ تكلفة خطة Hobby ‏19 دولاراً مقابل 5,000 رصيد، أي 0.0038 دولار لكل رصيد، وبذلك تكلف 720 رصيداً نحو 2.74 دولار من رصيد الخطة. وتبلغ تكلفة خطة Standard ‏99 دولاراً مقابل 100,000 رصيد، أي 0.00099 دولار لكل رصيد، مما يجعل تكلفة التشغيلة نفسها نحو 0.71 دولار. أما الخطة المجانية، فتوفر 1,000 رصيد شهرياً تغطي ذلك بتكلفة 0 دولار.

وبدون مهمة التأهيل، ستكلف التشغيلة نفسها 2,400 رصيد: أي حوالي 9.12 دولار في خطة Hobby، وهو ما يتجاوز سعة الخطة المجانية. تُعد مهمة التأهيل أرخص بند في الفاتورة، ومع ذلك توفر أكبر قدر من التكلفة.

كيف تحافظ Sharkly على دقة ونزاهة المسار

يتولى Claude Code أو Codex تنفيذ الاستدعاءات، بينما تضبط Sharkly منظومة العمل المحيطة بها.

• مهام مع مسؤولين محددين (Assignees): لكل مرحلة حالة واضحة ومالك مسؤول عنها، سواء كان وكيلاً برمجياً (Agent) أو فريق عمل (Crew) أو شخصاً حقيقياً.
• بقاء المفتاح خارج نص المهمة: عيّن FIRECRAWL_API_KEY في متغيرات البيئة الخاصة بالوكيل، تحت قسم Computer & Runtime، وسيتم تمريره تلقائياً عند بدء تشغيل الوكيل. تُصنّف Sharkly هذه القيم كإعدادات نصية عادية مرئية لمديري الوكلاء وليست تخزيناً سرياً، لذا استخدم مفتاحاً مخصصاً لهذا العمل فقط.
• حالات المراجعة: يمكن للوكيل ترك المهمة في حالة انتظار رد بشري أو مراجعة بشرية، لتصل مباشرةً إلى صندوق الوارد الخاص بالشخص المسؤول.
• سجل التشغيل: تُظهر كل تشغيلة وقت البدء والانتهاء، واستدعاءات الأدوات، وتفاصيل أي فشل، مما يمنح تقرير الأرصدة سجلاً موثقاً يمكن تتبعه.

إذا كنت تفضل عدم إنشاء المهام الأربع يدوياً، يمكن لقائد الفريق تقسيم المهمة الرئيسية إلى هذه المراحل، كما هو موضح في فرق عمل Sharkly. تبدأ خدمة Sharkly مجاناً، ويخضع استخدام النماذج لخطة Claude Code أو Codex المرتبطة ببيئة التشغيل الخاصة بك.

شغّل المسار بجدولة زمنية، وأبقِ المراجعة يدوية

بمجرد أن تعمل المهام الأربع بسلاسة لمدة أسبوع، ضع المهام من 1 إلى 3 ضمن أتمتة (Automation)، بحيث يؤدي إدخال قائمة نطاقات جديدة إلى تشغيل البحث المجاني والإثراء المحدد بسقف أقصى. أما المهمة 4 فتبقى يدوية. ولمتابعة عدة عمليات تشغيل من هذا النوع بالتوازي، راجع كيفية مراقبة وكلاء البرمجة الذين يعملون بالتوازي.

ابدأ بالمراحل المجانية

ابنِ قائمة العملاء المحتملين باستخدام الوكلاء بالطريقة التي توضحها مهارة Apollo: ابحث مجاناً، وأهّل المرشحين بناءً على ما لديك بالفعل، وادفع فقط لمن يجتاز التصفية، واجعل إنساناً يراجع القائمة قبل مراسلة أي شخص. ابدأ بالمهمتين 1 و2 في Sharkly؛ فهما لا تكلفان أي رصيد وتوضحان لك ما ستنفقه في المرحلة المدفوعة.

الأسئلة الشائعة

ما هي Firecrawl Alexandria؟

هي مكتبة لمزودي البيانات يستدعيها الوكلاء عبر مفتاح Firecrawl API واحد. الاستكشاف مجاني، وتحدد كل أداة سعر التنفيذ بالأرصدة الخاص بها. أطلقتها Firecrawl في 22 سبتمبر 2026.

هل البحث عن الأشخاص عبر Apollo مجاني من خلال Firecrawl؟

تُظهر إمكانية people/search الخاصة بـ Apollo تكلفة 0 رصيد في بيئة اختبار Firecrawl. أما الكشف عن تفاصيل الاتصال فهو خطوة منفصلة ومدفوعة، لذا تحقق من السعر المعلن لتلك الإمكانية قبل تشغيلها.

كم تبلغ تكلفة إثراء البيانات عبر People Data Labs على Firecrawl؟

يُسعّر person/enrich بـ 60 رصيداً لكل استدعاء. ويعادل ذلك نحو 0.23 دولار في خطة Hobby و0.06 دولار في خطة Standard، بالفوترة الشهرية. ولا يكلف الخطأ 404 الناتج عن رفع min_likelihood أي شيء.

هل يعمل هذا مع Codex بدلاً من Claude Code؟

نعم، توفر Firecrawl واجهة سطر أوامر (CLI) وحزم تطوير برمجية (SDKs) وخادم MCP يحتوي على firecrawl_search وfirecrawl_find_tools وfirecrawl_scrape، ويمكن لوكيل Sharkly العمل على أي من بيئتي التشغيل. الإعداد العام موضح في مقال مدير مهام الذكاء الاصطناعي: تعيين وتتبع ومراجعة عمل الوكلاء.

هل ينبغي للوكيل إرسال رسائل التواصل من القائمة بمفرده؟

لا. احرص دائماً على أن يكون الإرسال متوقفاً على مهمة مراجعة بشرية. فمهمة الوكيل تنتهي عند تسليم قائمة موثوقة وتقرير بالأرصدة المستهلكة.