BizNetAI

BizNetAI MCP Server

一个托管的 Model Context Protocol 服务，可将自然语言购物查询路由到实时运营的独立商家店铺，并返回经过规范化处理的商品和商家结果。它专为需要实时商务数据、又无需逐一集成各个商家的 AI Agent 和购物助手而构建。

此代码库介绍的是托管服务——无需在本地安装或运行任何内容。使用 API 密钥将 MCP 客户端指向下方端点，即可开始调用工具。

---

商家覆盖范围

覆盖美国和加拿大的 18,000 多家实时运营商家，且数量仍在增长。

当前重点品类：

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

使用 list_categories 获取查询时权威且最新的列表——我们会定期添加新品类。

使用 find_merchants 查询实时商家覆盖范围，或使用 list_merchants 获取完整的商家目录（不进行可用性筛选）——两者都会定期更新。

---

端点

URL	https://biznetaimcp.consumergenie.net/mcp
传输方式	streamable-http
身份验证	必需——每个请求都要携带 Authorization: Bearer <api_key>

服务按请求保持无状态——无需先进行会话握手。

---

获取 API 密钥

可自行申请访问权限：

1. 提交申请，提供你的电子邮件、姓名以及简短的用例说明：

   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. 申请获批后，你会收到一封包含密钥（bnai_live_...）的电子邮件。密钥仅显示一次，且绝不会以明文形式存储在任何地方——如果丢失，请重新申请。

每个密钥都有独立的速率限制（默认每分钟 60 个请求）。超出限制会返回带有 Retry-After 标头的 429；密钥缺失、无效或已撤销则会返回 401。

---

连接

MCP 客户端（Claude Desktop、Claude Code 等）

大多数客户端使用 stdio 通信，因此可以通过 mcp-remote 建立桥接，并将密钥作为标头传递：

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

原始 HTTP

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":{}}}'

---

工具

list_categories

返回 BizNetAI 商家类别的完整词汇表。在查询前了解有哪些类型的商家可用时很有帮助。

find_merchants

查找与查询匹配的实时商家——如果你想在自行查询商品前先了解商家信息，这个工具很有用。

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

list_merchants

直接从数据库列出所有活跃商家——不进行可用性探测或排序，因此结果完整，且每次调用的结果都相同。需要商家目录时使用此工具；需要确认端点当前可访问时使用 find_merchants（端点响应缓慢的商家可能不会出现在 find_merchants 的结果中）。部分列出的端点可能暂时无法访问。

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

按 store_domain 排序返回商家：

{
  "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

列出某个国家/地区可用的商品细分类别及其结果数量。find_products 总会将你的查询解析为其中一个细分类别，因此在调用前可以通过此工具了解哪些具体商品搜索可能成功，以及预期会有多少结果。

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

返回细分类别对象列表：

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

细分类别因国家/地区而异——同一种商品类型在不同国家/地区可能对应不同措辞的细分类别，也可能根本不存在。

find_products

通过将查询与 BizNetAI 精选的产品类别（例如 "wireless headphones"、"vitamin c serum"）匹配，搜索产品并返回该类别中已排名的热门结果。如果想在搜索前查看某个国家/地区有哪些类别可用，请先调用 list_product_varieties。

query    str   required   Natural language product search query
country  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

结果数量上限取决于匹配类别中的产品数量（通常约为 50 个，细分搜索有时会更少）——超出上限的 offset/limit 会返回剩余结果，而不会报错。查询与任何已知类别都不匹配时，会返回 []。

返回规范化产品对象列表：

{
  "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 表示上次目录刷新时是否至少有一个产品变体有库存（仅为布尔值——并非所有商家的后端都能提供确切库存数量）。relevance_score 是相似度分数（分数越高，相关性越强）——不会应用截止值，因此你可以自行判断结果是否足以满足使用场景。

---

速率限制与错误

状态	含义
401	缺少、格式错误、无效或已撤销的 API 密钥
429	超出速率限制——请查看 Retry-After 标头，了解何时重试

---

支持

如有 API 相关问题或疑问，请发送邮件至你申请密钥时使用的邮箱地址，或在此代码库中提交问题。

许可证

MIT