# Send Shadow Number to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "shadow-phone",
    "name": "Shadow Number",
    "source": "tencent",
    "type": "skill",
    "category": "金融交易",
    "sourceUrl": "https://clawhub.ai/0xShadowETH/shadow-phone",
    "canonicalUrl": "https://clawhub.ai/0xShadowETH/shadow-phone",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/shadow-phone",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=shadow-phone",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "shadow-phone",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T04:42:09.020Z",
      "expiresAt": "2026-05-06T04:42:09.020Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=shadow-phone",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=shadow-phone",
        "contentDisposition": "attachment; filename=\"shadow-phone-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "shadow-phone"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/shadow-phone"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/shadow-phone",
    "downloadUrl": "https://openagent3.xyz/downloads/shadow-phone",
    "agentUrl": "https://openagent3.xyz/skills/shadow-phone/agent",
    "manifestUrl": "https://openagent3.xyz/skills/shadow-phone/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/shadow-phone/agent.md"
  }
}
```
## Documentation

### Shadow Number Skill

Use this skill when you need to sign up on a website that requires phone verification, or any time you need a disposable phone number to receive an OTP/SMS verification code.

### What This Skill Does

Calls the Shadow API (x402-gated — payment ~$0.10 USDC on Base is handled automatically)
Returns a real temporary phone number for the chosen service and country
Navigates to the target website and enters the number into the signup form
Polls the Shadow OTP endpoint every 15 seconds until the SMS code arrives
Enters the OTP to complete verification

### Step 1: Choose Service Code

Pick the service code for the website you are signing up on:

WebsiteCodeTelegramopt1Facebookopt2Google / Gmailopt7WhatsAppopt29Instagramopt36Twitter / Xopt48Microsoftopt33Appleopt42PayPalopt15Amazonopt22Tinderopt38Shopeeopt49

If the exact service is not listed above, use the service name to search — the API accepts any valid SMSPVA service code.

### Step 2: Buy a Temp Number (x402 payment)

Make a POST request to the Shadow buy endpoint. This endpoint requires x402 payment — your agent wallet will automatically pay ~$0.10 USDC on Base when the server returns HTTP 402, then retry.

POST https://extraordinary-charisma-production.up.railway.app/api/smspva/buy
Content-Type: application/json

{
  "country": "US",
  "service": "opt7"
}

Supported country codes: US, GB, FR, DE, IN, BR, PH, ID, NG, RU, UA, PL, CA, AU, MX, and 60+ more.

Success response (200):

{
  "statusCode": 200,
  "data": {
    "phoneNumber": "14155552671",
    "orderId": "abc123",
    "orderExpireIn": 600
  }
}

The full number to enter on the website is: +{countryCode}{phoneNumber} (e.g. +14155552671 for US numbers).

If you get a non-200 response, try a different country or service code and call buy again.

### Step 3: Use the Number on the Website

Use your browser to:

Navigate to the website's signup or phone verification page
Enter the phone number in international format (e.g. +14155552671)
Click the "Send code" / "Verify" / "Get OTP" button
Wait for the page to confirm the SMS was sent

### Step 4: Poll for OTP

After triggering the SMS, poll every 15 seconds:

GET https://extraordinary-charisma-production.up.railway.app/api/smspva/otp/{orderId}

OTP received (200):

{
  "statusCode": 200,
  "data": {
    "sms": { "code": "123456" },
    "orderId": "abc123",
    "orderExpireIn": 540
  }
}

Extract data.sms.code — that is your OTP.

Not yet received (202): wait 15 seconds and retry.

Stop polling if:

You receive status 200 (success)
orderExpireIn drops to 0 (order expired — start over)
You receive status 410 (order closed)

### Step 5: Enter the OTP

Go back to the browser tab and enter the OTP code from data.sms.code into the verification field. Submit the form to complete signup.

### Error Recovery

Number doesn't work / site rejects it:

PUT https://extraordinary-charisma-production.up.railway.app/api/smspva/refuse/{orderId}

Then go back to Step 2 and buy a new number.

Number is banned by the service:

PUT https://extraordinary-charisma-production.up.railway.app/api/smspva/ban/{orderId}

Then buy a new number with a different country.

### Full Example Flow

User: "Sign me up on Telegram with a US number"

Call POST /api/smspva/buy with { country: "US", service: "opt1" }
Get back phoneNumber: "14155552671", orderId: "x9k2m"
Open browser → navigate to https://web.telegram.org → start signup
Enter +14155552671 as the phone number → click Send Code
Poll GET /api/smspva/otp/x9k2m every 15s
Receive { sms: { code: "84712" } }
Enter 84712 in the Telegram verification box → account created ✅

### Notes

Numbers are single-use and expire after orderExpireIn seconds (typically 5–10 minutes)
Always use international format with + prefix when entering the number on websites
Some services block certain countries — if one country fails, retry with a different one
The x402 payment (~$0.10 USDC) is charged per number purchase, not per OTP poll
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: 0xShadowETH
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T04:42:09.020Z
- Expires at: 2026-05-06T04:42:09.020Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/shadow-phone)
- [Send to Agent page](https://openagent3.xyz/skills/shadow-phone/agent)
- [JSON manifest](https://openagent3.xyz/skills/shadow-phone/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/shadow-phone/agent.md)
- [Download page](https://openagent3.xyz/downloads/shadow-phone)