🎁 Get the FREE AI Skills Starter GuideSubscribe →
BytesAgainBytesAgain
🦀 ClawHub

x402 Private Web Tools

by @kodos-vibe

Private web tools for AI agents — search, scrape, and screenshot the web with x402 micropayments (USDC on Base). Zero logging, no API keys, no accounts. Pay...

Versionv1.0.0
💡 Examples

All commands run from ~/.x402-client/:

cd ~/.x402-client && node /scripts/x402-fetch.mjs "" --key-file wallet.key

Web Search ($0.002/query)

node /scripts/x402-fetch.mjs \
  "https://search.reversesandbox.com/web/search?q=latest+AI+news&count=10" \
  --key-file ~/.x402-client/wallet.key

Parameters: q (required), count (1-20, default 10), offset (default 0)

Response:

{
  "query": { "original": "latest AI news" },
  "web": {
    "results": [
      { "title": "...", "url": "...", "description": "..." }
    ]
  }
}

Web Scrape ($0.005/page)

node /scripts/x402-fetch.mjs \
  "https://search.reversesandbox.com/scrape/extract" \
  --method POST \
  --body '{"url": "https://example.com", "format": "markdown"}' \
  --key-file ~/.x402-client/wallet.key

Body (JSON): url (required), format ("markdown"|"text", default "markdown"), includeLinks (bool), timeout (ms)

Response:

{
  "title": "Example Domain",
  "content": "# Example Domain\nThis domain is for use in...",
  "url": "https://example.com",
  "timestamp": "2026-02-16T09:00:00.000Z",
  "format": "markdown"
}

Screenshot ($0.002/shot)

node /scripts/x402-fetch.mjs \
  "https://search.reversesandbox.com/screenshot/?url=https://example.com&width=1280&height=720" \
  --key-file ~/.x402-client/wallet.key \
  --save screenshot.png

Parameters: url (required), format (png|jpeg, default png), width (320-3840), height (200-2160), fullPage (true|false), quality (1-100, jpeg only)

Returns: Binary PNG or JPEG image. Use --save to write to disk.

⚙️ Configuration

  • Node.js 18+
  • A Base mainnet wallet with ETH (gas) and USDC (payments)
  • 📋 Tips & Best Practices

  • "insufficient funds": Wallet needs more USDC or ETH on Base mainnet.
  • 402 with no auto-payment: Ensure setup.sh was run and you're in ~/.x402-client/.
  • Slow scrape (10s+): Complex JS-heavy pages take longer. Use the timeout parameter.
  • Empty search results: Try different query terms. Some niche queries may return fewer results.
  • View on ClawHub
    TERMINAL
    clawhub install x402-private-web-tools

    🧪 Use this skill with your agent

    Most visitors already have an agent. Pick your environment, install or copy the workflow, then run the smoke-test prompt above.

    🔍 Can't find the right skill?

    Search 60,000+ AI agent skills — free, no login needed.

    Search Skills →