is-real-biz

API de pago por llamada que indica a los agentes de IA si un dominio es una empresa real. Creado con prioridad en MCP. Dos vías de pago: x402 (autónomo, sin registro) + créditos prepagados (50 comprobaciones gratuitas, sin tarjeta de crédito).

🚀 En vivo: https://is-real-biz.is-real-biz.workers.dev — pruébalo ahora:

curl -X POST https://is-real-biz.is-real-biz.workers.dev/billing/signup \
  -H 'content-type: application/json' -d '{"email":"you@example.com"}'
# returns: { api_key: "irb_live_...", credits_cents: 250 } — 50 free checks

GET /check?domain=stripe.com   →   { verdict: "real", score: 94, signals: { ... } }

Casos de uso: KYB / selección de proveedores, calificación de clientes potenciales, comprobaciones de fraude, diligencia debida — en cualquier lugar donde un agente necesite saber "¿es este dominio una empresa legítima o un sitio aparcado/estafa/falso?"

Por qué los agentes encontrarán esto

Superficies de descubrimiento (sobre-servidas a propósito — cada agente busca en un lugar diferente):

Además, las descripciones de las herramientas en src/tool-descriptions.ts están escritas para la selección de herramientas basada en incrustaciones — la forma en que Claude/ChatGPT/Cursor realmente eligen qué herramienta llamar. Muchos ejemplos en lenguaje natural, etiquetas de casos de uso y consultas de ejemplo.

Por qué los agentes pueden pagar por ello

• x402 (especificación) — el protocolo de pago HTTP 402 impulsado por Coinbase + Cloudflare. Los agentes envían un encabezado X-PAYMENT, el servidor verifica + liquida a través de un facilitador en ~2 segundos. Cero registro. Sin cuentas. Las llamadas de sub-centavos funcionan. La red predeterminada es Base Sepolia testnet (gratuita) — cambia X402_NETWORK = "base_mainnet" en wrangler.toml para aceptar pagos reales.

• Créditos prepagados — POST /billing/signup con un correo electrónico devuelve una clave API con 50 comprobaciones gratuitas. ¿Necesitas más? Canjea un código promocional emitido por el operador en /billing/promo. Sin tarjeta de crédito, sin Stripe, sin tarjeta registrada.

Ambas rutas comparten el mismo punto final /check, por lo que cualquier agente que hable cualquiera de las dos vías simplemente funciona.

Despliegue de coste cero (≈ 5 minutos)

Solo necesitas:

1. Una cuenta gratuita de Cloudflare (el subdominio workers.dev es gratuito para siempre) — regístrate

2. Una clave gratuita de Google AI Studio para Gemini 1.5 Flash (sin tarjeta de crédito) — obtener clave

Luego:

git clone <this repo> is-real-biz && cd is-real-biz
npm run setup      # runs deploy.sh — creates D1, KV, applies schema, sets secrets, deploys

El script es interactivo: te conecta a Cloudflare, aprovisiona D1 + KV, parchea wrangler.toml con los IDs, solicita tu clave de Gemini y despliega. Tendrás una URL en vivo como https://is-real-biz.<tu-subdominio>.workers.dev.

Despliegue manual

npm install
npx wrangler login
npx wrangler d1 create is-real-biz-db          # paste id into wrangler.toml
npx wrangler kv namespace create CACHE         # paste id into wrangler.toml
npx wrangler d1 execute is-real-biz-db --file=./schema.sql --remote
npx wrangler secret put GEMINI_API_KEY
npx wrangler deploy

Secretos opcionales

npx wrangler secret put ADMIN_TOKEN     # to mint promo codes via POST /admin/promo
npx wrangler secret put X402_PAY_TO     # your 0x address to enable x402 payments

Pruébalo

# 1. Get a free key (50 checks included)
curl -X POST https://YOUR-WORKER-URL/billing/signup \
  -H 'content-type: application/json' \
  -d '{"email":"you@example.com"}'

# 2. Check a domain
curl 'https://YOUR-WORKER-URL/check?domain=stripe.com' \
  -H 'authorization: Bearer irb_live_...'

# 3. Batch
curl -X POST https://YOUR-WORKER-URL/check/batch \
  -H 'authorization: Bearer irb_live_...' \
  -H 'content-type: application/json' \
  -d '{"domains":["stripe.com","openai.com","sketchy.xyz"]}'

Úsalo desde Claude / Cursor / Windsurf (MCP)

{
  "mcpServers": {
    "is-real-biz": {
      "url": "https://YOUR-WORKER-URL/mcp",
      "headers": { "Authorization": "Bearer irb_live_..." }
    }
  }
}

Emisión de códigos promocionales (operador)

# Mint a 100-credit ($1) code, single use
curl -X POST https://YOUR-WORKER-URL/admin/promo \
  -H "X-Admin-Token: $ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"amount_cents":100,"max_uses":1,"note":"HN launch"}'

# Mint a multi-use launch code
curl -X POST https://YOUR-WORKER-URL/admin/promo \
  -H "X-Admin-Token: $ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"code":"LAUNCH50","amount_cents":250,"max_uses":500}'

Cómo se calcula el veredicto

Combinación ponderada → puntuación 0-100 → veredicto {real, likely_real, uncertain, likely_fake, fake}. Caché durante 24h en KV.

Enviar a registros MCP (después del despliegue)

• registry.modelcontextprotocol.io — oficial, formulario de envío post-despliegue

• smithery.ai — pega el smithery.yaml

• glama.ai/mcp/servers — formulario de envío

• mcp.so — abrir PR

• mcpservers.org — abrir PR

• awesome-mcp-servers — abrir PR

• El x402 Bazaar te indexa automáticamente después de la primera llamada pagada — no se necesita envío.

Licencia

MIT.