Hunter MCP

Hunter MCP

Hunter.io MCP 服务。11 个工具涵盖域名搜索、电子邮件查找与验证、信息补充、公司发现和潜在客户管理。

安装

Claude Code：

claude mcp add hunter -e HUNTER_API_KEY=your-key -- npx -y @scalably-io/hunter-mcp

Codex：

codex mcp add hunter --env HUNTER_API_KEY=your-key -- npx -y @scalably-io/hunter-mcp

Claude Desktop：从最新的 GitHub 发布版本下载 hunter-mcp.mcpb 并打开。

设置

1. 在 hunter.io/api-keys 创建 API 密钥。
2. create_lead 会将数据写入 Hunter 潜在客户列表，是唯一一个会修改数据的工具；其他 10 个工具均为只读。

工具（11 个）

工具	功能
account_info	读取 Hunter v2 账户方案和当前准确的额度使用情况，包括剩余的统一额度或各类型额度
domain_search	使用当前人员、验证、位置、职位、决策者、聚合和偏移量筛选条件，搜索一个域名/公司的 Hunter v2 邮箱
email_finder	根据公司/域名和姓名查找最可能的专业邮箱并自动验证，也可直接根据 LinkedIn 账号标识查找
email_verifier	使用 Hunter v2 验证一个电子邮件地址，并返回准确的可送达性、评分、SMTP/MX、全收、网页邮箱、一次性邮箱和来源证据
email_count	统计一个域名/公司的 Hunter 邮箱覆盖情况，可选仅统计个人或通用地址，不返回地址
email_enrichment	使用 Hunter v2，根据电子邮件地址或 LinkedIn 账号标识补充个人信息，可选采用兼容 Clearbit 的格式
company_enrichment	使用 Hunter v2，根据域名补充公司信息，可选采用兼容 Clearbit 的格式
combined_enrichment	使用 Hunter v2，根据一个电子邮件地址同时补充个人及其公司信息，可选采用兼容 Clearbit 的格式
discover	使用 Hunter Discover v2，通过当前的自然语言或结构化组织、位置、行业、员工人数、类型、年份、关键词、技术和融资筛选条件查找公司
create_lead	根据必填的电子邮件地址和可选的当前潜在客户字段、列表位置及自定义属性创建一个 Hunter 潜在客户。此操作仅尝试一次
list_leads	使用当前列表、身份、公司、状态、验证、活动/日期、位置、标签、营销活动、用户、置信度、自定义属性、查询和偏移量筛选条件列出 Hunter 潜在客户

配置

变量	必填	用途
HUNTER_API_KEY	是	来自 hunter.io/api-keys 的 Hunter.io API 密钥
HUNTER_API_BASE	否	覆盖 Hunter API 基础 URL（默认值为 https://api.hunter.io/v2）
HUNTER_TIMEOUT_MS	否	每个请求的超时时间，单位为毫秒（默认值为 30000）
HUNTER_RETRY_BASE_MS	否	GET 重试退避的基础延迟，单位为毫秒（默认值为 500）

回复格式

每个工具都返回纯 JSON，包含 status（succeeded、partial、no_op）、operation、summary、target、result、proof、warnings、recovery。失败时会抛出纯错误字符串：<code>: <message> <hint>。

限制

Hunter 各方案的请求配额会显示在 account_info 中。

验证

每个发布版本都会在 CHANGELOG.md 中列出软件包版本、.mcpb 的 sha256 和其所基于的生产提交。每次推送时，CI 都会运行测试并对打包后的 tarball 执行全新安装。

隐私政策

此服务在你的计算机上本地运行，使用你自己的凭据。它不收集个人数据，不包含遥测功能，不会持久化存储任何内容，并且只会与其封装的供应商 API 通信。包括 Scalably 在内的任何第三方都不会收到你的数据。联系方式：[email protected]。规范版本：https://scalably.io/connector-privacy.html

许可证

MIT。版权所有：Scalably。