{
  "markdown": "# NodeProxy\n\n**Self-discoverable MCP utility for autonomous agents** — no ads, no landing page, no human in the loop.\n\nNodeProxy exposes two paid tools:\n\n| Tool | Endpoint | Price | Use case |\n|------|----------|-------|----------|\n| `surface_markdown_parser` | `POST /mcp/execute` | $0.002 USDC | Normal public pages |\n| `stealth_markdown_parser` | `POST /stealth-scrape` | $0.05 USDC | Cloudflare/Akamai-protected sites |\n\nBoth fetch a public URL, strip scripts/ads/nav noise, and return compressed Markdown optimized for LLM context windows. Standard tier also accepts **Stripe MPP** card payments ($0.50 minimum) alongside x402 USDC.\n\nAgents find this service through **MCP registries**, **x402 Bazaar discovery**, and machine-readable manifests — not marketing.\n\n## Why agents need this\n\nHeavy React/Vue sites burn tokens when agents ingest raw HTML. NodeProxy returns clean Markdown so autonomous retrieval loops stay cheap and accurate. When basic fetch hits bot walls, the stealth tier escalates with proxy rotation, hardened Playwright, and optional CAPTCHA solving.\n\n## Architecture\n\n```\nAutonomous Agent\n    │  search MCP registry / Bazaar (vector or keyword)\n    ▼\nGET /mcp/tools  or  MCP list_tools\n    │  reads JSON schema (\"Machine UI\")\n    ▼\nPOST /mcp/execute  or  POST /stealth-scrape\n    │  no payment → 402 + PAYMENT-REQUIRED (+ Bazaar extension)\n    │  x402 PAYMENT-SIGNATURE or MPP Authorization: Payment …\n    │  facilitator verify/settle → parse URL\n    ▼\nMarkdown payload → agent continues task\n```\n\n## Quick start\n\n```bash\ncd NodeProxy\ncp .env.example .env\n# Set WALLET_ADDRESS to your Base wallet\nnpm install\nnpm run dev\n```\n\nEndpoints (replace host with your deploy URL):\n\n| Endpoint | Purpose |\n|----------|---------|\n| `GET /health` | Service status, pricing, stealth/MPP config |\n| `GET /mcp/tools` | Tool catalog for registry crawlers |\n| `POST /mcp/execute` | Standard parse + x402/MPP gate |\n| `POST /stealth-scrape` | Stealth parse + x402 gate |\n| `ALL /mcp` | Streamable HTTP MCP transport |\n| `GET /.well-known/mcp.json` | Well-known MCP discovery |\n| `GET /.well-known/x402.json` | x402 + Bazaar discovery manifest |\n| `GET /.well-known/mpp.json` | MPP Stripe manifest (when configured) |\n| `GET /discovery/agent.json` | Agent discovery card |\n| `GET /registry/server.json` | Live registry manifest (dynamic) |\n\n## Environment\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `WALLET_ADDRESS` | — | USDC recipient (your revenue) |\n| `PRICE_USDC` | `0.002` | Standard tier price per parse |\n| `STEALTH_PRICE_USDC` | `0.05` | Stealth tier price per parse |\n| `X402_NETWORK` | `eip155:84532` | Primary network; use `eip155:8453` on mainnet |\n| `X402_NETWORKS` | CDP bundle | Comma-separated CAIP-2 ids (Base, Polygon, Arbitrum, optional Ethereum L1) |\n| `FACILITATOR_URL` | `https://x402.org/facilitator` | x402 facilitator |\n| `CDP_API_KEY_ID` / `CDP_API_KEY_SECRET` | — | Coinbase CDP facilitator (mainnet) |\n| `MPP_SECRET_KEY` / `STRIPE_SECRET_KEY` | — | Stripe MPP on `/mcp/execute` |\n| `STEALTH_PROXY_URLS` | — | Comma-separated proxy URLs for stealth tier |\n| `CAPTCHA_SOLVER_KEY` | — | 2captcha API key (optional) |\n| `PUBLIC_URL` | localhost | Used in discovery manifests |\n\n## Machine discovery (zero advertising)\n\n1. **Deploy** to Railway or any HTTPS host.\n2. **Verify** live manifests: `/mcp/tools`, `/.well-known/x402.json`, `/registry/server.json`.\n3. **Submit PR** to the [open-source MCP Registry](https://github.com/modelcontextprotocol/registry) using `integrations/mcp-registry/server-entry.json`.\n4. **Bazaar auto-index**: after successful x402 settlements through a Bazaar-enabled facilitator, tools appear in the global Bazaar index ([Bazaar docs](https://docs.x402.org/extensions/bazaar)). NodeProxy attaches Bazaar extension metadata on every 402 response.\n5. **Enterprise hubs** (Google Agent Registry, Anthropic routing): point them at `/.well-known/mcp.json` or `/discovery/agent.json`.\n\nTool descriptions are written for **LLM tool-matching**, not humans.\n\n## Payment rails\n\n| Rail | Tools | Destination | Amount |\n|------|-------|-------------|--------|\n| **x402 USDC** | Standard + stealth | Your `WALLET_ADDRESS` | $0.002 / $0.05 |\n| **Stripe MPP** | Standard only | Stripe account balance | $0.50/card (SPT minimum) |\n\n## MCP stdio (Claude Desktop / local agents)\n\n```bash\nnpm run mcp:stdio\n```\n\nAdd to Claude Desktop config:\n\n```json\n{\n  \"mcpServers\": {\n    \"nodeproxy\": {\n      \"command\": \"node\",\n      \"args\": [\"--import\", \"tsx\", \"/path/to/NodeProxy/src/mcp/stdio.ts\"],\n      \"env\": { \"WALLET_ADDRESS\": \"0x...\" }\n    }\n  }\n}\n```\n\n## HTTP execute example\n\n```bash\n# Stage A — get 402 challenge (includes Bazaar extension in PAYMENT-REQUIRED)\ncurl -i \"http://localhost:4022/mcp/execute\" \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"arguments\":{\"url\":\"https://example.com\"}}'\n\n# Stage B — retry with PAYMENT-SIGNATURE from x402 client wallet\ncurl \"http://localhost:4022/mcp/execute\" \\\n  -H 'Content-Type: application/json' \\\n  -H 'PAYMENT-SIGNATURE: <base64>' \\\n  -d '{\"arguments\":{\"url\":\"https://example.com\"}}'\n\n# Stealth tier (x402 only)\ncurl -i \"http://localhost:4022/stealth-scrape\" \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"arguments\":{\"url\":\"https://example.com\"}}'\n```\n\nUse `@x402/fetch`, `@x402/mcp`, or `nodeproxy-tools` for automatic payment.\n\n## Deploy on Railway\n\nRailway is the recommended host: full Node.js (JSDOM works), no 15s serverless timeout, metered billing when idle.\n\n### 1. Push to GitHub\n\n```bash\ncd NodeProxy\ngit init && git add . && git commit -m \"NodeProxy MCP x402 parser\"\ngit remote add origin https://github.com/YOU/nodeproxy.git\ngit push -u origin main\n```\n\n### 2. Create Railway project\n\n1. Go to [railway.app](https://railway.app) → **New Project** → **Deploy from GitHub repo**\n2. Select your repo — Railway reads `railway.toml` + `nixpacks.toml` automatically\n3. **Settings → Networking → Generate Domain** (gives you `*.up.railway.app`)\n\n### 3. Set environment variables\n\nIn Railway → **Variables**:\n\n| Variable | Value |\n|----------|--------|\n| `WALLET_ADDRESS` | Your Base wallet (USDC recipient) |\n| `X402_NETWORK` | `eip155:8453` |\n| `PRICE_USDC` | `0.002` |\n| `STEALTH_PRICE_USDC` | `0.05` |\n| `CDP_API_KEY_ID` / `CDP_API_KEY_SECRET` | Coinbase CDP keys (mainnet facilitator) |\n| `MPP_SECRET_KEY` / `STRIPE_SECRET_KEY` | Stripe MPP (optional) |\n| `HOST` | `0.0.0.0` |\n| `MAX_CONCURRENT_PARSES` | `20` |\n| `RATE_LIMIT_PER_MINUTE` | `120` |\n\nYou do **not** need to set `PORT` or `PUBLIC_URL` — Railway injects `PORT`, and the app auto-detects `RAILWAY_PUBLIC_DOMAIN` for discovery manifests.\n\n### 4. Verify deploy\n\n```bash\ncurl https://YOUR-APP.up.railway.app/health\ncurl https://YOUR-APP.up.railway.app/mcp/tools\ncurl https://YOUR-APP.up.railway.app/.well-known/x402.json\n```\n\n### 5. Register for agent discovery\n\nOpen a PR to the [MCP Registry](https://github.com/modelcontextprotocol/registry) with `integrations/mcp-registry/server-entry.json`. Agents hit:\n\n- `https://YOUR-APP.up.railway.app/mcp/tools`\n- `https://YOUR-APP.up.railway.app/.well-known/mcp.json`\n- `https://YOUR-APP.up.railway.app/.well-known/x402.json`\n\n### Cost expectation\n\nRailway’s free tier gives ~$1/month credit after trial — enough for low traffic (~$0.30–0.50/mo idle). One paid agent call at $0.002 USDC covers that. Scale to Hobby ($5/mo) when bot traffic grows.\n\n**Do not use** Vercel/Cloudflare Workers for this service — JSDOM and 25s fetch timeouts exceed edge limits.\n\n## Production (Base mainnet)\n\n```env\nX402_NETWORK=eip155:8453\nWALLET_ADDRESS=0xYourWallet\nPRICE_USDC=0.002\nSTEALTH_PRICE_USDC=0.05\n```\n\nUSDC on Base: `0x833589fcd6edb6e08f4c7c32d4f71b54bda02913`\n\n## Upstream framework integrations\n\nTo get NodeProxy baked into LangChain, CrewAI, and MCP registry discovery:\n\n- **[integrations/UPSTREAM.md](./integrations/UPSTREAM.md)** — fork → PR → merge playbook\n- **`integrations/python/`** — `nodeproxy-tools` PyPI package + LangChain/CrewAI wrappers\n- **`integrations/typescript/`** — `@nodeproxy/langchain` npm package\n- **`integrations/mcp-registry/`** — MCP registry PR template\n\nQuick LangChain example:\n\n```python\npip install \"nodeproxy-tools[x402,langchain]\"\nexport EVM_PRIVATE_KEY=0x...\n\nfrom nodeproxy_tools.langchain import NodeProxyMarkdownTool\ntool = NodeProxyMarkdownTool()\nmarkdown = tool.invoke({\"url\": \"https://example.com\"})\n```\n\n## Naming\n\n**NodeProxy** is registry-ready: boring, predictable, and reads as infrastructure. Tool names (`surface_markdown_parser`, `stealth_markdown_parser`) are chosen so semantic search hits match intent.\n\n## License\n\nMIT\n\n## Part of Gate402\n\nThis service is part of the [Gate402](https://gate402.app) x402 agent-API suite — pay-per-call APIs for AI agents over HTTP 402 (USDC on Base). Use it standalone, through the unified storefront + CDP x402 Bazaar at [gate402.app](https://gate402.app), or as an MCP server: `npx -y gate402-mcp`.\n",
  "bytes": 8929,
  "sha": "6e7b4c44d5e0b0c1d207283c22e7da691f53e097474312f40c6c0b879f8497d4",
  "repo_slug": "pgalyen1987/nodeproxy",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_pgalyen1987_nodeproxy_4545678a/readme"
}