1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | twilio-lookup-phone-intelligence-twilio-ai |
| 作者/维护者 | Twilio(官方) |
| 来源链接 | https://github.com/twilio/ai/tree/main/skills/twilio/twilio-lookup-phone-intelligence |
| 许可证 | MIT |
| GitHub Stars / Forks | 39 / 21(所属仓库整体数字,不代表本技能自身热度;GitHub API,2026-11-03 读取) |
| 最新版本 | 无版本标签;仓库主分支最近一次提交 2026-10-22 |
| 安装方式 | 把技能目录复制进 agent 的 skills 目录;另需 Twilio 账号、TWILIO_ACCOUNT_SID / TWILIO_AUTH_TOKEN 与官方 SDK |
数据来源:上述数字取自 GitHub API;功能与评分依据来自技能正文与 Twilio 官方文档。
2. 功能介绍与亮点
一句话:在发短信或打电话之前,先把号码验一遍并评估风险——是否有效、是手机还是 VoIP、有没有换过 SIM 卡、是否像短信轰炸。
- 基础校验免费:号码有效性、E.164 格式、国家与国内格式,走免费的 Lookup v2 基础档。
- 线路类型:区分手机、固话与 VoIP,直接影响短信到达率与风控策略。
- SIM 换卡检测:号码近期是否换过卡,是账号接管与验证码劫持的常用信号。
- 来电人姓名与身份匹配:给定姓名与号码,判断是否匹配,适合注册与客服核身。
- 短信轰炸风险评分:在营销或注册链路上提前识别被批量利用的号码。
- 按需付费:数据包按次计费,技能里写明了哪些是免费、哪些会花钱。
3. 适用场景
所属分类:集成与工作流自动化。
- 注册或登录链路里要先验证手机号真实性的团队;
- 发营销短信前做名单清洗、降低无效号与投诉率的运营;
- 客服或风控需要判断号码是否刚换过卡、是否 VoIP 的场景;
- 要把号码情报接进自有系统、又不想自己维护运营商数据的开发者。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 技能目录安装,按描述触发 |
| Codex | 需适配 | 技能正文通用,凭据与 SDK 安装需按平台调整 |
| OpenClaw | 需适配 | 需要平台支持技能目录并允许执行本地代码 |
| Hermes Agent | 未验证 | 未找到该平台的接入示例 |
5. 推荐理由
号码验证看着简单,真做起来要维护运营商数据、线路类型和风险信号,还要按国家的格式规则清洗。这个技能把 Twilio 的号码情报接口和调用方式讲清楚,免费档能覆盖大部分「这个号是不是真的」的问题,付费档再按需加风控信号——比自己拼一套号码库省事得多。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Twilio 官方出品;所属仓库 39 stars,热度不高,但官方身份与产品覆盖面支撑这一档 |
| 可用性 | 8 | Python/Node 两套快速开始、环境变量与计费边界都写清楚了;前置是注册账号并配好凭据 |
| 安全性 | 9 | 见下方清单;官方 SDK、凭据走环境变量,不给 agent 直连裸接口 |
安全性检查清单:
| 项 | 结果 |
|---|---|
| ① 执行 shell 与权限 | 通过官方 SDK 调用 Twilio API,作用域限于 Lookup 接口 |
| ② 联网外发 | 只把待查号码发给 Twilio,目标透明 |
| ③ 凭据 | 从环境变量读取 SID/Token,不在代码里硬编码;文档指向专门的凭据配置技能 |
| ④ 可疑指令 | 未见注入或夹带推广 |
| ⑤ 作者信誉 | Twilio 官方仓库,MIT |
| ⑥ License | MIT,全文可查 |
| ⑦ 维护时间 | 2026-10-22 仍在更新 |
扣分点:数据包按次计费,批量查询前要先估算成本;号码情报涉及个人信息,使用场景需符合当地法规。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| twilio-verify-send-otp-twilio-ai | 发一次性验证码并校验 | 管「验证码」;本技能管「这个号码本身是否可信」 |
| twilio-identity-verification-advisor-twilio-ai | 身份核验方案选型 | 偏方案与合规;本技能是可直接落地的查询调用 |
| twilio-webhook-architecture-twilio-ai | 回执与事件 webhook 的架构 | 管事件流;本技能管号码数据 |
核心差异:同类多在做「验证流程」或「架构」,它补的是链条最前面那一步——先确认号码值不值得发。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价(2026-11-03)。
9. 其他补充
- 基础校验免费,线路类型、SIM 换卡、身份匹配等数据包按次收费,技能里逐项标注。
- 属于
twilio/ai合集(57 个技能),可与验证码、短信、语音等条目组合使用。
10. 安装使用方式
git clone https://github.com/twilio/ai
mkdir -p ~/.claude/skills
cp -r ai/skills/twilio/twilio-lookup-phone-intelligence ~/.claude/skills/
# 另需:pip install twilio 或 npm install twilio
export TWILIO_ACCOUNT_SID=...
export TWILIO_AUTH_TOKEN=...
装好后说「帮我把这批号码清洗一遍,标出无效号、VoIP 和最近换过卡的」,它会按 Lookup v2 的字段给出结果。
11. 注意事项
- 数据包按次计费,先确认要查哪些字段,避免无意中产生费用。
- 号码属于个人信息,跨境业务要确认当地法规与用户授权。
- SIM 换卡等信号是概率性的,不能单独作为封号或拒绝的依据。
- 免费试用账号在部分数据包上有限制,上线前用真实账号验证一次。