Marketplace Service Template

Turn AI agent traffic into passive USDC income.

Fork this repo → edit one file → deploy → start earning.

You provide the idea. We provide 148 mobile devices across 6 countries (DE, PL, US, FR, ES, GB), x402 payment rails (Solana + Base), and the marketplace to find customers.

Reference implementation included: This repo ships with a working Google Maps Lead Generator (src/service.ts + src/scrapers/) built by @aliraza556. Use it as-is or replace with your own service logic.

The Economics

You’re arbitraging infrastructure. Buy proxy bandwidth wholesale, sell API calls retail.

Proxy cost: flat $4/GB — one simple rate, all 6 countries, mobile + residential (live pricing). Duration is free; you only pay for the GB you actually use.

Your margin depends on what you’re scraping:

Example: Text scraper at 10k req/day

• Traffic: ~0.5 GB/day → $2/day proxy cost
• Revenue: $0.005 × 10k = $50/day
• Profit: $48/day (~$1,400/mo)

Key: Optimize response size. Return text, not full HTML. Skip images. The template’s proxyFetch() returns text by default (50KB cap).

Why This Works

1. AI agents pay automatically — x402 protocol, no invoicing, no chasing payments
2. Real mobile IPs — bypass blocks that kill datacenter scrapers
3. Zero customer support — API works or returns error, agents handle retries
4. Passive income — deploy once, earn while you sleep

Quick Start

# Fork this repo, then:
git clone https://github.com/YOUR_USERNAME/marketplace-service-template
cd marketplace-service-template

cp .env.example .env
# Edit .env: set WALLET_ADDRESS + PROXY_* credentials

bun install
bun run dev

Test it:

curl http://localhost:3000/health
# → {"status":"healthy","service":"my-service",...}

curl http://localhost:3000/
# → Service discovery JSON (AI agents read this)

curl "http://localhost:3000/api/run?query=plumbers&location=Austin+TX"
# → 402 with payment instructions (this is correct!)

Edit One File

src/service.ts — change three values and the handler:

const SERVICE_NAME = 'my-scraper';       // Your service name
const PRICE_USDC = 0.005;               // Price per request ($)
const DESCRIPTION = 'What it does';      // For AI agents

serviceRouter.get('/run', async (c) => {
  // ... payment check + verification (already wired) ...

  // YOUR LOGIC HERE:
  const result = await proxyFetch('https://target.com');
  return c.json({ data: await result.text() });
});