GoodVerify 是一个用于验证邮箱、电话号码和邮寄地址的命令行工具,通过调用 goodverify.dev 的 API 提供服务。它提供单一静态二进制文件(约1MB),无外部依赖,便于安装和运行。用户可以通过斜杠命令 /goodverify 加上子命令来使用各项功能。
主要子命令及其用途如下:
- install:安装 goodverify CLI。支持 macOS/Linux 通过 curl 脚本安装,Windows 通过 PowerShell 脚本安装。安装后可用 goodverify --version 验证。
- configure:配置 API 密钥和环境。配置文件默认位于 ~/.goodverify.json(Windows 为 %USERPROFILE%.goodverify.json)。支持通过 --env、--url、--key 参数设置,交互式引导也可。首次配置的环境为默认环境,重复配置相同环境会更新值。密钥类型:sk_ 开头为读写密钥(批量操作必需),pk_ 开头为只读密钥(单条验证足够)。
- verify:验证邮箱、电话或地址。对于邮箱,使用 --email 参数;对于电话,使用 --phone 参数,可选 --country 指定国家代码(未提供时默认 US);对于地址,可使用 --address 传入完整地址字符串,或使用 --street、--city、--state、--zip 等结构化字段。结果默认美观打印,添加 --json 输出原始 JSON。
- batch:管理批量验证任务。支持 create(从 JSON 或 CSV 文件创建任务,也可使用内联 JSON)、list(列出任务)、get(获取任务详情)、results(下载已完成任务的结果)、sample(下载 CSV 模板)。创建任务时若无文件,可先运行 batch sample 生成模板。
- usage:显示 API 使用情况和信用余额,支持 --json 输出。
- health:检查 API 健康状态,无需认证,可指定 --url。若失败,建议检查 URL、网络连接或本地服务器状态。
- help:显示帮助信息,列出所有子命令。
全局选项包括:--env 指定环境,--key 覆盖 API 密钥,--url 覆盖基础 URL,--json 输出原始 JSON。
使用方式:在支持斜杠命令的界面中输入 /goodverify 加子命令和参数,例如 /goodverify verify email user@example.com。除 install 和 help 外,其他子命令执行前会检查 goodverify 是否已安装,若未安装则提示先运行 /goodverify install。
适用场景:需要批量或单条验证联系信息(邮箱、电话、地址)的开发者、数据分析师或运营人员,可通过命令行快速集成验证流程。限制:需要有效的 API 密钥(可从 goodverify.dev 获取),批量操作需读写密钥,单条验证可使用只读密钥。关于定价、具体验证准确率等详细信息暂未提供。