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 agent skill – 정의

A 상업용 API를 통해 일회용 전화번호를 획득하고, 서비스의 SMS 인증 코드를 수신하며, (선택적으로) TOTP 코드를 생성할 수 있게 해주는 작고 독립적인 skill입니다. 이 skill은 Agent Skills 사양을 따르므로, SKILL.md 파일을 읽을 수 있는 모든 runner(Claude Code, Codex 등)에서 추가 SDK 없이 바로 사용할 수 있습니다.

Core capabilities

Feature	How it works (as described in the README)
원하는 국가의 번호 획득	agent가 `action=getCountryAndOperators` API endpoint를 호출하여 지원되는 200개 이상의 국가 목록을 확인한 후, 원하는 국가(예: Indonesia)의 번호를 요청합니다.
인증 코드를 직접 수신	API가 SMS에서 이미 추출된 코드를 반환하므로, agent가 직접 수신함을 파싱하거나 regex를 작성할 필요가 없습니다.
Pay‑per‑code 방식	번호를 주문할 때 금액이 hold되고, 코드가 도착했을 때만 charge됩니다 (코드가 없을 경우 약 20분 후 해제됨).
개인용, 일회용 번호	각 활성화는 단일 서비스 요청에 연결되며, 다른 사용자가 코드를 볼 수 없습니다.
동적 풀(pool) 인지	카탈로그 호출 시 국가별 성공률과 실시간 풀 크기를 함께 보고하므로, agent가 효율이 낮은 지역을 피할 수 있습니다.
TOTP를 통한 2-FA 완료	서비스에서 인증기를 요구하는 경우, agent는 TOTP secret을 로컬에 저장하고 secret을 외부로 전송하지 않고 6자리 코드(RFC 6238)를 계산합니다.

Typical workflow (as described in the README)

1. getNumber   → ACCESS_NUMBER:id:phone   (order a number, money held)
2. getStatus   → STATUS_WAIT_CODE       (poll every 3‑5 s)
3.               → STATUS_OK:123456      (code received)
4. setStatus 6 → ACCESS_ACTIVATION      (code used, charge stays)
5. setStatus 8 → ACCESS_CANCEL          (no code, money refunded)

이 repository는 이 루프를 구현한 두 개의 실행 가능한 스크립트(order_number.py 및 order_number.mjs)를 제공합니다.

Getting started

# Grab the skill definition
curl -O https://raw.githubusercontent.com/sv-number/skills/main/sv-number/SKILL.md

# Export your API key (obtain it after signing up at sms-verification-number.com)
export SVN_API_KEY=your_key_here

agent runner가 skill을 기대하는 위치에 sv-number 디렉토리를 배치하고, LLM 기반 workflow에서 skill을 호출하십시오.

What it is not

이 기능은 full-duplex 전화선을 제공하지 않습니다. 즉, 번호를 통해 전화를 받거나 지속적인 대화를 유지할 수 없습니다.
은행, 결제 또는 정부 계정 인증과 같은 고위험 사용 사례를 용도로 설계되지 않았습니다.
기반 서비스는 상업용입니다. skill 자체는 MIT-licensed이지만, API 계정을 충전해야 합니다.

Limitations & constraints

sms-verification-number.com의 유료 계정이 필요합니다. 무료 티어는 없습니다.
각 활성화화는 반드시 종료되어야 합니다 (setStatus 6 또는 8). 그렇지 않으면 hold된 금액이 잠겨 있습니다.
성공 여부는 제공업체의 풀(pool) health 상태에 따라 달라집니다. skill은 효율이 낮은 풀을 피하도록 도와주지만, SMS 전달이 100% 보장되지는 않습니다.

Quick example (from the 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

agent가 skill을 통해 인도네시아 번호를 요청하고, 123456 코드를 수신하여 Telegram sign-up을 자동으로 완료할 수 있습니다.