用途:@sendblue/cli 是 Node 命令行工具,可在 shell、脚本或 Claude Code 钩子中发送 iMessage/SMS,并完成账户创建、号码开通、联系人与消息管理。适合“任务完成后短信通知我”等一次性脚本场景;需要收发 webhook、发送样式、表情回应、群发、状态回调、媒体上传时,应改用 HTTP API。
主要能力:安装后暴露 sendblue 命令,支持 setup(创建账户、邮箱验证、设置公司名、添加首个联系人)、login、send、messages(按收发方向和数量列出)、add-contact、contacts、status、whoami。提供交互式 setup 及面向 CI 的两步非交互模式。
使用方式:npm install -g @sendblue/cli,或 npx @sendblue/cli <command>。非交互 setup 第一步发送 8 位验证码:sendblue setup --email you@example.com;第二步完成:sendblue setup --email you@example.com --code 12345678 --company my-co --contact +15551234567。发送示例:sendblue send +15551234567 'Hello from Sendblue!'。查询:sendblue messages --inbound --limit 20。电话号码必须为 E.164 格式。凭据保存在 ~/.sendblue/credentials.json(权限 600),无需环境变量。
限制:以出站为主,无内置入站 webhook 服务器;不暴露发送样式/特效、表情回应、群发、状态回调、媒体上传及超出基础 CRUD 的联系人 API。免费套餐下,联系人须先给你的 Sendblue 号码发送一次短信,出站发送才能成功。不要使用 sudo,否则凭据写入 root 家目录导致后续非 sudo 运行读不到。发送、联系人或账户操作属于状态变更,建议先预览并等待用户确认。