// tomba cli
ذكاء البريد الإلكتروني من طرفيتك
ابحث في النطاقات، واعثر على عناوين البريد الإلكتروني، وتحقق من العناوين، وأثرِ جهات الاتصال كل ذلك دون مغادرة الطرفية. ثبّته بأمر واحد. يعمل على macOS وLinux وWindows.
$ tomba verify --target richard@piedpiper.com --json
{
"data": {
"email": {
"email": "richard@piedpiper.com",
"result": "deliverable",
"status": "valid",
"score": 99
}
}
}// 01 · التثبيت
ملف تنفيذي واحد لـ macOS وLinux وWindows
تتحقق سكربتات التثبيت من مجموع SHA-256 للإصدار وتُعدّ الإكمال التلقائي في الطرفية. الإصدارات متاحة على GitHub.
curl -sSL https://releases.tomba.io/install.sh | shbrew install --cask tomba-io/tap/tombairm https://releases.tomba.io/install.ps1 | iexscoop bucket add tomba https://github.com/tomba-io/scoop-bucket.git
scoop install tombasudo snap install tomba// 02 · الأوامر
كل نقطة نهاية من الطرفية
مرّر المُدخل باستخدام --target؛ وأضف --json أو --yaml أو --csv لمخرجات قابلة للقراءة آليًا و--output لكتابة ملف.
tomba searchعناوين البريد الإلكتروني التي تملكها Tomba لنطاق ما
GET /v1/domain-searchtomba finderالبريد الإلكتروني لشخص من اسمه ونطاق شركته
GET /v1/email-findertomba authorالبريد الإلكتروني لمؤلف مقال
GET /v1/author-findertomba enrichالشخص وراء عنوان بريد إلكتروني
GET /v1/enrichtomba enrichment personملف شخص من بريد إلكتروني
GET /v1/people/findtomba enrichment companyملف شركة من نطاق
GET /v1/companies/findtomba enrichment combinedالشخص والشركة في طلب واحد
GET /v1/combined/findtomba verifyما إذا كان عنوان البريد الإلكتروني قابلًا للتسليم
GET /v1/email-verifiertomba linkedinالبريد الإلكتروني لملف شخصي على LinkedIn
GET /v1/linkedintomba sourcesالصفحات العامة التي عُثر فيها على العنوان
GET /v1/email-sourcestomba countعناوين نطاق ما، حسب القسم والأقدمية
GET /v1/email-counttomba statusما إذا كان النطاق بريدًا عبر الويب أو مؤقتًا
GET /v1/domain-statustomba formatأنماط العناوين التي يستخدمها النطاق
GET /v1/email-formattomba locationأعداد موظفي الشركة حسب الموقع
GET /v1/locationtomba autocompleteشركات ونطاقات من جزء من الاسم
GET /v1/domain-suggestionstomba phone-finderأرقام الهاتف من بريد إلكتروني أو نطاق أو ملف شخصي على LinkedIn
GET /v1/phone-findertomba phone-validatorما إذا كان رقم الهاتف صالحًا، وصيغه ومشغّل شبكته
GET /v1/phone-validatortomba revealشركات من استعلام بلغة طبيعية أو من عوامل تصفية
POST /v1/reveal/searchtomba similarشركات مشابهة لنطاق
GET /v1/similartomba technologyالتقنيات المستخدمة في موقع النطاق
GET /v1/technologytomba lead · leads-list · attributeإدارة العملاء المحتملين وقوائمهم والسمات المخصّصة
/v1/leads, /v1/leads_lists, /v1/attributestomba flag create · listالإبلاغ عن بيانات خاطئة وعرض بلاغاتك
POST /v1/flag, GET /v1/flagtomba key list · get · create · deleteإدارة مفاتيح API لمساحة عملك
/v1/keystomba whoami · usage · logsحسابك والاستخدام اليومي والطلبات الأخيرة
GET /v1/me, /v1/usage, /v1/logs
| الأمر | تُعيد | يستدعي |
|---|---|---|
| tomba search | عناوين البريد الإلكتروني التي تملكها Tomba لنطاق ما | GET /v1/domain-search |
| tomba finder | البريد الإلكتروني لشخص من اسمه ونطاق شركته | GET /v1/email-finder |
| tomba author | البريد الإلكتروني لمؤلف مقال | GET /v1/author-finder |
| tomba enrich | الشخص وراء عنوان بريد إلكتروني | GET /v1/enrich |
| tomba enrichment person | ملف شخص من بريد إلكتروني | GET /v1/people/find |
| tomba enrichment company | ملف شركة من نطاق | GET /v1/companies/find |
| tomba enrichment combined | الشخص والشركة في طلب واحد | GET /v1/combined/find |
| tomba verify | ما إذا كان عنوان البريد الإلكتروني قابلًا للتسليم | GET /v1/email-verifier |
| tomba linkedin | البريد الإلكتروني لملف شخصي على LinkedIn | GET /v1/linkedin |
| tomba sources | الصفحات العامة التي عُثر فيها على العنوان | GET /v1/email-sources |
| tomba count | عناوين نطاق ما، حسب القسم والأقدمية | GET /v1/email-count |
| tomba status | ما إذا كان النطاق بريدًا عبر الويب أو مؤقتًا | GET /v1/domain-status |
| tomba format | أنماط العناوين التي يستخدمها النطاق | GET /v1/email-format |
| tomba location | أعداد موظفي الشركة حسب الموقع | GET /v1/location |
| tomba autocomplete | شركات ونطاقات من جزء من الاسم | GET /v1/domain-suggestions |
| tomba phone-finder | أرقام الهاتف من بريد إلكتروني أو نطاق أو ملف شخصي على LinkedIn | GET /v1/phone-finder |
| tomba phone-validator | ما إذا كان رقم الهاتف صالحًا، وصيغه ومشغّل شبكته | GET /v1/phone-validator |
| tomba reveal | شركات من استعلام بلغة طبيعية أو من عوامل تصفية | POST /v1/reveal/search |
| tomba similar | شركات مشابهة لنطاق | GET /v1/similar |
| tomba technology | التقنيات المستخدمة في موقع النطاق | GET /v1/technology |
| tomba lead · leads-list · attribute | إدارة العملاء المحتملين وقوائمهم والسمات المخصّصة | /v1/leads, /v1/leads_lists, /v1/attributes |
| tomba flag create · list | الإبلاغ عن بيانات خاطئة وعرض بلاغاتك | POST /v1/flag, GET /v1/flag |
| tomba key list · get · create · delete | إدارة مفاتيح API لمساحة عملك | /v1/keys |
| tomba whoami · usage · logs | حسابك والاستخدام اليومي والطلبات الأخيرة | GET /v1/me, /v1/usage, /v1/logs |
// 03 · المهام المجمّعة
عالج ملف CSV من جهازك
يرسل tomba bulk طلب API واحدًا لكل صف ويكتب النتائج في ملف CSV جديد مع اكتمال الصفوف. يُفوتر كل صف ويخضع لحدود المعدّل مثل الطلب الفردي؛ وللمهام على الخادم، استخدم Bulk API.
# One API request per row, from your machine
tomba bulk --file leads.csv --type verify --column "Email Address"
tomba bulk --file prospects.csv --type finder --domain-col company_domain --first-col first --last-col last
tomba bulk --file domains.csv --type search --domain-col domain --output domain-search.csv- tomba bulk
- يعمل على جهازك، طلب واحد لكل صف، ويُفوتر كل منها مثل استدعاء فردي
- POST /v1/bulk/{type}
- يعمل على خوادم Tomba كمهمة واحدة، ويُفوتر عند أول تنزيل
// 04 · تسجيل الدخول
تسجيل الدخول عبر المتصفح أو بمفتاح API
يستخدم tomba login تدفق الأجهزة في OAuth 2.0، لذا يعمل عبر SSH؛ أما للسكربتات فسجّل الدخول بمفتاح. تُحفظ بيانات الاعتماد في ~/.tomba.json.
tomba logintomba login --api-key
tomba whoamitomba verify --target richard@piedpiper.com --key "$TOMBA_API_KEY" --secret "$TOMBA_SECRET_KEY"--json أو --yaml أو --csv للحصول على مخرجات قابلة للقراءة آليًا. مرّرها إلى jq للتصفية، أو أعد توجيهها إلى ملفات، أو استخدمها في سكربتات shell ومهام cron وخطوط CI/CD.