DEVELOPERS

Build on SiteBeacon

Drive the lead-gen engine from Claude Code, your own agents, or plain HTTP. Same credits, same prices, same honesty gates as the app.

1 · Get an API key

Sign in and go to Account → API keys. Create a key (sbk_…) — it's shown exactly once, so copy it immediately. Keys are stored hashed, revocable any time, and act as your account: every credit-bearing call charges your normal credit pools (personal, or a team pool via the teamId param). API access is included on every plan — credits are the only meter.

2 · MCP server (Claude Code, Claude Desktop, any agent)

The open-source MCP server runs locally over stdio and calls the REST API with your key. One command in Claude Code:

claude mcp add sitebeacon -e SITEBEACON_API_KEY=sbk_your_key_here -- npx -y @kumokodo/sitebeacon-mcp

Or in .mcp.json / Claude Desktop config:

{
  "mcpServers": {
    "sitebeacon": {
      "command": "npx",
      "args": ["-y", "@kumokodo/sitebeacon-mcp"],
      "env": {
        "SITEBEACON_API_KEY": "sbk_your_key_here"
      }
    }
  }
}

Eleven tools: search-leads (2 credits, worldwide), get-lead (free; 1 credit only when an email is found), analyze-lead (1 credit), list-searches, save-lead, list-crm-leads, get-crm-lead, update-lead (all free), find-contact (1 on email found / 2 social hunt), ai-visibility (3 per category+city, 30-day free re-runs), website-audit (2). Then just ask: "find 20 plumbers in Madrid with no website, save the best ones, and hunt down their contacts."

3 · REST API

Everything the MCP server does is plain HTTP with Authorization: Bearer sbk_…:

curl -X POST https://sitebeacon.ai/api/agent/search \
  -H "Authorization: Bearer sbk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "plumbers",
    "location": "Madrid, Spain",
    "searchMode": "website"
  }'
EndpointCreditsWhat it does
POST/api/agent/search2 (refunded on failure)Lead search by keyword + location (ZIP/postal code or freeform city, worldwide). Returns scored businesses + a searchId; results are stored for free reuse.
GET/api/agent/leadfree · 1 only if an email is foundFull detail for one lead by placeId, incl. contact-email enrichment (charge-on-success; findEmail=false to skip).
POST/api/agent/analyze1AI deficiency analysis + personalized outreach email draft for one lead.
GET/api/agent/searchesfreeList past searches (summaries).
GET/api/agent/searches/:idfreeFull stored results of a past search — reuse instead of re-paying.
GET/api/agent/mefreeKey check: your account + every credit pool (personal and teams) the key can charge.
GET/POST/api/agent/leadsfreeCRM: list saved leads / save a lead from a recorded search (personal or team CRM).
GET/PATCH/api/agent/leads/:idfreeCRM: read a lead incl. outreach pipeline state / update status, notes, contact email.
POST/api/outreach/find-contact1 on email found · 2 social huntFind Contact on a saved lead: email scrape (charge-on-success) or identity-verified Facebook/Instagram discovery, plus a rendered honesty-gated first-touch draft. Meta sends stay human-executed.
POST/api/outreach/aivis3 per category+city+languageAI-visibility check — optional `language` asks the way a local customer would ("Italian" for Trieste); each language cached separately, free re-runs for 30 days; stamps aiMentioned on matching saved leads.
POST/api/ai/website-audit2Full PageSpeed + AI audit with a ready-to-use sales pitch (slow: up to ~3 min).

4 · Credits

Agent calls charge exactly the same prices as the web app — enforced by the same shared constants in code, so they can't drift. Failed searches auto-refund, email enrichment only charges on success, and stored results are always free to re-read. Full price list (including everything that's free): What credits buy →

5 · Rate limits

  • • Searches: 20 / minute
  • • AI analysis: 30 / minute
  • • Everything else: 100 / minute

Per-minute only — no hourly or daily caps. Your credit balance is the real ceiling. A 429 includes a Retry-After header.

AGENT-READY LEAD GEN

Mint a key and start building

Every account includes API access — new signups start with 10 free credits.

Get your API keySee plans