// tomba cli

终端中的电子邮件智能工具

搜索域名、查找邮箱、验证地址、丰富联系人信息无需离开终端。一条命令即可安装。适用于 macOS、Linux 和 Windows。

macOS · Linux · Windows输出 JSON、YAML 或 CSVOAuth 设备登录

zsh

$ 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 校验和并设置 shell 补全。发布版本可在 GitHub 上获取。

install tomba

curl -sSL https://releases.tomba.io/install.sh | sh

brew install --cask tomba-io/tap/tomba

irm https://releases.tomba.io/install.ps1 | iex

scoop bucket add tomba https://github.com/tomba-io/scoop-bucket.git
scoop install tomba

sudo snap install tomba

// 02 · 命令

在终端中使用每个端点

使用 --target 传入输入；添加 --json、--yaml 或 --csv 获取机器可读的输出，使用 --output 写入文件。

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

命令	返回	调用
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。每一行的计费和速率限制与单个请求相同；如需服务器端任务，请使用批量 API。

tomba bulk

# 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 服务器上运行，首次下载时计费

批量 API 参考

// 04 · 登录

浏览器登录或 API 密钥

tomba login 使用 OAuth 2.0 设备流程，因此可通过 SSH 使用；在脚本中请使用密钥登录。凭据保存在 ~/.tomba.json 中。

tomba login

tomba login

tomba login --api-key
tomba whoami

tomba verify --target richard@piedpiper.com --key "$TOMBA_API_KEY" --secret "$TOMBA_SECRET_KEY"

// 常见问题

Tomba CLI 常见问题

还有其他问题？访问帮助中心