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: $4/GB shared, $8/GB private (live pricing)

Your margin depends on what you're scraping:

Use Case	Avg Size	Reqs/GB	Cost/Req	You Charge	Margin
JSON APIs	~10 KB	100k	$0.00004	$0.001	97%
Text extraction	~50 KB	20k	$0.0002	$0.005	96%
HTML (no images)	~200 KB	5k	$0.0008	$0.005	84%
Full pages	~2 MB	500	$0.008	$0.02	60%

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() });
});

Everything else (server, CORS, rate limiting, payment verification, proxy helper) works out of the box.

How x402 Payment Works

AI Agent                         Your Service                    Blockchain
   │                                  │                              │
   │─── GET /api/run ────────────────►│                              │
   │◄── 402 {price, wallet, nets} ────│                              │
   │                                  │                              │
   │─── Send USDC ──────────────────────────────────────────────────►│
   │◄── tx confirmed ◄──────────────────────────────────────────────│
   │                                  │                              │
   │─── GET /api/run ────────────────►│                              │
   │    Payment-Signature: <tx_hash>  │─── verify tx on-chain ──────►│
   │                                  │◄── confirmed ◄──────────────│
   │◄── 200 {result} ────────────────│                              │

Supports Solana (~400ms, ~$0.0001 gas) and Base (~2s, ~$0.01 gas).

What's Included

File	Purpose	Edit?
src/service.ts	Your service logic, pricing, description	Yes
src/scrapers/maps-scraper.ts	Google Maps scraping logic (reference impl)	Replace with yours
src/types/index.ts	TypeScript interfaces	Replace with yours
src/utils/helpers.ts	Extraction helper functions	Replace with yours
src/index.ts	Server, CORS, rate limiting, discovery	No
src/payment.ts	On-chain USDC verification (Solana + Base)	No
src/proxy.ts	Proxy credentials + fetch with retry	No
CLAUDE.md	Instructions for AI agents editing this repo	No
SECURITY.md	Security features and production checklist	Read it

Security

Built in by default:

• On-chain payment verification — Solana + Base RPCs, not trust-the-header
• Replay prevention — Each tx hash accepted only once
• SSRF protection — Private/internal URLs blocked
• Rate limiting — Per-IP, configurable (default 60/min)
• Security headers — nosniff, DENY framing, no-referrer

See SECURITY.md for production hardening.

Live Services

9 services / 23 endpoints verified live in production (last audit 2026-04-28). Browse the full catalog: agents.proxies.sx/marketplace or skill.md.

Service	Endpoints	Price	Builder
Mobile Proxy	/v1/x402/proxy	$4/GB shared, $8/GB private	Proxies.sx
Google Maps Lead Generator	/maps/run, /maps/details	$0.005/record	@aliraza556
Mobile SERP Tracker	/serp/run	$0.003/query	@aliraza556
Reviews & Business Data	/reviews/*, /business/:id	$0.005–$0.02	@aliraza556
Job Market Intelligence	/jobs	$0.005/query	@Lutra23
Reddit Intelligence	/reddit/* (4 endpoints)	$0.005–$0.01	@TheAuroraAI
Instagram Intelligence + AI Vision	/instagram/* (5 endpoints)	$0.01–$0.15	@TheAuroraAI
LinkedIn Enrichment	/linkedin/* (4 endpoints)	$0.01/query	@TheAuroraAI
Airbnb Market Intelligence	/airbnb/* (4 endpoints)	$0.01–$0.05	@TheAuroraAI

All endpoints under https://api.proxies.sx/v1/x402/. Each returns HTTP 402 → pay USDC → retry with Payment-Signature header → get JSON.

Bounty Pool — Paused (2026-04-28)

The bounty pool is currently paused while we focus on growing revenue for the 9 services already live. The 6 PRs from @elnexi461-spec (#394–399) duplicating live services were closed.

The pool will reopen when any single live service crosses $500/month in x402 revenue.

If you want to ship a service in the meantime, we offer rev-share contracts (50% of all USDC the service earns, no upfront $SX bounty). Contact agents@proxies.sx or @proxyforai.

Existing live builders are welcome to ship updates and additional endpoints.

Get Proxy Credentials

Option A: Dashboard — client.proxies.sx

Option B: x402 API (no account needed):

curl https://api.proxies.sx/v1/x402/proxy?country=US&traffic=1
# Returns 402 → pay USDC → get credentials

Option C: MCP Server (55 tools — works in Claude Desktop, Cursor, Windsurf):

npx -y @proxies-sx/mcp-server

Deploy

# Docker
docker build -t my-service .
docker run -p 3000:3000 --env-file .env my-service

# Any VPS with Bun
bun install --production && bun run start

# Railway / Fly.io / Render
# Just connect the repo — Dockerfile detected automatically

Links

Resource	URL
Marketplace	agents.proxies.sx/marketplace
Skill File	agents.proxies.sx/skill.md
x402 Protocol	agents.proxies.sx/.well-known/x402.json
MCP Server	@proxies-sx/mcp-server
Proxy Pricing	api.proxies.sx/v1/x402/pricing
Telegram	@proxyforai
Twitter	@sxproxies
Discussions	GitHub Discussions

License

MIT — fork it, ship it, profit.

---

Ready to start earning?

git clone https://github.com/YOUR_USERNAME/marketplace-service-template
cd marketplace-service-template
cp .env.example .env
# Add your wallet + proxy credentials
bun install && bun run dev

Questions? @proxyforai · @sxproxies