سطر الأوامر
كل شيء من الطرفية باستخدام npx argorant. مخرجات JSON للسكربتات والوكلاء، وصفحات مع مؤشر، وإعادة محاولة آمنة، ورموز خروج يمكنك التصرف بناءً عليها.
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-seniority | C-Level, VP, Director, Manager, Senior, Entry, Intern |
--department | --exclude-department | Sales و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 كل فلتر يمكنك استخدامه.
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في السكربتات. - يمكن تسمية الحملة بمعرّفها أو ببداية اسمها.
من البحث إلى حملة قيد التشغيل
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"أرسل الأشخاص إلى أدواتك الأخرى
أرسل عملية تصدير إلى أداة الإرسال التي تستخدمها بالفعل، في حسابك الخاص هناك. تُرسل القائمة في صورة عملية التصدير الخاصة بها. متاح بدءًا من خطة Pro.
التكاملات
أرسل الأشخاص الذين تجدهم في Argorant إلى الأدوات التي تستخدمها بالفعل، أو استدعِ Argorant من عمليات الأتمتة الخاصة بك.