is-real-biz

按调用付费的 API，告诉 AI 智能体某个域名是否为真实企业。 采用 MCP 优先构建。支持两种支付轨道：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 子域名永久免费）—— 注册
一个免费的 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，使用 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