BizNetAI

io.github.biznetai由 GitHub 账号 biznetai 发布v1.0.0更新于 Oct 25, 2026

Routes natural-language shopping queries to merchant storefronts, returns normalized results.

已验证Streamable HTTP可网页运行网页搜索与抓取商业与电商

概览

AI 生成的概览

托管型 MCP 服务器,将自然语言购物查询路由到独立商户店铺,并返回规范化的商品与商户结果。

可以做什么
按国家列出商户类目与商户目录,支持分页和按类目筛选;或按查询查找当前可确认在线的商户。列出某国家可用的商品品类及各自的结果数量。将查询匹配到精选品类后搜索商品,返回该品类已排序的规范化结果,含价格、库存状态、链接与相关度分数。
适用场景
适合构建需要美国与加拿大众多独立店铺实时商品和商户数据的 AI 购物助手或智能体,无需逐个对接商户。也适合在发起定向搜索前,先了解某国家有哪些商户和商品品类。
运行要求
远程 streamable-HTTP 端点,无需本地安装。每次请求都需在 Authorization 头中携带 Bearer API 密钥,需提交邮箱、姓名和用途说明并等待审批后获取。仅支持 stdio 的客户端需借助 mcp-remote 之类的桥接。需要能访问该托管服务的网络。
安装前请注意
API 密钥仅显示一次且无法找回,应作为机密保管,避免写入共享配置。每个密钥有速率限制(默认每分钟 60 次请求),超限返回 429。结果来自第三方商户目录,价格、库存状态和相关度分数可能过时或不完整,部分列出的商户端点可能暂时无法访问。

安装

在 SourceWeft 中

  1. 打开 控制台中的 BizNetAI,将其添加到工作区。
  2. 连接 Authorization token 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.biznetai%2Fbiznetai-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "biznetai": {
      "type": "http",
      "url": "https://biznetaimcp.consumergenie.net/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

BizNetAI MCP Server

A hosted Model Context Protocol server that routes natural-language shopping queries to live, independent merchant storefronts and returns normalized product and merchant results — built for AI agents and shopping assistants that need real-time commerce data without integrating each merchant individually.

This repository documents the hosted service — there is nothing to install or run locally. Point your MCP client at the endpoint below with an API key and start calling tools.


Merchant Coverage

18,000+ live merchants and growing, across the US and Canada.

Current focus verticals:

skincare · haircare · cosmetics · personal_care · sports_active_wear · clothing · accessories · fine_jewelry · fashion_jewelry · specialty_food · gourmet_food · food_and_beverage · home_decor · home_furnishings · candles_fragrance · wellness · luxury · electronics · consumer_goods · pet · baby_kids

Use list_categories for the authoritative, up-to-date list at query time — new verticals are added periodically.

Use find_merchants for live merchant coverage, or list_merchants for the complete merchant directory (no liveness filtering) — both updated periodically.


Endpoint

URLhttps://biznetaimcp.consumergenie.net/mcp
Transportstreamable-http
AuthRequired — Authorization: Bearer <api_key> on every request

The server is stateless per request — there is no session handshake to perform first.


Getting an API Key

Access is self-serve:

  1. Submit a request with your email, name, and a short description of your use case:
    bash
    curl -X POST https://api.merchant.registration.consumergenie.net/api/developer-keys \  -H "Content-Type: application/json" \  -d '{"email": "[email protected]", "name": "Your Name", "reason": "Building an AI shopping assistant"}'
  2. Once approved, you'll receive an email with your key (bnai_live_...). It's shown once and never stored in plaintext anywhere — if you lose it, request a new one.

Each key has its own rate limit (default 60 requests/minute). Exceeding it returns 429 with a Retry-After header; a missing, invalid, or revoked key returns 401.


Connecting

MCP client (Claude Desktop, Claude Code, etc.)

Most clients speak stdio, so bridge through mcp-remote, passing your key as a header:

json
{  "mcpServers": {    "biznetai": {      "command": "npx",      "args": [        "-y", "mcp-remote",        "https://biznetaimcp.consumergenie.net/mcp",        "--header", "Authorization:Bearer ${BIZNETAI_API_KEY}"      ]    }  }}

Raw HTTP

bash
BASE_URL="https://biznetaimcp.consumergenie.net/mcp"API_KEY="bnai_live_..."
curl -X POST "$BASE_URL" \  -H "Content-Type: application/json" \  -H "Accept: application/json, text/event-stream" \  -H "Authorization: Bearer $API_KEY" \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_categories","arguments":{}}}'

Tools

list_categories

Return the full BizNetAI merchant category vocabulary. Useful for understanding what kinds of merchants are available before querying.

find_merchants

Find live merchants matching a query — useful when you want merchant identity before doing a custom product lookup.

query    str   required   Natural language search querycountry  str   required   ISO country code (e.g. US, CA)limit    int   0          Max merchants to return (0 = all live matches)

list_merchants

List every active merchant straight from the database — no liveness probing and no ranking, so the result is complete and the same from one call to the next. Use it when you need the merchant directory; use find_merchants when you need endpoints confirmed reachable right now (a merchant whose endpoint is slow to answer can be missing from a find_merchants result). Some listed endpoints may be temporarily unreachable.

country   str   required   ISO country code (e.g. US, CA)category  str   omit       One value from list_categories; omit for every categorylimit     int   0          Page size (0 = the server page cap, 10,000)offset    int   0          Skip this many merchants; combine with limit to page

Returns merchants sorted by store_domain:

json
{  "store_domain": "naturium.com",  "store_url": "https://naturium.com",  "mcp_endpoint": "https://naturium.com/api/mcp",  "categories": ["skincare"],  "source_country": "US",  "last_seen_at": "2026-06-07T02:18:00Z"}

list_product_varieties

List the product varieties available for a country, with how many results each has. find_products always resolves your query to one of these, so this is useful for discovering what specific product searches are likely to succeed — and how many results to expect — before calling it.

country  str   required   ISO country code (e.g. US, CA)

Returns a list of variety objects:

json
{  "variety": "wireless headphones",  "product_count": 50}

Varieties are country-specific — the same product type can exist under a differently-worded variety, or not at all, in a different country.

find_products

Search for products by matching your query to one of BizNetAI's curated product varieties (e.g. "wireless headphones", "vitamin c serum") and returning that variety's already-ranked top results. Call list_product_varieties first if you want to see upfront what's available for a country before searching.

query    str   required   Natural language product search querycountry  str   required   ISO country code (e.g. US, CA)limit    int   0          Page size (0 = server default)offset   int   0          Results to skip, for paging beyond the first page

Results are capped by how many products the matched variety has (usually around 50, sometimes fewer for a niche search) — offset/limit beyond that returns whatever's left, not an error. A query that doesn't match any known variety returns [].

Returns a list of normalized product objects:

json
{  "title": "Vitamin C Brightening Serum",  "description": "...",  "price_min": 24.60,  "price_max": 24.60,  "currency": "USD",  "available": true,  "url": "https://merchant.com/products/vitamin-c-serum",  "image_url": "https://cdn.shopify.com/...",  "store_domain": "merchant.com",  "mcp_endpoint": "https://merchant.com/api/mcp",  "merchant_position": 0,  "relevance_score": 0.79}

available reflects whether at least one product variant was in stock as of the last catalog refresh (boolean only — exact stock counts aren't available from all merchant backends). relevance_score is a similarity score (higher is more relevant) — there's no cutoff applied, so you can use it yourself to judge what's a good enough match for your use case.


Rate Limits & Errors

StatusMeaning
401Missing, malformed, invalid, or revoked API key
429Rate limit exceeded — see Retry-After header for when to retry

Support

Questions or issues with the API — email the address you used to request your key, or open an issue on this repository.

License

MIT

来源:README.md,提交 7a409d0

工具

0
该服务器需要 API 密钥等凭据,因此 SourceWeft 无法在没有凭据的情况下读取其工具,也未收录。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分