is-real-biz

API с оплатой за вызов, которая сообщает AI-агентам, является ли домен реальным бизнесом. Создано с приоритетом MCP. Два способа оплаты: x402 (автономно, без регистрации) + предоплаченные кредиты (50 бесплатных проверок, без кредитной карты).

🚀 Live: https://is-real-biz.is-real-biz.workers.dev — попробуйте прямо сейчас:

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

Варианты использования: KYB / проверка поставщиков, квалификация лидов, контроль мошенничества, комплексная проверка — везде, где агенту нужно знать: "этот домен — легальный бизнес или припаркованный/мошеннический/фейковый сайт?"

Почему агенты найдут это

Поверхности обнаружения (специально избыточны — каждый агент ищет в разных местах):

Кроме того, описания инструментов в src/tool-descriptions.ts написаны для выбора инструментов на основе эмбеддингов — именно так Claude/ChatGPT/Cursor на самом деле выбирают, какой инструмент вызвать. Много примеров на естественном языке, тегов вариантов использования и примеров запросов.

Почему агенты могут платить за это

• x402 (spec) — протокол оплаты HTTP 402, продвигаемый Coinbase + Cloudflare. Агенты отправляют заголовок X-PAYMENT, сервер проверяет и проводит расчет через фасилитатор примерно за 2 секунды. Никакой регистрации. Никаких аккаунтов. Работают микроплатежи. Сеть по умолчанию — Base Sepolia testnet (бесплатно) — измените X402_NETWORK = "base_mainnet" в wrangler.toml, чтобы принимать реальные платежи.

• Предоплаченные кредиты — POST /billing/signup с адресом электронной почты возвращает API-ключ с 50 бесплатными проверками. Нужно больше? Активируйте промокод, выданный оператором, на странице /billing/promo. Никаких кредитных карт, никакого Stripe, никаких привязанных карт.

Оба пути используют один и тот же эндпоинт /check, поэтому любой агент, поддерживающий любой из этих способов, будет работать.

Бесплатное развертывание (≈ 5 минут)

Вам понадобятся только:

1. Бесплатный аккаунт Cloudflare (поддомен workers.dev бесплатен навсегда) — зарегистрироваться

2. Бесплатный ключ Google AI Studio для Gemini 1.5 Flash (без кредитной карты) — получить ключ

Затем:

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

Скрипт интерактивен: он авторизует вас в Cloudflare, подготавливает D1 + KV, патчит wrangler.toml с ID, запрашивает ваш ключ Gemini и выполняет развертывание. У вас будет живой URL вида https://is-real-biz.<ваш-поддомен>.workers.dev.

Ручное развертывание

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

Дополнительные секреты

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

Попробуйте

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

Используйте из Claude / Cursor / Windsurf (MCP)

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

Выпуск промокодов (оператор)

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

Как вычисляется вердикт

Взвешенная комбинация → оценка 0-100 → вердикт {real, likely_real, uncertain, likely_fake, fake}. Кэшируется на 24 часа в KV.

Отправка в реестры MCP (после развертывания)

• registry.modelcontextprotocol.io — официальная форма отправки после развертывания

• smithery.ai — вставьте smithery.yaml

• glama.ai/mcp/servers — форма отправки

• mcp.so — открыть PR

• mcpservers.org — открыть PR

• awesome-mcp-servers — открыть PR

• x402 Bazaar автоматически индексирует вас после первого платного вызова — отправка не требуется.

Лицензия

MIT.