في نهاية هذا الدليل، سيبحث وكيل الذكاء الاصطناعي لديك (Claude أو ChatGPT أو Cursor أو Grok أو أي أداة تتحدث MCP أو HTTP) في 630.7 مليون جهة اتصال، ويعدّ الأسواق مجانًا، ويصدّر عناوين بريد موثّقة من تلقاء نفسه. سنسلك المسار كاملًا مرة واحدة وببطء، مع توضيح كل تفرع: ما الذي ستراه عندما ينجح، وما معناه عندما لا ينجح.
ما تحتاجه قبل أن تبدأ
ابدأ بعنوان بريد يمكنك تأكيده وبيئة وكيل مدعومة. والاشتراك ليس طريق الفوترة الوحيد؛ إذ يمكن للإجراءات المسموح بها استخدام محفظة مسبقة الدفع.
الحسابات الجديدة تحصل على فترة تجريبية لمدة 7 أيام بعد تأكيد البريد الإلكتروني: 100 رصيد و300 رسالة حملات، دون اشتراك تلقائي؛ وعند انتهائها تتوقف الحملات مؤقتًا وتنتهي أرصدة الفترة التجريبية غير المستخدمة إلى أن تُضاف خطة أو أرصدة الدفع حسب الاستخدام. التطبيق وREST API وCLI وMCP تشترك في الحساب والرصيد نفسيهما؛ وربط عميل آخر أو إنشاء مفتاح API لا يضيف منحة ثانية. الأرصدة والاشتراكات الحالية لا تتغير.
استخدم اتصال OAuth MCP عندما يدعم عميلك خوادم MCP البعيدة المخصصة. وإلا فاستخدم CLI من طرفية تدعم Node/npm، أو REST من بيئة HTTP مخوّلة. لصق مفتاح شخصي في محادثة لا يُنشئ اتصالًا ولا يتجاوز قيود العميل.
البحث والعدّ والمعاينات المخفية لا تخصم أرصدة. وتظل صلاحيات الحساب وحدود السرعة سارية.
اشترط موافقة صريحة على النطاق وحد الصفوف وميزانية الأرصدة قبل الكشف أو إثراء الأشخاص أو تصدير جديد، وقبل إطلاق حملة أو إرسال رد. تسميات أدوات العميل ليست ضمانًا عامًا للتأكيد؛ وأوامر CLI غير التفاعلية يمكن أن تنفق فورًا.
الخطوة 1: أنشئ الحساب عبر مسار الوكيل
افتح app.argorant.com/start. سترى بابين: أحدهما للعمل في التطبيق، والآخر لإعداد وكيل. اختر جهة الوكيل.
سجّل بصندوق بريد دائم، وأكّد العنوان بالرمز الذي يصلك في بريدك. وهنا تفرعان:
- "أرصدة البداية تتطلب عنوان بريد دائمًا." لقد استخدمت نطاق بريد مؤقت. استخدم بدلًا منه صندوق بريد للعمل أو صندوقًا شخصيًا؛ فصناديق البريد المؤقتة لا تتأهل أبدًا للأرصدة المجانية.
- رسالة التأكيد لا تصل. تحقق من البريد العشوائي أولًا، ثم اطلب رمزًا جديدًا من الشاشة نفسها. فالرموز تنتهي صلاحيتها، ولا يُعتد إلا بأحدثها.
الخطوة 2: اختر OAuth أو أنشئ مفتاح API شخصيًا
مع MCP البعيد، اتصل عبر OAuth بحسابك في Argorant، ولا تلصق مفتاحًا شخصيًا في عنوان MCP. ومع CLI أو REST، أنشئ مفتاحًا شخصيًا في /start أو في الملف الشخصي. وقد يحصل أول مفتاح مؤهل على منحة البداية المذكورة أعلاه. تحقق من رصيد الحساب المُعاد قبل أن تعد بمخرجات مجانية.
يبدأ المفتاح بـ ag_live_ ويظهر كاملًا مرة واحدة بالضبط. احفظه كما تحفظ كلمة المرور. وإذا فقدته، فألغِه وأنشئ مفتاحًا جديدًا؛ ولن يتغير أي شيء آخر في الحساب.
إذا رُفض إنشاء المفتاح برسالة "أرصدة البداية لهذا الصندوق تم استلامها بالفعل"، فهذا يعني أن حسابًا على العنوان نفسه بعد توحيده قد استخدم المنحة المجانية (إضافات علامة + والنقاط في Gmail لا تُنشئ صناديق بريد جديدة). اشحن المحفظة أو اختر خطة، وسيُنشأ المفتاح بشكل طبيعي في الحالتين.
الخطوة 3: اربط وكيلك
هناك طريقتان للاتصال؛ اختر ما يدعمه وكيلك.
الخيار A: MCP (Claude و ChatGPT و Cursor و Grok Bot)
أضف https://mcp.argorant.com/mcp في عميل يدعم MCP البعيد و OAuth. سجّل الدخول ووافق على الصلاحيات المطلوبة. يضم الكتالوج الحالي 104 أدوات للعثور على الأشخاص وجهات الاتصال وأرقام الهاتف، والقوائم والتصدير، وفحص قوائم بريدك الخاصة، والحملات، والردود، وصناديق البريد، والأرصدة. وحدد قواعد صريحة للإنفاق والمخرجات قبل البدء.
الخيار B: REST بمفتاح شخصي في بيئة HTTP مصرّح بها
كل نقاط النهاية تقع تحت https://app.argorant.com/api/mcp/ مع Authorization: Bearer ag_live_.... وهذه الثلاث ستستخدمها باستمرار:
الخطوة 4: المهمة الحقيقية الأولى
أعطِ الوكيل مهمة محددة: "اعدد المديرين الماليين في شركات التقنية المالية الألمانية على Argorant، واعرض لي عينة، وأخبرني بتكلفة تصدير أفضل 500."
التشغيل السليم يُعيد العدد الفعلي، بما في ذلك الصفر إذا لم تطابق أي سجلات، ومعاينة مخفية، وتكلفة الأرصدة المطبقة. وعدد جهات الاتصال ليس عددًا للشركات الفريدة، ولا دليلًا على أن كل بريد تم التحقق منه بالفعل. وتبقى بيانات الاتصال مخفية في هذه المرحلة عن قصد: الأحرف الأولى، والدور، والشركة، والموقع، دون العنوان. هذا ليس خللًا، بل هو سبب أن الاستكشاف لا يكلّف شيئًا.
الخطوة 5: التصدير، والتكلفة الفعلية
عندما تبدو القائمة صحيحة، دع الوكيل يصدّرها. الآن، والآن فقط، تُستهلك الأرصدة: رصيد واحد لكل جهة اتصال قابلة للتسليم. ويجري التحقق مباشرة وقت التصدير، والعناوين التي تفشل تُزال ولا تكلّف شيئًا. فتصدير من 500 صف يجتاز التحقق فيه 460 عنوانًا يُحتسب بـ 460 رصيدًا، ويحتوي ملف CSV الذي تنزّله على 460 صفًا كانت قابلة للتسليم قبل دقائق.
التفرعات التي قد تواجهها:
- 402، "الوصول عبر API و MCP يتطلب خطة أو أرصدة في المحفظة." نفدت أرصدة البداية. اشحن المحفظة (500 رصيد مقابل $17.50، دون اشتراك) أو اختر خطة. فالمحفظة هي المسار المصمم للوكلاء: مال يدخل، وعملاء محتملون يخرجون، ولا شيء متكرر.
- 429، حد المعدل. الوكيل يرسل طلبات أكثر من اللازم. المحفظة والخطط الأعلى ترفع السقف، والوكيل المبني جيدًا يجمع عمليات العدّ بدلًا من تكرار فلتر واحد في كل مرة.
- التصدير أصغر من العدد. هذا سلوك صحيح: العدد هو كامل نطاق التطابقات، والتصدير هو الجزء القابل للتسليم بعد التحقق المباشر وبعد إزالة الصفوف التي صدّرتها سابقًا.
إلى أين بعد ذلك
أصبح وكيلك متصلًا وأنتج أول قائمة موثّقة. والدليل التالي يعلّمك الجزء الذي تتراكم فائدته فعلًا: بناء قائمة مستهدفة دقيقة بفلاتر القطاع والمستوى الوظيفي والكلمات المفتاحية، وترك الوكيل يوسّع السوق أو يضيّقه بأمر منك.
