ghostdom

Navegador headless como JSON para agentes de IA, con economía de mercado de memoria: el primer agente en renderizar una URL recibe un pago cada vez que otro agente obtiene un acierto de caché para la misma URL durante el TTL de 10 minutos.

Endpoint en vivo: https://ghostdom.jason-12c.workers.dev/

curl https://ghostdom.jason-12c.workers.dev/ devuelve un manifiesto completo legible por máquina. Cero HTML. Solo para agentes.

Stack

• Cómputo: Cloudflare Workers

• Renderizado: Cloudflare Browser Rendering API (Chromium real)

• Libro mayor: Durable Objects (una instancia por hash de URL, reclamación atómica del originador)

• Caché: Workers KV (cargas útiles renderizadas + capturas de pantalla, TTL de 10 min)

• Liquidación: Cabeceras x402 + micro-saldos en USDC dentro de la billetera

Mercado de memoria

Endpoint principal

POST /render
Headers: X-Wallet: <wallet>, X-Wallet-Key: <signing_key>, Content-Type: application/json
Body:    { "url": "https://...", "wait_for": "optional CSS selector" }

Response:
{
  "rendered_html": "...",
  "structured_dom": { tag, id, cls, text, children },
  "title": "...",
  "visible_text": "...",
  "screenshot_url": "https://.../v1/screenshot/<hash>",
  "links": [ { href, text }, ... ],
  "status": 200,
  "render_time_ms": 3425,
  "cache_hit": true/false,
  "cache_age_s": 172,
  "originator_wallet": "0x...",
  "role": "originator" | "cache_hit",
  "cost_usd": 0.0012,
  "payout": { "to_originator_usd": 0.00108, "to_platform_usd": 0.00012 },
  "wallet_balance_usd": 0.9904
}

Descubrimiento

• GET /.well-known/ai-plugin.json

• GET /.well-known/mcp.json

• GET /llms.txt

• GET /openapi.json

• GET /v1/pricing

• GET /v1/errors

Autenticación

# 1. Mint a wallet
curl -X POST https://ghostdom.jason-12c.workers.dev/v1/wallets

# 2. Fund it ($1 via x402 test-mode)
curl -X POST https://ghostdom.jason-12c.workers.dev/v1/wallets/fund \
  -H "Content-Type: application/json" \
  -d '{"wallet":"0x...", "amount_usd": 1}'
# Follow the returned payment_url to complete

# 3. Render
curl -X POST https://ghostdom.jason-12c.workers.dev/render \
  -H "X-Wallet: 0x..." -H "X-Wallet-Key: gd_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

MCP

HTTP/JSON-RPC 2.0 en /mcp, protocolo 2024-11-05. Herramientas: ghostdom_render, ghostdom_wallet_info.

Seguridad

• Protección SSRF: 127/8, 10/8, 192.168/16, 172.16/12, 169.254/16, metadata.internal, todos rechazados.

• Máximo de 1.5 MB de HTML renderizado mostrado. Tiempo de espera del navegador de 20s.

• TTL de captura de pantalla = TTL de caché = 10 minutos.

Licencia

Apache 2.0.