Coresignal

官方

为您的LLM和AI工作流提供全面的公司、员工和职位发布的B2B数据。

GitHub

你可以用 Coresignal MCP 做什么？

自然语言公司和人物搜索 — 使用 entity_search 以自然语言查询，询问北欧的 B2B SaaS 公司或金融科技公司的高级 Python 开发者。
按关键词发现字段名称 — 使用 entity_fields 查找正确的字段名称（例如“薪资”或“职位”），而无需加载完整的 300+ 字段词汇表。
获取完整或投影记录 — 通过 entity_fetch 使用搜索句柄（cache_id）或特定 ID 拉取完整的员工、公司或职位档案，每条记录消耗积分。
用已验证邮箱丰富联系人 — 使用 email_enrich 获取最多 1,000 个员工 ID 的已验证企业邮箱，仅对找到的邮箱收取 10 积分。
将大型结果集导出为文件 — 请求 delivery="url" 以获取可下载的 JSONL 文件用于大批量抓取，然后使用免费的 artifact_read 工具在聊天中分页浏览。

文档

Coresignal MCP v2

面向 Coresignal 的官方 Model Context Protocol 服务器 —— 将 8.95亿+ 员工、7000万+ 公司和4.68亿+ 职位发布的最新 B2B 数据直接带入你的 AI 助手。

https://mcp.coresignal.com/mcp/v2

用自然语言搜索、拉取完整记录、通过已验证邮箱丰富联系人，并将大型结果集导出为可下载文件 —— 全部可在 Claude、Cursor、Codex、VS Code 或任何其他兼容 MCP 的客户端中完成。

功能特性

OAuth 2.1 身份验证 —— 使用你的 Coresignal 控制台账户登录；配置文件中无需 API 密钥。
自然语言搜索，每一行结果都附带匹配证据，让你清楚看到每条记录为何匹配。
成本透明 —— 每次响应都会报告 credits_consumed，且高成本调用会在扣费前请求确认。
字段发现 —— entity_fields 可按关键词找到正确的字段名，免费使用，无需将 300+ 字段词汇表全部加载到上下文中。
文件下载 —— 大型结果集存储在服务器端，以下载链接形式返回，而不是刷屏聊天窗口。
artifact_read 页面可将已交付的文件免费回读至对话中 —— 即使在无法访问文件系统的客户端中也能正常工作。

前置条件

一个 Coresignal 账户，拥有有效订阅（积分额度），并在控制台中配置了团队 API 密钥。MCP 服务器会在你登录后自动解析你团队的密钥 —— 你无需将其粘贴到任何配置文件中。还没有订阅？可从 7 天免费试用开始 —— 包含 2,000 积分。参见套餐对比。

首次连接时，你的客户端会打开浏览器窗口，让你登录 Coresignal 控制台。这就是全部设置 —— 无需环境变量，无需密钥。

客户端配置

Claude Desktop

Claude Desktop 通过 Connectors 原生支持远程 MCP 服务器：

打开 设置 → Connectors → 添加自定义 connector。
名称：Coresignal，URL：https://mcp.coresignal.com/mcp/v2。
点击添加，然后连接 —— 浏览器窗口将打开，登录你的 Coresignal 控制台账户。

重要 —— 启用文件下载： Claude Desktop 会阻止来自未知域名的下载。要下载结果文件（大型抓取以链接形式交付），请在 Claude Desktop 设置中将 mcp.coresignal.com 添加到 域名允许列表（Team/Enterprise 套餐由管理员管理）。未添加时，服务器发出的下载链接将被阻止 —— 但你仍可通过免费的 artifact_read 工具在聊天中回读数据。参见文件下载。

Claude Code

claude mcp add --transport http coresignal https://mcp.coresignal.com/mcp/v2

然后在会话中运行 /mcp，选择 coresignal，并完成浏览器登录。需要重新验证身份时，随时再次运行 /mcp。

Codex（OpenAI Codex CLI）

codex mcp add coresignal --url https://mcp.coresignal.com/mcp/v2

浏览器窗口将打开，登录你的 Coresignal 控制台账户。

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "coresignal": {
      "url": "https://mcp.coresignal.com/mcp/v2"
    }
  }
}

Cursor 会检测到服务器需要身份验证，并显示 Needs login 提示 —— 点击它即可完成浏览器登录。

OpenCode

添加 Coresignal MCP：

opencode mcp add coresignal --url https://mcp.coresignal.com/mcp/v2

进行身份验证：

opencode mcp auth coresignal

浏览器窗口将打开，登录你的 Coresignal 控制台账户。

Visual Studio Code

从命令面板运行 MCP: Add Server，选择 HTTP 并输入 URL —— 或添加到 .vscode/mcp.json：

{
  "servers": {
    "coresignal": {
      "type": "http",
      "url": "https://mcp.coresignal.com/mcp/v2"
    }
  }
}

VS Code 会在首次使用时提示你授权服务器，并在浏览器中处理 OAuth 流程。

Cline

添加到 ~/.cline/data/settings/cline_mcp_settings.json：

{
  "mcpServers": {
    "coresignal": {
      "type": "streamableHttp",
      "url": "https://mcp.coresignal.com/mcp/v2",
      "disabled": false
    }
  }
}

打开 Cline MCP 界面：

cline mcp

从菜单中选择 Authorize OAuth 并选择 coresignal。Cline 将在浏览器中处理 OAuth 流程。

文件下载与域名允许列表

大型结果（以及任何带 delivery="url" 的调用）不会直接倾倒进聊天窗口，以节省 LLM 输入 token。服务器会将记录行存储为文件，并返回一个签名 HTTPS 下载链接，有效期 1 小时：

{
  "delivery": "url",
  "url": "https://mcp.coresignal.com/mcp/v2/artifacts/…?exp=…&sig=…",
  "artifact_name": "employee_fetch-baf941dd4f8c4dfe.jsonl",
  "count": 500,
  "credits_consumed": 10000
}

此后，代理可通过以下三种方式之一获取数据：

代理自行下载文件 —— 在具有 shell 访问权限的客户端中，代理通常会通过 curl 将链接下载到磁盘，并使用 grep/jq/pandas 在本地分析文件。
代理在聊天中回读 —— 在没有 shell 和文件系统的客户端中，代理改为调用 artifact_read(artifact_name, offset, limit)，通过 MCP 会话分片翻页读取文件。这是免费的，且在任何地方都可用，因此不会刷屏聊天窗口。
你手动下载 —— 如果代理本身无权获取链接（域名未加入允许列表、沙箱无网络访问），请点击链接、保存文件，并告知代理文件位置："我已将文件下载到 ~/Downloads/employee_fetch-….jsonl —— 请从那里分析。" 适用于任何可读取本地文件的客户端。

在你的客户端支持时，优先使用下载方式。 artifact_read 在 Coresignal 积分上是免费的，但并非在 LLM token 上免费：它返回的每一页都会成为对话的一部分，并在后续每一轮中作为输入 token 重新计费。每一页还被裁剪到固定的 token 预算 —— 一条完整员工记录约 8k token，因此无论你请求多大的 limit，单页也只能承载少量完整记录。以这种方式读取大文件需要数百次调用，可能在到达末尾之前就耗尽上下文窗口。而下载的文件几乎不消耗 token —— 助手可以在本地用 grep/jq 过滤数千行，只呈现答案。因此，提前配置好下载功能（域名允许列表、沙箱网络访问）是值得的，同时将 artifact_read 留给无法下载的客户端或仅用于快速查看几行数据。

如果下载被阻止，也不会丢失任何数据： 记录已经存储并完成计费 —— 使用 artifact_read 读取即可。切勿重新运行抓取来"找回"文件；那会让每条记录二次计费。

工具

工具	功能	费用
`entity_search`	对员工、公司或职位进行自然语言搜索	每次搜索 20 积分（固定）
`entity_fields`	对实体的约 300 个字段名进行关键词搜索	免费
`entity_fetch`	按搜索句柄或 ID 拉取完整（JSONL）或投影记录	每条员工/公司记录 20 积分，每条职位记录 1 积分
`email_enrich`	员工 ID 的已验证商务邮箱（CSV）	每条找到的邮箱 10 积分（未找到免费）
`artifact_read`	从已交付文件中分页回读记录行	免费

`entity_search`

使用自然语言查询搜索 employee、company 或 job 记录：

"法国金融科技公司的高级 Python 开发者"

每次调用固定费用 20 积分，并返回：

total_count —— 查询匹配的精确记录数，
最多 20 行预览（limit=0 仅返回计数），每行显示查询匹配的字段 —— 即每条结果为何出现的证据，
一个 cache_id —— 一个 1 小时有效的搜索句柄，可节省积分和时间：将其传给 entity_fetch，匹配记录将直接收集 —— 无需重新运行（并重新付费）搜索，且解析 cache_id 本身是免费的。记录 ID 保留在服务器端，因此不会有大量数据经过对话。

`entity_fields`

按含义免费、即时查找字段名 —— "salary" 可找到薪酬字段，"current job title and seniority" 可找到 active_experience_title、experience.position_title 等。用它来构建自定义范围抓取的 fields 列表，无需将完整字段词汇表加载到上下文中。

`entity_fetch`

收集记录 —— 可从搜索结果中手动挑选最多 20 个 ID，或通过 cache_id 每次调用收集最多 1,000 条记录。按找到的记录计费：员工/公司 20 积分，职位 1 积分。

`email_enrich`

最多 1,000 个员工 ID 的已验证、可投递商务邮箱 —— 每条找到的邮箱 10 积分；未找到的 ID 免费。EEA/UK 联系人不可用（GDPR 合规）。

`artifact_read`

通过经过身份验证的 MCP 会话，将已交付的文件分页回读 —— 免费，因为记录在抓取时已完成计费。这就是文件交付在所有客户端（包括无法打开链接或访问文件系统的聊天客户端）中都能工作的原因。

示例提示词

市场扫描

"查找北欧地区员工人数在 50–200 之间、过去两年内获得融资的 B2B SaaS 公司。"

构建带已验证邮箱的潜在客户列表

"搜索美国 500+ 员工公司的数据负责人。将 20 个完整档案连同已验证邮箱抓取到文件中。"

深度调研单一公司

"拉取 flo.health 的完整记录 —— 融资轮次、员工增长和当前职位空缺。"

...

积分与计费

操作	积分
`entity_search`（任何 `limit`，包括 0）	每次搜索 20 积分
`entity_fetch` —— 员工或公司	每条找到的记录 20 积分
`entity_fetch` —— 职位	每条找到的记录 1 积分
`email_enrich`	每条找到的邮箱 10 积分；未找到免费
`entity_fields`、`artifact_read`	免费

每次响应都包含 credits_consumed —— 实际计费金额，因此如果出现差异（发送 1,000 个 ID，但计费 950 条记录），你可以确切知道有多少 ID 未找到。服务器绝不会静默扣费：抓取会先与你确认字段范围，且无法交付的抓取会在花费任何积分之前失败。

积分从你团队的 Coresignal 订阅中扣取 —— 在控制台中管理密钥和计费。Coresignal 新手？7 天免费试用附带 2,000 积分 —— 相当于 100 次搜索，或 100 条员工/公司记录，或两者混合 —— 参见套餐对比。

链接

Coresignal —— 数据覆盖范围、套餐和定价
Coresignal 控制台 —— 账户、团队、API 密钥、积分
API 文档 —— 底层数据 API