ArgorantDocs

سطر الأوامر

كل شيء من الطرفية باستخدام npx argorant. مخرجات JSON للسكربتات والوكلاء، وصفحات مع مؤشر، وإعادة محاولة آمنة، ورموز خروج يمكنك التصرف بناءً عليها.

Shell
npx argorant login           # paste a key from app.argorant.com/profile once
npx argorant account         # plan, credits, request limit, campaign emails

يشغّل npx الأداة دون تثبيت. لتثبيتها بشكل دائم، شغّل npm install -g argorant. تقرأ الأداة المفتاح من argorant login أو من المتغير ARGORANT_API_KEY.

الأوامر

الأمرما يفعله
accountالخطة والأرصدة وحد الطلبات ورسائل الحملات
count "<words>" [filters]عدّ الأشخاص المطابقين، مجانًا
search "<words>" -n 10معاينة مقنّعة، مجانًا
company <domain>عدد الأشخاص في شركة واحدة، مجانًا
companies count / search / peopleالشركات التي تطابق فلاترك، مجانًا
lookup industries / countries / keywords / technologies / titles [text]الأسماء الدقيقة التي تفلتر بها، مجانًا
filtersكل فلتر بحث مع خياراته وقيمه، وأيها جاهز الآن، مجانًا
reveal "<words>" -n 25التفاصيل الكاملة مع عناوين بريد تم فحصها، يستهلك أرصدة
enrich --email a@b.com / --name "..." --domain d / --domain dإكمال سجل واحد
find "Jane Doe" --domain acme.com / find --file people.csv -o found.csv --max-credits 100العثور على عناوين بريد العمل: رصيد واحد عند العثور عليه، و0.25 عندما لا يُعثر على شيء
find status / download / resume / cancel <job_id>, find pricingقوائم الباحث عن البريد الإلكتروني وأسعاره
lists ls / create / show / people / rename / rm / exportالقوائم المحفوظة
lists remove-people <id> --title Intern --preview / --ids a,bإخراج أشخاص من قائمة محفوظة. يعدّ أولًا ثم يسأل، و--preview يعدّ فقط. إضافة البحث نفسه مرة أخرى تستبعدهم
export "<words>" -n 1000 -o leads.csvملف CSV لجهات اتصال تم فحصها، يستهلك أرصدة
exports ls / status / downloadعمليات التصدير الخاصة بك
verify <email> / verify --file emails.csv -o checked.csvفحص عناوين البريد التي لديك بالفعل
campaigns list / create / update / status / deleteالحملات وإعداداتها
campaigns update <c> --no-skip-shared-bounces / --skip-shared-bouncesالإبقاء على العناوين التي ارتدت لدى مستخدمي Argorant الآخرين، أو استبعادها (الافتراضي)
campaigns emails set <c> --step 1 --subject ... --body-file fالرسائل
campaigns leads add <c> --list <id> / leads list / leads removeالأشخاص في الحملة
campaigns leads add <c> --list <id> --grades validالإجابة عندما تسأل الإضافة عن العناوين التي تُضاف. يضيف valid (موصى به) العناوين الصالحة فقط، ويضيف valid,catch_all عناوين catch-all أيضًا
campaigns leads remove <c> --not-replied --status queued --preview / leads jobs <c>إخراج كثير من الأشخاص دفعة واحدة مع معاينة أولًا، ومتابعة عمليات الإضافة والإزالة الكبيرة
campaigns leads tag <c> <tag> --file ids.csv / leads remove <c> --tag <tag>وسم الأشخاص، ثم إخراجهم أو إعادتهم أو نقلهم أو سردهم حسب الوسم
campaigns leads restore <c> --tag <tag> / --all-removedإعادة الأشخاص الذين أُخرجوا ولم تُرسل إليهم أي رسالة، مع معاينة أولًا
campaigns leads move <c> --to <c2> --tag <tag>نقل أشخاص إلى حملة أخرى مع حقولهم الخاصة، مع معاينة أولًا
campaigns personalize import <c> lines.csvأسطر شخصية لكثير من الأشخاص من ملف واحد
campaigns test <c> --step 1رسالة اختبار واحدة إليك، دون إضافة أحد
campaigns folders / folders create --name / move <c> --folder <f>مجلدات للحملات
campaigns list --folder <f> / --no-folderحملات مجلد واحد، أو الحملات التي ليست في أي مجلد
campaigns senders set <c> --all / senders list / senders removeصناديق البريد المرسِلة
campaigns launch / pause / stop <c>بدء الإرسال أو إيقافه. يسأل الإطلاق أولًا، و-y يتجاوز السؤال
campaigns analytics <c> --days 30 / campaigns replies <c>نتائج حملة واحدة وردودها
inbox list / read / reply / forward / classifyكل رد في مكان واحد
inbox stages / stages add / set / rmمراحل مسار المبيعات الخاصة بك للردود
inboxes list --status needs_attention --tag t / set / disconnect / connect-googleصناديق البريد الخاصة بك
inboxes update --domains a.com --daily-limit 30تغيير كثير من صناديق البريد دفعة واحدة، مع معاينة أولًا
inboxes set <mailbox> --name "Elena Vaughn"اسم المرسِل الذي يراه الناس، صندوق بريد واحد في كل مرة
inboxes tags / inboxes tag --order <id> --add "Q4 push" / inboxes order-tags <id> --add "Q4 push"وسوم صناديق البريد مع أعدادها، والوسوم لكثير من صناديق البريد دفعة واحدة (مع معاينة أولًا)، ووسوم الطلب التي تصل أيضًا إلى صناديق البريد التي ينشئها لاحقًا (الدليل)
inboxes test-smtp / connect-smtp / connect-smtp --csv / presetsصناديق بريد من أي مزوّد (الدليل)، وتُطلب كلمة المرور منك أو تُقرأ من متغير بيئة، ولا تُؤخذ أبدًا من سطر الأوامر
inboxes quote / order / status / renewalصناديق بريد جديدة على نطاقات جديدة
blocklist list / add / remove / jobالعناوين والنطاقات التي لا يُتواصل معها أبدًا. يعرض list 50 عنوانًا في كل مرة (--all، --search، --campaign)، ويقبل add وremove قيمًا كثيرة أو --file list.csv (في استدعاءات من 5,000)، و--campaign لحملات بعينها و--dry-run
webhooks ls / add / set / test / deliveries / rmأحداث تُرسل إلى خادمك، ابتداءً من خطة Pro

الفلاتر

يقبل كل أمر بحث (count، search، reveal، export، lists create، والإضافة إلى قائمة، companies) الفلاتر نفسها التي يقبلها التطبيق وAPI وموصِّل Claude. الفاصلة تعني أيًا منها. لكل فلتر يقبل قائمة قيم فلترٌ توأم للاستبعاد يزيل كل من كان فلتر التضمين سيجدهم للقيم نفسها، ويمكن استخدام الاثنين معًا.

التضمينالاستبعادما يطابقه
--title--exclude-titleالمسميات الوظيفية، والصيغ المختصرة تعمل في الاتجاهين (CFO، Chief Financial Officer)
--keywords--exclude-keywordsكلمات تصف ما تفعله الشركة، مثل fintech (--keyword-scope people لمهارات الأشخاص أنفسهم)
--industry--exclude-industryالقطاعات بكلمات بسيطة
--country--exclude-countryالدول أو المناطق مثل DACH وNordics وAPAC
--state--exclude-stateالولايات أو المقاطعات، بالاسم أو الرمز
--city--exclude-cityالمدن
--seniority--exclude-seniorityC-Level, VP, Director, Manager, Senior, Entry, Intern
--department--exclude-departmentSales وMarketing وEngineering وFinance والأقسام الأخرى
--domain--exclude-domainمواقع الشركات، مثل stripe.com

كيف تتطابق الكلمات:

  • يتطلب --title-match words (الافتراضي) كل كلمة ككلمة كاملة، لذا لا تطابق Data كلمة Database. ويتطلب exact المسمى الوظيفي كاملًا، لذا لا يطابق CEO المسمى Founder & CEO. ويجد contains النص في أي مكان، حتى داخل كلمة.
  • تبحث الكلمات المفتاحية افتراضيًا فيما تفعله الشركة (اسمها ووسومها وقطاعها ووصفها). ويبحث --keyword-scope people في مهارات الأشخاص أنفسهم وملفاتهم الشخصية، ويبحث any في الاثنين معًا إضافة إلى المسميات الوظيفية.
  • يطابق --industry-match primary القطاع الرئيسي للشركة فقط، لذا يستبعد Software بائع تجزئة أو بنكًا يحمل أيضًا وسم Software. ويطابق any (الافتراضي) أيًا من قطاعاتها.
  • يحتسب --country-match person (الافتراضي) مكان إقامة الشخص، ويستبعد الأشخاص الذين لا يُعرف مكانهم. ويستخدم person_or_company دولة الشركة لهؤلاء.

توجد فلاتر أخرى أيضًا، مثل --employees 51-200، و--employees-min و--employees-max، و--revenue 10m-50m، و--revenue-min و--revenue-max، و--company (لعدة شركات: اربط الأسماء بـ |)، و--has-phone و--has-linkedin. يسرد npx argorant filters كل فلتر يمكنك استخدامه.

Shell
npx argorant count --title "VP Sales" --title-match exact --country DACH --exclude-country Switzerland
npx argorant export --keywords fintech --exclude-keywords "venture capital, private equity" -n 500 -o fintech.csv

تمتلئ القائمة المحفوظة في الخلفية. يوضح lists show <id> ما إذا كانت لا تزال تمتلئ، والإضافة إلى قائمة لا تزال تمتلئ تنتظر دورها.

مصمّم للسكربتات والوكلاء

  • يطبع --json مع أي أمر إجابة API كما هي.
  • تطبع القوائم مؤشرًا أسفل كل صفحة. مرّره باستخدام --cursor، أو أضف --all لقراءة كل الصفحات.
  • تحصل كل عملية كتابة على Idempotency-Key جديد. مرّر --idempotency-key <key> لتختار مفتاحك الخاص، فيعيد تشغيل الأمر نفسه مرة أخرى الإجابة الأولى بدلًا من تنفيذ العمل مرتين.
  • رموز الخروج هي 0 للنجاح، و1 للخطأ (ولـ find دون نتيجة)، و2 لمفتاح مفقود أو خاطئ، و3 لنطاق صلاحيات مفقود، و4 لحدود السرعة أو الحد اليومي، و5 عندما تلزم خطة أو أرصدة أكثر، و6 عندما يلزم اختيار أولًا ولم يتغير شيء (يسأل campaigns leads add عن أنواع العناوين التي تُضاف).
  • الأوامر التي تغيّر كثيرًا من الأشخاص أو صناديق البريد (leads remove، leads restore، leads move، lists remove-people، inboxes tag، inboxes update) تعدّ أولًا ثم تسأل. يعدّ --preview فقط، ويتجاوز --yes السؤال.
  • تطبع الأخطاء الرمز والرسالة الواضحة ومعرّف الطلب.
  • الأوامر التي تستهلك أرصدة تسأل أولًا في الطرفية. ولا تسأل عندما لا تكون المخرجات طرفية، أو مع --yes أو --json، لذا تحقق من قيمة -n في السكربتات.
  • يمكن تسمية الحملة بمعرّفها أو ببداية اسمها.

من البحث إلى حملة قيد التشغيل

Shell
npx argorant lists create --name "UK finance leaders" --title "CFO, Finance Director" --country "United Kingdom"
npx argorant campaigns create --name "UK finance Q4" --daily-limit 40 --timezone Europe/London
npx argorant campaigns emails set "UK finance" --step 1 --subject "Quick question, {{first_name}}" --body-file step1.txt
npx argorant campaigns leads add "UK finance" --list 1240
# when the list also holds catch-all or unchecked addresses, it asks first and adds nothing (exit code 6):
npx argorant campaigns leads add "UK finance" --list 1240 --grades valid
# business emails only: add --exclude-private-emails (free mail and home internet addresses are left out)
npx argorant campaigns senders set "UK finance" --all
npx argorant campaigns launch "UK finance"

في هذه الصفحة