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 實現。此技能遵循 代理技能 規格，因此任何能讀取 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 金鑰（註冊後於 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/