Business Insights v2

Find a business's name, logo, merchant category code (MCC), head-office address with map coordinates, phone number, email address and social media links from its website. It's built for bank teams that do merchant onboarding, KYB, merchant risk and transaction enrichment.

Every answer comes with a status (ok, needs_review, not_found or error), a confidence, its source and the evidence it rests on, so an analyst can check it. Nothing is guessed.

$ bi2 analyze https://bellwoodsbrewery.com/ https://www.barvolo.com/ ... --fast
[5/24] https://bellwoodsbrewery.com/  name ok  logo ok  mcc ok  address ok  phone ok  email ok  social ok  7.1 s

How it works

Evidence first, models last. bi2 reads the page once, with no model: its structured data, meta tags, the images that could be its logo with their places on the screenshot, its phone numbers, emails, postcodes and links, and what Wikidata knows about big brands. Then seven field specialists run at once, each climbing a ladder that stops at the first sure answer:

1. Rules, free and instant.

2. Jev, a typed-decision model, picks among the rules' own candidates with a probability: which numbered box is the logo, which code fits, which number is the main one. It answers in under a second and can't make an answer up.

3. Gemini reads what no candidate covers, like a name inside a logo or an address in an unfamiliar format, and must quote the page.

4. An investigator searches the web for what the pages never say, like a chain's head office.

Read more in the architecture, what a site costs, and the blog post.

Related MCP server: BizIntel MCP Server

Results

On the 56 gold sites, with Jev and Gemini, on the same saved pages every run:

On the 166-site test set, which no rule was tuned on, MCC codes were right 142 times of 148, by drafted checks against each site's own title and description.

About 3 model calls a site, almost all to Jev: under a tenth of a cent a site at list prices, and nothing on the free tiers.

Install

pip install "business-insights[mcp]"     # or: uv tool install "business-insights[mcp]"
playwright install chromium

Add a key, or both. Without one, bi2 uses its rules alone.

bi2 keys set jev          # saved in the system keychain; or set JEV_API_KEY
bi2 keys set gemini       # or set GEMINI_API_KEY
bi2 doctor                # checks the keys, the models, the browser and the free services

Free keys work. bi2 keeps every model under its free tier's limits per minute and per day, counts each day's requests across runs, and keeps every answer on disk, so asking about the same site twice asks no model twice.

Use

As an MCP server

Add bi2 to Claude Code, Claude Desktop or any MCP client:

{
  "mcpServers": {
    "business-insights": { "command": "bi2", "args": ["mcp"] }
  }
}

Its tools: analyze_website, explain_field (how one field was decided, step by step), find_mcc and model_usage.

With Docker

docker run --rm -e JEV_API_KEY -e GEMINI_API_KEY -v "$PWD:/data" ghcr.io/haneeshraj/business-insights-v2 analyze https://example.com

Docs

• Architecture: what v2 does and why

• Costs: what a site costs on each provider's models, and how long it takes

• Codebase guide: how the code is organized

• Evaluation: the gold set, the test set and how answers are judged

• Contributing: setup and checks

License

MIT. See LICENSE.