sv-number/skills

Give your AI agent a phone number: order a private number in 200+ countries over the API, read the SMS verification code, hand the number back. The widest country coverage in the category, checkable with one API call.

SV Number 代理技能 – 是什么

一个微型、自包含的技能，允许自主 AI 代理获取一个一次性电话号码，接收服务的短信验证码，并（可选地）生成 TOTP 验证码——全部通过商业 API 实现。该技能遵循 Agent Skills 规范，因此任何能读取 SKILL.md 文件的运行器（如 Claude Code、Codex 等）均可使用，无需额外 SDK。

核心功能

功能	工作方式（如 README 所述）
获取目标国家的号码	代理调用 API 端点 `action=getCountryAndOperators` 列出 200 多个支持的国家，然后为所需国家（例如印度尼西亚）请求一个号码。
直接接收验证码	API 会直接返回已从短信中提取的验证码，因此代理无需解析收件箱或编写正则表达式。
按码计费	金额在订购号码时被冻结，仅在验证码到达时才被扣除（或在约 20 分钟内未收到验证码后释放）。
私有、一次性号码	每次激活仅与单个服务请求绑定；其他用户无法看到该验证码。
动态池状态感知	目录调用还会报告每个国家的成功率和实时号码池大小，使代理可避开低效区域。
通过 TOTP 完成双因素认证	如果服务要求使用认证器，代理会将 TOTP 密钥本地存储，并计算 6 位验证码（RFC 6238），而无需将密钥发送到任何地方。

典型工作流程（如 README 所示）

1. getNumber   → ACCESS_NUMBER:id:phone   (订购号码，资金冻结)
2. getStatus   → STATUS_WAIT_CODE       (每 3–5 秒轮询一次)
3.               → STATUS_OK:123456      (收到验证码)
4. setStatus 6 → ACCESS_ACTIVATION      (验证码已使用，费用保留)
5. setStatus 8 → ACCESS_CANCEL          (未收到验证码，资金退还)

该仓库提供了两个可直接运行的脚本（order_number.py 和 order_number.mjs），实现了此循环。

快速入门

# 获取技能定义
curl -O https://raw.githubusercontent.com/sv-number/skills/main/sv-number/SKILL.md

# 导出你的 API 密钥（注册 https://sms-verification-number.com 后获取）
export SVN_API_KEY=your_key_here

将 sv-number 目录放置在你的代理运行器期望的位置，并从你的 LLM 驱动的工作流中调用该技能。

它不是什么

它不提供全双工电话线路——号码无法接收来电或进行持续对话。
它不适用于高风险场景，如银行、支付或政府账户验证。
底层服务为商业服务；该技能本身采用 MIT 许可证，但你必须自行承担 API 账户费用。

限制与约束

你需要在 sms-verification-number.com 上拥有付费账户；无免费套餐。
每次激活必须关闭（调用 setStatus 6 或 8），否则冻结的资金将一直锁定。
成功与否取决于提供商号码池的健康状况——该技能可帮助你避开低效池，但无法保证 100% 成功送达。

快速示例（来自 README）

> 读取 sv-number 技能，并用一个印度尼西亚号码为我注册一个 Telegram 账户。

已订购 +62 838 1234 5678
验证码 123456
账户创建成功

代理向技能请求一个印度尼西亚号码，收到验证码 123456，并可自动完成 Telegram 注册流程。

链接

技能定义：sv-number/SKILL.md
网页版说明：https://sms-verification-number.com/en/agent-skill/
完整 API 文档：https://sms-verification-number.com/en/api-sms-activate/
覆盖范围与定价：https://sms-verification-number.com/en/number-for-ai-agents/