is-real-biz

AI 에이전트에게 도메인이 실제 기업인지 알려주는 호출당 과금(Pay-per-call) API입니다. 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 하위 도메인은 영구 무료) — 가입하기
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.org`를 통한 RDAP	무료
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