# Marketplace Service Template (`elbadoo/marketplace-service-template`) Actor ๐Ÿ›ก๏ธ Unblockable Infrastructure: Powered by a 4G mobile proxy rotation to bypass advanced bot detection. โ€‹๐Ÿ“Š Multimodal Extraction: 27+ endpoints covering Social Media (LI/FB/IG/TikTok), Real Estate, and Google Maps. โ€‹๐Ÿ’ธ x402 V2 Compliant: Optimized for the latest machine-to-machine payment protocols - **URL**: https://apify.com/elbadoo/marketplace-service-template.md - **Developed by:** [EL BADOO](https://apify.com/elbadoo) (community) - **Categories:** AI, SEO tools, Social media - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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 155+ mobile devices across 6 countries, x402 payment rails, 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](https://github.com/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](https://api.proxies.sx/v1/x402/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 ### ๐Ÿ† Completed Bounties * **Instagram Intelligence + AI Vision ($200):** High-difficulty bounty complete. Includes stealth audits and vision analysis. * **LinkedIn People Enrichment ($100):** High-difficulty bounty complete. Optimized for iPhone 14 mobile fingerprints. * **Reddit Intelligence ($50):** Medium-difficulty bounty complete. Full subreddit and trending post extraction. ### Quick Start ```bash ## 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 your wallet(s) + PROXY_* credentials. ## We support BOTH chains, so plug in either or both: ## SOLANA_WALLET_ADDRESS= ## Solana (~400ms, ~$0.0001 gas) ## WALLET_ADDRESS_BASE= ## Base (~2s, ~$0.01 gas) bun install bun run dev ```` Test it: ```bash 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: ```typescript 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: โ”‚โ”€โ”€โ”€ 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](SECURITY.md) for production hardening. ### Live Services These services are live on the marketplace right now: | Service | Price | Builder | Status | |---------|-------|---------|--------| | **Social Intelligence Hub** | $0.005/query | **@IsahMuhammad** | **Live & Verified** | | [Mobile Proxy](https://agents.proxies.sx/marketplace/proxy/) | $4/GB shared, $8/GB private | Proxies.sx | Live | | [Google Maps Lead Generator](https://agents.proxies.sx/marketplace/google-maps-lead-generator/) | $0.005/record | [@aliraza556](https://github.com/aliraza556) | Live | | [Mobile SERP Tracker](https://agents.proxies.sx/marketplace/serp-tracker/) | $0.003/query | [@aliraza556](https://github.com/aliraza556) | Live | | [Job Market Intelligence](https://bounty16-job-market-intelligence.onrender.com) | $0.005/query | [@Lutra23](https://github.com/Lutra23) | Live | | [Prediction Market Aggregator](https://marketplace-service-template.onrender.com) | $0.05/query | [@rakesh0x](https://github.com/rakesh0x) | Live | ### Open Bounties โ€” $1,200+ in $SX Tokens Build a service, earn $SX tokens. Full specs in each issue. | Bounty | Amount | Difficulty | Issue | |--------|--------|------------|-------| | Instagram Intelligence + AI Vision | $200 | Hard | [#71](https://github.com/bolivian-peru/marketplace-service-template/issues/71) | | X/Twitter Real-Time Search | $100 | Hard | [#73](https://github.com/bolivian-peru/marketplace-service-template/issues/73) | | LinkedIn People Enrichment | $100 | Hard | [#77](https://github.com/bolivian-peru/marketplace-service-template/issues/77) | | Trend Intelligence (Cross-Platform) | $100 | Hard | [#70](https://github.com/bolivian-peru/marketplace-service-template/issues/70) | | Prediction Market Aggregator | $100 | Hard | [#55](https://github.com/bolivian-peru/marketplace-service-template/issues/55) | | Amazon Product & BSR Tracker | $75 | Medium | [#72](https://github.com/bolivian-peru/marketplace-service-template/issues/72) | | Facebook Marketplace Monitor | $75 | Medium-Hard | [#75](https://github.com/bolivian-peru/marketplace-service-template/issues/75) | | Airbnb Market Intelligence | $75 | Medium-Hard | [#78](https://github.com/bolivian-peru/marketplace-service-template/issues/78) | | Real Estate Intelligence (Zillow) | $75 | Medium-Hard | [#79](https://github.com/bolivian-peru/marketplace-service-template/issues/79) | | TikTok Trend Intelligence | $75 | Hard | [#51](https://github.com/bolivian-peru/marketplace-service-template/issues/51) | | Google Discover Feed Intel | $75 | Hard | [#52](https://github.com/bolivian-peru/marketplace-service-template/issues/52) | | Reddit Intelligence | $50 | Easy-Medium | [#68](https://github.com/bolivian-peru/marketplace-service-template/issues/68) | | Google Reviews Extractor | $50 | Medium | [#74](https://github.com/bolivian-peru/marketplace-service-template/issues/74) | | Food Delivery Price Intel | $50 | Medium | [#76](https://github.com/bolivian-peru/marketplace-service-template/issues/76) | | App Store Intelligence | $50 | Medium | [#54](https://github.com/bolivian-peru/marketplace-service-template/issues/54) | | Ad Verification & Creative Intel | $50 | Medium | [#53](https://github.com/bolivian-peru/marketplace-service-template/issues/53) | **Rules:** 1. Must use Proxies.sx mobile proxies 2. Must gate with x402 USDC payments 3. Must deploy a live, working service 4. Submit a PR with deployment URL + proof data 5. $SX tokens paid after merge and verification See [CONTRIBUTING.md](CONTRIBUTING.md) for full submission guide. ### Get Proxy Credentials **Option A:** Dashboard โ€” [client.proxies.sx](https://client.proxies.sx) **Option B:** x402 API (no account needed): ```bash curl https://api.proxies.sx/v1/x402/proxy?country=US&traffic=1 ## Returns 402 โ†’ pay USDC โ†’ get credentials ``` **Option C:** MCP Server (59 tools): ```bash npx -y @proxies-sx/mcp-server ``` ### Deploy ```bash ## 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](https://agents.proxies.sx/marketplace/) | | Skill File | [agents.proxies.sx/skill.md](https://agents.proxies.sx/skill.md) | | x402 Protocol | [agents.proxies.sx/.well-known/x402.json](https://agents.proxies.sx/.well-known/x402.json) | | MCP Server | [@proxies-sx/mcp-server](https://github.com/bolivian-peru/proxies-sx-mcp-server) | | Proxy Pricing | [api.proxies.sx/v1/x402/pricing](https://api.proxies.sx/v1/x402/pricing) | | Telegram | [@proxyforai](https://t.me/proxyforai) | | Twitter | [@sxproxies](https://x.com/sxproxies) | | Discussions | [GitHub Discussions](https://github.com/bolivian-peru/marketplace-service-template/discussions) | ### License MIT โ€” fork it, ship it, profit. *** **Ready to start earning?** ```bash 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](https://t.me/proxyforai) ยท [@sxproxies](https://x.com/sxproxies) ## Actor input object example ```json {} ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("elbadoo/marketplace-service-template").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("elbadoo/marketplace-service-template").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call elbadoo/marketplace-service-template --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=elbadoo/marketplace-service-template", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Marketplace Service Template", "description": "๐Ÿ›ก๏ธ Unblockable Infrastructure: Powered by a 4G mobile proxy rotation to bypass advanced bot detection.\nโ€‹๐Ÿ“Š Multimodal Extraction: 27+ endpoints covering Social Media (LI/FB/IG/TikTok), Real Estate, and Google Maps.\nโ€‹๐Ÿ’ธ x402 V2 Compliant: Optimized for the latest machine-to-machine payment protocols", "version": "0.0", "x-build-id": "bOOzwk6PJnZsZV4q4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/elbadoo~marketplace-service-template/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-elbadoo-marketplace-service-template", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/elbadoo~marketplace-service-template/runs": { "post": { "operationId": "runs-sync-elbadoo-marketplace-service-template", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/elbadoo~marketplace-service-template/run-sync": { "post": { "operationId": "run-sync-elbadoo-marketplace-service-template", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": {} }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```