b2bleads-mcp

B2BLeads MCP 服务

一个 MCP（Model Context Protocol）服务，为 AI Agent——Claude、Cursor 及其他任何兼容 MCP 的客户端——提供 search_leads 工具，用于实时发现和丰富 B2B 公司信息。

向你的 Agent 提出如下请求：

“查找慕尼黑有网站和电话号码的建筑公司。”

“收集 50 家柏林评分高于 4.0 的 IT 公司。”

“为这份潜在客户名单补充可用的电子邮件联系人。”

……它就会调用此工具，返回整理好的公司列表：公司名称、地址、电话、网站，以及可用时的电子邮件地址。

此服务是 B2BLeads REST API 的轻量 MCP 封装。你需要拥有 B2BLeads 账号和 API 密钥——请参阅下方的获取 API 密钥。

要求

• Node.js 18 或更高版本
• B2BLeads API 密钥（注册）

安装

无需安装——直接使用 npx 运行。将其添加到 MCP 客户端的配置中：

Claude Desktop / Claude Code

编辑 claude_desktop_config.json（或运行 claude mcp add）：

{
  "mcpServers": {
    "b2bleads": {
      "command": "npx",
      "args": ["-y", "b2bleads-mcp"],
      "env": {
        "B2BLEADS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

将相同的代码块添加到项目中的 .cursor/mcp.json（或 Cursor 的全局 MCP 设置）。

其他任何 MCP 客户端

将命令 npx -y b2bleads-mcp 配置为运行目标，并设置 B2BLEADS_API_KEY 环境变量。

获取 API 密钥

1. 在 b2bleadsapi.com 创建账号。
2. 在 Billing 中选择套餐。
3. 在控制面板的 API Keys 下生成密钥。
4. 在 MCP 客户端配置中将其设为 B2BLEADS_API_KEY（见上文）。

工具

search_leads

实时搜索公司和商务联系人。

参数	类型	描述
q	string	自由文本查询，例如 "construction companies in Munich"。
industry	string	list_industries 中的某个类别。
city	string	搜索所在的城市或地区。
radius_km	number	搜索半径，单位为公里。
min_rating	number	最低评分（0-5）。
has_website	boolean	仅包含有网站的企业。
verified_only	boolean	仅包含已验证商家信息的企业。
open_now	boolean	仅包含当前营业的企业。
price_level	string	budget | moderate | expensive | luxury
rank_by	string	relevance | distance
limit	integer	每次调用的最大结果数，范围为 1-20。
lang	string	结果语言，BCP-47 标记（例如 en、pt-BR）。
page_token	string	上一次调用返回的分页令牌。
save_to_list	boolean	同时将结果保存到 B2BLeads 保存列表中。
list_id	string	要追加结果的现有保存列表 ID。
list_name	string	要查找或创建并追加结果的保存列表名称。

必须至少提供 q、industry 或 city 中的一个。

search_leads_advanced

⚠️ 成本较高：消耗单次 search_leads 调用 9 倍的配额。 仅当您需要获取特定城市中超出 search_leads 返回数量的结果，或需要全面覆盖某个城市时才使用；不要将其作为默认选项或首次尝试。该工具会在服务端将城市划分为 3x3 网格并执行子搜索，从而突破通常约 20-60 条结果的上限，单次调用最多返回约 180 家去重后的企业。不支持分页。

参数	类型	描述
q	string	自由文本查询，例如 "construction companies"。如果提供了 industry，则此项可选。
industry	string	list_industries 中的类别之一。
city	string	必填。 要搜索的城市或地区 — 必须仅填写城市名称（例如 "Lyon"），而不是完整的搜索短语，否则可能会对错误地点进行地理编码。
min_rating	number	最低评分（0-5）。
has_website	boolean	仅限有网站的企业。
verified_only	boolean	仅限已验证商家信息的企业。
open_now	boolean	仅限当前营业的企业。
price_level	string	budget | moderate | expensive | luxury
lang	string	结果语言，BCP-47 标签（例如 en、pt-BR）。

list_industries

列出可用于 search_leads 的 industry 筛选条件的预定义行业类别。不接受参数。

list_saved_lists

列出所有已保存的潜在客户列表 — 每个列表的 ID、名称和潜在客户数量，不包含潜在客户本身。只读。不接受参数。使用 get_saved_list 获取某个列表中的完整潜在客户信息。

get_saved_list

根据 ID 获取一个已保存的潜在客户列表及其中完整的已保存潜在客户信息。只读。

参数	类型	描述
list_id	string	已保存列表的 ID，可从 list_saved_lists 或 search_leads 的 save_to_list 响应中获取。必填。

find_email

尽力查找单个企业网站的联系邮箱（检查主页和常见的联系页面）。对于某个特定网站，请使用此工具，而不要重新运行 search_leads。需要任何付费套餐（Starter 及以上）；如果未找到邮箱，可能会返回 null。

参数	类型	描述
website	string	要查询的企业网站 URL，例如 https://example.com。必填。

account_get_usage

获取当前计费周期内已使用和剩余的月度搜索配额。只读。不接受参数。

account_get_usage_limit

获取账户的月度搜索配额总量，以及当前计费周期的续订时间。只读。不接受参数。

list_saved_searches

列出已保存的搜索提醒（自动定期运行并将结果保存到列表中的搜索）。只读。不接受参数。

get_search_history

获取最近的搜索历史 — 最多包含最近 200 次搜索（查询文本、结果数量、日期）。只读。不接受参数。

配置

环境变量	必需	描述
B2BLEADS_API_KEY	是	你的 B2BLeads API 密钥。
B2BLEADS_API_URL	否	覆盖 API 基础 URL。默认值为 https://api.b2bleadsapi.com。

定价与速率限制

每次搜索都会消耗 B2BLeads 套餐的配额——请参阅定价。API 会返回速率限制和配额错误，并将其作为工具错误反馈给你的 Agent。

链接

• B2BLeads 网站
• REST API 文档
• 此软件包的集成页面 — 针对纯 Node.js MCP 客户端的设置说明
• Claude Desktop / Claude Code 集成页面
• 使用条款
• 隐私政策

许可证

MIT