关于 Potarix Enricher
Potarix Enricher 是供 AI Agent 使用的企业信息查询 MCP 服务,可查找公司网站、验证商务邮箱并获取公司联系人名单。它同时支持通过人工确认卡片的流程,在 Agent 中注册并购买额度。
主要功能
- 01按公司名称查询官网
- 02查找指定人员的验证邮箱
- 03按公司类别查找决策者及邮箱
- 04按 LinkedIn 资料查找邮箱
- 05获取公司公开联系名单
- 06查询余额并管理额度
适用场景
- 01为潜在客户名单补充公司官网
- 02查找指定企业联系人的商务邮箱
- 03按业务类别定位可能的采购决策者
- 04在 Agent 工作流中为查询服务充值
MCP 相关
该 MCP 服务将 Potarix Enricher API 的企业网站和邮箱查询、联系人名单、余额及额度管理功能作为工具提供。支持托管的 Streamable HTTP 连接和本地 stdio 连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.potarix.com/mcpclaude mcp add --transport http potarix-potarix https://api.potarix.com/mcp{"mcpServers":{"potarix-potarix":{"type":"http","url":"https://api.potarix.com/mcp"}}}在 Cursor 中打开{"servers":{"potarix-potarix":{"type":"http","url":"https://api.potarix.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"potarix-potarix":{"type":"http","url":"https://api.potarix.com/mcp"}}}{"mcpServers":{"potarix-potarix":{"serverUrl":"https://api.potarix.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Potarix MCP 服务
Potarix Enricher 的 MCP 封装。让 AI Agent 可以解析公司网站、查找经过验证的电子邮件,并获取完整的公司联系人名单;还可以(通过一次需要人工介入的银行卡信息录入)完全通过 Agent 注册并购买点数。
工具
| 工具 | 功能 | 费用 |
|---|---|---|
lookup_company_website | 公司名称 → 网站 URL | 2 点 |
find_person_email | 指定人员 + 公司/域名 → 已验证的电子邮件 | 25 点 |
find_decision_maker_email | 类别 + 域名 → 可能的买家姓名 + 电子邮件 | 25 点 |
find_linkedin_email | LinkedIn 个人资料 URL → 已验证的电子邮件 | 10 点 |
find_company_emails | 域名 → 公开的公司联系人名单 | 25 点 |
find_all | 单个公司名称 → 网站 + 决策者 + 完整公司电子邮件列表 | 上述费用之和 |
check_balance | 点数、电子邮件、已保存银行卡状态、密钥数量 | 免费 |
start_checkout | 首次添加银行卡时获取 Stripe URL | 不适用 |
topup_credits | 从已保存的银行卡扣款并添加点数 | 不适用 |
1 点 = $0.01。试用账户会获得 25 点免费额度。每个端点的收费都不低于服务商最坏情况下的 COGS——即使命中结果也不会亏损;提前终止的瀑布式调用还能带来利润。
两种连接方式
| 传输方式 | 端点 | 适用场景 |
|---|---|---|
| Streamable HTTP(托管) | https://api.potarix.com/mcp | 远程 Agent(Claude、ChatGPT)——无需安装 |
| stdio(npm 包) | npx -y potarix-mcp | 本地/桌面客户端 |
两种方式都提供相同的九个工具。托管服务无状态且支持多租户:每个请求都通过自己的 Authorization: Bearer ptk_live_... 标头进行授权,因此无需为每位用户单独部署。
托管版(Streamable HTTP)
让任何支持 Streamable HTTP 的 MCP 客户端连接到 https://api.potarix.com/mcp,并将密钥作为 bearer token 发送:
{
"mcpServers": {
"potarix": {
"url": "https://api.potarix.com/mcp",
"headers": { "Authorization": "Bearer ptk_live_your_key" }
}
}
}
安装(stdio)
npm install -g potarix-mcp
也可以不进行全局安装,直接运行:
npx -y potarix-mcp
配置
设置 Potarix API 密钥:
export POTARIX_API_KEY=ptk_live_your_key
可选项:
export POTARIX_API=https://api.potarix.com/enricher
Claude Desktop
{
"mcpServers": {
"potarix": {
"command": "npx",
"args": ["-y", "potarix-mcp"],
"env": {
"POTARIX_API_KEY": "ptk_live_your_key"
}
}
}
}
Claude Code
claude mcp add potarix npx -- -y potarix-mcp
然后将 POTARIX_API_KEY 添加到 Claude Code 运行所在的环境中。
开发
npm install
npm run build
npm run smoke # stdio transport: connect + tools/list
# Streamable HTTP transport:
npm run start:http # serves on http://127.0.0.1:8080/mcp (set PORT to change)
# in another shell:
POTARIX_MCP_URL=http://127.0.0.1:8080/mcp npm run smoke:http
环境变量:
| 变量 | 默认值 | 用途 |
|---|---|---|
POTARIX_API_KEY | — | API 密钥(仅适用于 stdio;HTTP 会在每个请求中从 bearer 标头读取密钥) |
POTARIX_MCP_TRANSPORT | stdio | 设置为 http 以运行 Streamable HTTP 服务(或传入 --http) |
PORT / HOST | 8080 / 127.0.0.1 | HTTP 绑定地址 |
POTARIX_MCP_PATH | /mcp | HTTP 请求路径 |
POTARIX_MCP_ALLOWED_HOSTS | — | 以逗号分隔的主机允许列表;启用 DNS 重绑定保护 |
POTARIX_API | https://api.potarix.com/enricher | 覆盖 API 基础 URL |
注册表发布
此仓库包含供官方 MCP Registry 使用的 server.json。该条目支持多种接入方式:它同时声明了托管的 Streamable HTTP 远程服务
(https://api.potarix.com/mcp)和 npm stdio 包(potarix-mcp),因此一条注册表记录就能公布两种连接方式。
注册表会通过获取 npm 包并检查其已发布的 mcpName 是否与服务端 name 一致来验证该包,因此必须先发布 npm 包,且版本必须与 server.json 中指定的版本相同(packages[].version)。
发布步骤(先更新版本,再发布 npm 包,最后发布到注册表):
# 1. Bump package.json + server.json to the same new version (e.g. 0.1.3).
# server.json must be a NEW version each publish (versions are immutable).
# 2. Build + publish the npm artifact (carries mcpName for ownership proof):
npm publish
# 3. Push the multi-surface server.json to the official MCP Registry:
mcp-publisher login github
mcp-publisher publish
package.json 中的包 mcpName 必须与 server.json 匹配:
io.github.Potarix/potarix-mcp
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。