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 エージェントスキル – その概要

商用APIを通じて、自律型AIエージェントが使い捨ての電話番号を取得し、サービスのSMS認証コードを受け取り、（オプションで）TOTPコードを生成できるようにする、非常に小さく自己完結型のスキルです。このスキルはAgent Skills仕様に従っているため、SKILL.mdファイルを読み取ることができるランナー（Claude Code、Codexなど）であれば、追加のSDKなしで使用できます。

コア機能

機能 仕組み (READMEに記載)
適切な国の番号を取得する エージェントはAPIエンドポイント action=getCountryAndOperators を呼び出して、サポートされている200以上の国をリストアップし、その後、希望する国（例：インドネシア）の番号をリクエストします。
認証コードを直接受け取る APIはSMSから抽出済みのコードを返却するため、エージェントは受信トレイを解析したり正規表現を書いたりする必要がありません。
Pay‑per‑code (コードごとに支払い) 番号を注文した際に資金が保持され、コードが届いたときのみ課金されます（または、コードが届かない場合は約20分後に解除されます）。
プライベートで使い捨ての番号 各アクティベーションは単一のサービスリクエストに紐付けられており、他のユーザーがコードを見ることはできません。
動的なプール管理の把握 カタログ呼び出し時に、国ごとの成功率とライブプールのサイズも報告されるため、エージェントは収益性の低い地域を避けることができます。
2FAを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          (コードなし、返金)

このリポジトリには、このループを実装した、すぐに実行可能な2つのスクリプト (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より)

> Read the sv-number skill and register me a Telegram account on an Indonesian number.

ordered +62 838 1234 5678
code 123456
account created

エージェントはスキルにインドネシアの番号をリクエストし、コード 123456 を受信し、Telegramのサインアップを自動的に完了できます。

リンク

関連

  • プロジェクト
    nullpointexception-i/agent-sphere

    AgentSphereは、LLM駆動のReActループを実行し、マルチエージェントサブラン、Chrome拡張機能によるリアルブラウザ自動化、モデルルーティング、永続的なマルチレベルメモリ、人間がループに参加する明確化、OIDC SSO、埋め込みチャットウィジェットをサポートするJava-Spring/Reactプラットフォームです。

  • プロジェクト
    oleksiijko/pmb

    PMB は、LLM ベースのコーディングアシスタントにローカルで SQLite を基盤としたメモリを提供するオープンソースの Python ライブラリです。コード、PDF、git 履歴、およびユーザーが記録した事実を自動的にインデックスし、Model-Context-Protocol を介して最も関連性の高い部分をエージェントに注入し直します。このシステムはオフラインで動作し、ハイブリッドの BM25 + ベクトル検索（ウォームレイテンシ約 35 ms）を提供し、視覚的なダッシュボードを備え、モデルが考える前にメモリを呼び出し、観察されたアクションを自動的に書き込むフックの両方を含んでいます。`pip install pmb-ai` でインストールし、`pmb setup` を実行してエージェントを接続すると、エージェントは API キーやクラウド呼び出しなしで、再起動後も決定事項、教訓、プロジェクトのコンテキストを記憶します。

  • プロジェクト
    jinzijian/EvoTrace

    EvoTrace は、ローカルファーストのツールで、Claude Code または Codex のセッション履歴をインポートし、一貫性のあるコーディングエピソードをマイニングし、検証済みの Docker 対応タスク、プリファレンスデータ、報酬候補を生成します。DeepSeek Harness UI 上で動作し、4エージェントレビューパイプラインを使用し、すべてのデータをユーザーの完全な制御下に保ちます。