is-real-biz

AIエージェントがドメインの実在性を判断するための従量課金制API。 MCPファーストで構築されています。2つの支払いレールに対応：x402（自律的、登録不要）+ プリペイドクレジット（50回分無料、クレジットカード不要）。

🚀 ライブデモ: 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 / ベンダー審査、リードクオリフィケーション、不正チェック、デューデリジェンスなど、エージェントが「このドメインは正当な企業か、それとも放置/詐欺/偽サイトか？」を知る必要があるあらゆる場面で利用可能です。

エージェントがこのツールを見つける理由

発見用インターフェース（意図的に過剰に提供しています — エージェントごとに参照先が異なるため）：

インターフェース	パス	仕様
MCP記述子	`/.well-known/mcp.json`	modelcontextprotocol.io
MCP HTTPエンドポイント	`/mcp`	ストリーミング可能なHTTP
OpenAPI 3.1	`/openapi.json`	OpenAPI
llms.txt	`/llms.txt`	llmstxt.org
ai.txt	`/ai.txt`	初期クローラーの慣習
ChatGPTプラグイン	`/.well-known/ai-plugin.json`	レガシー
A2Aエージェントカード	`/.well-known/agent.json`	A2A v1
agents.json	`/.well-known/agents.json`	ワイルドカード仕様
料金マニフェスト	`/pricing.json`	このサーバー
robots/sitemap	`/robots.txt`, `/sitemap.xml`	SEO

さらに、src/tool-descriptions.ts 内のツール説明は、埋め込みベースのツール選択（Claude/ChatGPT/Cursorが実際にどのツールを呼び出すかを決定する方法）のために記述されています。自然言語の例、ユースケースタグ、クエリ例が豊富に含まれています。

エージェントが支払い可能な理由

x402 (仕様) — CoinbaseとCloudflareが推進するHTTP 402決済プロトコル。エージェントが X-PAYMENT ヘッダーを送信し、サーバーがファシリテーターを介して約2秒で検証・決済します。登録不要。アカウント不要。サブセント単位の呼び出しも可能。 デフォルトのネットワークは Base Sepoliaテストネット（無料）です。wrangler.toml で X402_NETWORK = "base_mainnet" に変更すれば、実際の支払いを受け取れます。
プリペイドクレジット — メールアドレスを指定して POST /billing/signup を実行すると、50回分の無料チェックが付いたAPIキーが返されます。追加が必要な場合は、/billing/promo でオペレーター発行のプロモーションコードを利用してください。クレジットカード、Stripe、カード登録は一切不要です。

どちらのパスも同じ /check エンドポイントを共有しているため、どちらかのレールに対応しているエージェントであればそのまま動作します。

ゼロコストデプロイ（約5分）

必要なもの：

無料の Cloudflare アカウント（workers.devサブドメインは永続無料） — サインアップ
Gemini 1.5 Flash用の無料 Google AI Studio キー（クレジットカード不要） — キーを取得

手順：

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のプロビジョニング、IDを用いた wrangler.toml のパッチ適用、Geminiキーの入力要求、そしてデプロイまでを自動で行います。https://is-real-biz.<your-subdomain>.workers.dev のようなライブURLが生成されます。

手動デプロイ

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

判定結果の算出方法

シグナル	ソース	コスト
ドメイン年齢 + レジストラ	RDAP via `rdap.org`	無料
SSLの有効性	証明書透明性 (`crt.sh`)	無料
ホームページの分類	Gemini 1.5 Flash	無料 (1500回/日)
連絡先情報の存在	ホームページ + `/contact` に対する正規表現	無料
ソーシャルメディアの足跡	ホームページに対する正規表現	無料

これらを加重結合し、0〜100のスコアを算出し、判定結果 {real, likely_real, uncertain, likely_fake, fake} を導き出します。結果はKVに24時間キャッシュされます。

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。

Smart Link