BillionVerify LogoBillionVerify

CLI Tools

为 CLI 工具提供邮箱验证能力。包含 Claude Code、Codex、Gemini CLI 等 AI CLI 工具的集成指南。

AI 驱动的 CLI 工具可以直接调用 BillionVerify 在开发、调试和自动化工作流期间验证邮箱。

支持的 CLI 工具

BillionVerify CLI

除了 AI 驱动的工具外,BillionVerify 还提供自己的 CLI 用于直接验证:

安装

npm install -g billionverify

配置

bv config set api-key YOUR_API_KEY

或使用环境变量:

export BV_API_KEY=your-api-key

基本命令

# 验证单个邮箱
bv verify user@example.com

# JSON 输出
bv verify user@example.com --json

# 验证多个邮箱
bv verify user1@example.com user2@test.com

# 从文件验证
bv verify --file emails.txt

# 检查积分
bv credits

输出格式

可读格式(默认):

Email: user@example.com
Status: valid
Score: 0.95
Deliverable: yes
Disposable: no
Role: no

JSON 输出:

bv verify user@example.com --json
{
  "email": "user@example.com",
  "status": "valid",
  "result": {
    "deliverable": true,
    "disposable": false,
    "role": false
  },
  "score": 0.95
}

退出码

代码含义
0成功,邮箱有效
1邮箱无效
2邮箱状态未知
3API 错误
4配置错误

在脚本中使用:

if bv verify --quiet user@example.com; then
  echo "Email is valid"
else
  echo "Email is invalid or verification failed"
fi

Shell 集成

将这些函数添加到您的 .bashrc.zshrc:

# 快速邮箱验证
vmail() {
  bv verify "$1" --color
}

# 验证并复制结果
vmail-copy() {
  bv verify "$1" --json | pbcopy
  echo "Result copied to clipboard"
}

# 检查邮箱是否有效(返回 0 或 1)
is-valid-email() {
  bv verify "$1" --quiet &>/dev/null
}

管道和自动化

# 从 stdin 管道输入
echo "test@example.com" | bv verify --stdin

# 管道到其他命令
bv verify test@example.com --json | jq '.score'

# 从文件中提取并验证邮箱
grep -oE '[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}' document.txt | \
  xargs -I {} bv verify {} --quiet

下一步

On this page