is-real-biz

Pay-per-Call-API, die KI-Agenten mitteilt, ob eine Domain ein echtes Unternehmen ist. MCP-first entwickelt. Zwei Zahlungswege: x402 (autonom, keine Registrierung erforderlich) + Prepaid-Guthaben (50 kostenlose Prüfungen, keine Kreditkarte).

🚀 Live: https://is-real-biz.is-real-biz.workers.dev — jetzt ausprobieren:

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: { ... } }

Anwendungsfälle: KYB / Lieferantenprüfung, Lead-Qualifizierung, Betrugsprüfung, Due Diligence — überall dort, wo ein Agent wissen muss: "Ist diese Domain ein legitimes Unternehmen oder eine geparkte/betrügerische/gefälschte Seite?"

Warum Agenten dies finden werden

Discovery-Oberflächen (absichtlich überversorgt — jeder Agent sucht an einem anderen Ort):

Zusätzlich sind die Tool-Beschreibungen in src/tool-descriptions.ts für die embedding-basierte Tool-Auswahl geschrieben — die Art und Weise, wie Claude/ChatGPT/Cursor tatsächlich entscheiden, welches Tool aufgerufen werden soll. Viele Beispiele in natürlicher Sprache, Anwendungsfall-Tags und Beispielabfragen.

Warum Agenten dafür bezahlen können

• x402 (Spezifikation) — das HTTP 402-Zahlungsprotokoll, das von Coinbase + Cloudflare vorangetrieben wird. Agenten senden einen X-PAYMENT-Header, der Server verifiziert + begleicht die Zahlung über einen Vermittler in ca. 2 Sekunden. Keine Registrierung. Keine Konten. Sub-Cent-Aufrufe funktionieren. Das Standardnetzwerk ist Base Sepolia Testnet (kostenlos) — ändern Sie X402_NETWORK = "base_mainnet" in wrangler.toml, um echte Zahlungen zu akzeptieren.

• Prepaid-Guthaben — POST /billing/signup mit einer E-Mail-Adresse gibt einen API-Schlüssel mit 50 kostenlosen Prüfungen zurück. Benötigen Sie mehr? Lösen Sie einen vom Betreiber ausgestellten Promo-Code unter /billing/promo ein. Keine Kreditkarte, kein Stripe, keine hinterlegte Karte.

Beide Pfade nutzen denselben /check-Endpunkt, sodass jeder Agent, der einen der beiden Wege unterstützt, sofort funktioniert.

Kostenlose Bereitstellung (ca. 5 Minuten)

Sie benötigen nur:

1. Ein kostenloses Cloudflare-Konto (workers.dev-Subdomain ist für immer kostenlos) — registrieren

2. Einen kostenlosen Google AI Studio-Schlüssel für Gemini 1.5 Flash (keine Kreditkarte) — Schlüssel abrufen

Dann:

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

Das Skript ist interaktiv: Es meldet Sie bei Cloudflare an, stellt D1 + KV bereit, patcht wrangler.toml mit den IDs, fragt nach Ihrem Gemini-Schlüssel und führt die Bereitstellung durch. Sie erhalten eine Live-URL wie https://is-real-biz.<ihre-subdomain>.workers.dev.

Manuelle Bereitstellung

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

Optionale Geheimnisse

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

Ausprobieren

# 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"]}'

Verwendung von Claude / Cursor / Windsurf (MCP)

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

Ausgabe von Promo-Codes (Betreiber)

# 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}'

Wie das Urteil berechnet wird

Gewichtete Kombination → Score 0-100 → Urteil {real, likely_real, uncertain, likely_fake, fake}. 24 Stunden in KV zwischengespeichert.

Einreichung bei MCP-Verzeichnissen (nach der Bereitstellung)

• registry.modelcontextprotocol.io — offizielles Formular zur Einreichung nach der Bereitstellung

• smithery.ai — fügen Sie die smithery.yaml ein

• glama.ai/mcp/servers — Einreichungsformular

• mcp.so — PR öffnen

• mcpservers.org — PR öffnen

• awesome-mcp-servers — PR öffnen

• Der x402 Bazaar indexiert Sie automatisch nach dem ersten bezahlten Aufruf — keine Einreichung erforderlich.

Lizenz

MIT.