HeyLead: LinkedIn Outreach & Lead Generation MCP Server

HeyLead

HeyLead 是一款面向 LinkedIn 外联的 AI Agent：它能找到合适的人，用你自己的 LinkedIn 帖子的语气给他们写消息、跟进并处理回复。你可以通过 Claude Code、Cursor、任何 MCP 客户端或 Web 控制面板使用它。在 Web 上登录后，与你的 AI 对话并说“帮我找潜在客户”。

使用场景

营销活动有六种目标之一，ICP、匹配度检查和消息都会据此设定：销售产品或服务、求职、招聘、寻找合作伙伴或投资者、寻找供应商和调研访谈。

• 销售产品或服务：联系会购买你所打造产品的人。
• 求职：联系招聘你想要的职位的人。
• 招聘：联系你正在招募的职位候选人。支持自定义简介。
• 寻找合作伙伴或投资者：联系可能达成合作或投资的人。支持自定义简介。
• 寻找供应商：你是买家。联系能提供你所需商品或服务的人。
• 调研访谈：联系受访者、调查对象或测试参与者。支持自定义简介。

在消息模板组创建完成之前，招聘、寻找合作伙伴或投资者以及调研访谈都会使用自定义简介。

---

开始使用

MCP（Model Context Protocol）让 AI 助手能够使用外部工具。HeyLead 让你的 AI 可以为你进行 LinkedIn 外联。

你需要： Cursor 或 Claude Code——任何兼容 MCP 的 AI 编辑器。

步骤 1：安装 HeyLead

Claude Code，以插件形式安装（托管版，无需安装任何内容）：

/plugin marketplace add D4umak/linkedin-outreach-mcp
/plugin install heylead@heylead

然后运行 /mcp，选择 heylead，再选择 Authenticate，登录你的 HeyLead 账户。该插件会连接托管服务 https://heylead.dev/mcp，并添加用于启动营销活动、审批待发送消息、回复消息、每周回顾、暂停营销活动以及添加人员列表的技能。插件源代码位于 plugins/heylead。

**或者通过 stdio 在本地运行客户端。**你需要安装 uv：

Claude Code：

claude mcp add heylead -- uvx heylead

Cursor： Settings > MCP > "Add new MCP server" > Name：heylead，Command：uvx heylead

任何 MCP 客户端：

{
  "heylead": {
    "command": "uvx",
    "args": ["heylead"]
  }
}

使用 uvx --refresh heylead 更新。

步骤 2：设置账户

**选项 A——托管版（最简单）：**完成 90 秒问卷，或在 heylead.dev/dashboard/login 登录。问卷中的用户画像会生成一份营销活动草稿。在 Settings → Connected accounts 中连接 LinkedIn，然后从控制面板启动营销活动；或者从 Settings → Integrations → Chat client 复制设置消息到 AI 聊天中。在你启动之前，不会发送任何内容。托管版用户共享一个专业人士目录；营销活动和收件箱均为私有。

**选项 B——可自托管：**使用你自己的账户运行所有操作。首先需要准备两样东西：

1. Unipile 账户——它负责与 LinkedIn 通信。在 unipile.com 注册，然后从 Access Tokens 页面获取 DSN 和 API 密钥，再运行 heylead config set unipile_api_url <DSN> 和 heylead secrets set unipile_api_key（系统会提示你输入；密钥保存在操作系统的钥匙串中，绝不会存入配置文件）。
2. 大模型 API 密钥——AI 调用费用由你承担。免费的 Gemini 密钥 就足以开始使用。

然后打开 AI 聊天并说：

“使用这个 Gemini 密钥设置我的 HeyLead 个人资料：YOUR_KEY”

你会收到一个 LinkedIn 身份验证链接。打开链接并连接 LinkedIn，然后说 “完成设置”。HeyLead 会获取你的个人资料并分析你的写作风格。

步骤 3：寻找潜在客户

"Find me CTOs at fintech startups in New York"
"Send outreach to the campaign"
"Check my replies"
"How's my outreach doing?"

---

工作原理

1. 定义你的 ICP — “为 AI SaaS 创始人生成一个 ICP” → 由 RAG 驱动的用户画像，包含痛点、障碍和 LinkedIn 定向信息
2. 创建营销活动 — “帮我找金融科技领域的 CTO” → 搜索 LinkedIn，并根据匹配度为潜在客户评分
3. 预热潜在客户 — 联系前先与他们的帖子互动（评论、点赞）
4. 发送个性化邀请 — 匹配你的表达风格，让消息听起来像你本人，而不是机器人
5. 自动跟进 — 接受连接后，发送多触点序列消息
6. 处理回复 — 检测情绪，将积极的潜在客户推进到会议环节，并回答问题
7. 跟踪结果 — 跟踪赢单／丢单／选择退出情况，并分析转化数据

**发送模式：**营销活动会以草稿形式创建，只有在你明确启动后才会开始。每次发送前都会经过速率限制、工作时间检查和一级连接关系检查。HeyLead 会以符合真人节奏的方式，通过你自己的 LinkedIn 账号发送：免费 LinkedIn 账号每天最多发送 20 份邀请，每周最多发送 100 份（Premium 或 Sales Navigator 账号可发送更多：新连接的付费账号起始限额为每天 20 份，此后每周翻倍，直至达到上限）；发送时间为你所在时区周一至周五的 08:00 至 22:00，发送间隔为几分钟。LinkedIn 限制发送时，HeyLead 会自动放缓，并在之后自行恢复。你可以随时暂停任何营销活动。只有启动营销活动才会启用云端发送——在 observe 模式下，不会启用云端发送，也不会从任何设备发送消息。

**审批模式（托管版）：**未另行设置的工作区会将每条开场私信和后续消息都暂存，直至有人批准；实际发送的就是获批文本。你可以在仪表板的“审批”页面查看待处理内容，也可以使用 inspect(action="waiting") 查看；使用 prospect(action="approve_message") 批准，或使用 discard_message 丢弃。自动驾驶模式会直接发送这些消息，无需阅读，切换一个设置即可启用（“设置” → “发送”，或使用 scheduler(action="approval_mode", mode="autopilot")）。邀请、InMail 和回复不会被暂存。

---

工具

HeyLead 为你的 AI 提供 22 个工具：

核心工作流

工具	功能
setup_profile	连接 LinkedIn，并分析你的写作风格，生成声音特征
generate_icp	生成包含买家用户画像的详细理想客户档案
icp	预览已保存的 ICP 匹配哪些 LinkedIn 个人资料，不创建营销活动
profile_signals	将定向请求（国家关联、兴趣）整理为 LinkedIn 回溯查询，并为个人资料证据评分
create_campaign	根据自然语言描述创建外联营销活动（以草稿形式）
generate_and_send	生成个性化 LinkedIn 消息并发送
check_replies	检查各营销活动的新回复，判断情绪并筛选热门潜在客户
book_meeting	将约定的通话添加到你的 Google Calendar，并向潜在客户发送邀请
show_status	你的仪表板 — 营销活动、统计数据、热门潜在客户、账号健康状况。提供对应 heylead.dev/dashboard 页面的链接；托管账号还会附上状态快照卡片

外联与互动

工具	功能
send_message	向潜在客户发送跟进消息和回复
send_email	通过已连接的 Unipile 邮箱（Gmail／Outlook）发送邮件。绝不会使用 Mail.app。
engage_prospect	通过评论、回应、关注或认可潜在客户来建立信任
inbox	直接浏览并阅读 LinkedIn 收件箱消息
backfill_inbox	通过入站处理流程处理尚未回复的收件箱消息
create_post	生成并发布符合你表达风格的 LinkedIn 帖子，或配上照片或短视频发布你已批准的文案

营销活动管理

工具	功能
campaign	营销活动生命周期管理——启动、暂停、恢复、归档、删除、紧急停止、重试失败项
edit_campaign	编辑营销活动的名称、模式、预订链接或上下文字段
prospect	管理潜在客户——跳过、填写结果后关闭、查看对话或时间线
import_prospects	将 CSV 数据中的潜在客户导入营销活动

洞察与分析

工具	功能
analytics	营销活动分析——报告、比较和导出
inspect	只读摘要，涵盖运营人员保留项、策略师重新规划、成交人员决策、回复跳过项和受限任务
knowledge	整理用于支撑消息的知识库——列出、添加、移除、刷新和搜索来源。仅限托管版
suggest_next_action	按影响力排序，推荐最佳后续操作
signals	查看并分析购买信号——新闻、公司互动、网站访问、个人资料查看者
manage_watchlist	添加、移除和列出信号关键词监控列表
network	网络情报——成员已连接账号的互助池；加入后即可使用

增长与关系

工具	功能
brand_strategy	分析并优化你的 LinkedIn 个人品牌
profile	查看并恢复 LinkedIn 个人资料的更改历史
partner	跟踪与商业伙伴、供应商和投资者的后续联系
contacts	搜索、浏览和管理你的全局联系人库
crm_sync	将营销活动联系人和交易同步到 HubSpot CRM

自动化与账号

工具	功能
scheduler	管理自主调度器——状态、开关、send_from（云端默认 / 本地可选）
product	仅限本地 git 检出——修改此仓库和/或创建 PR
account	管理 LinkedIn 账号——列出、切换或断开连接
organization	托管组织——列出、切换、邀请编辑者/查看者、创建客户工作区

---

主要功能

语气匹配 — 分析你的 LinkedIn 个人资料和帖子，捕捉你的写作风格。每条消息听起来都像是你亲自写的。

ICP 生成 — 由 RAG 驱动的流程会抓取公司背景信息，生成包含痛点、担忧和障碍的买家画像，并将其映射到 LinkedIn 搜索参数。

自主调度器 — 在后台运行，并遵守工作时间和频率限制。对于托管账号，每个营销活动默认由云端发送。启动营销活动即会委托云端处理，因此即使你合上笔记本电脑，外联工作也会在发送时段内继续进行：邀请、开场私信、首次触达的 InMail、后续跟进、互动、关注、背书、电子邮件备用方式、补充潜在客户、自动回复、入站消息、预热、信号收集器和帖子情报。此设备不会为这些工作启动本地调度器引擎。使用 scheduler(action='send_from', host='local') 将整个账号迁移到此设备，并关闭云端调度器。Observe 模式意味着无人发送。直接安装 / 自托管安装仅从此设备发送。

互动预热 — 在发送连接请求前，自动与潜在客户的帖子互动，逐步建立熟悉感。

发送节奏 — HeyLead 以符合真人习惯的节奏，从你自己的 LinkedIn 账号发送：免费 LinkedIn 账号每天最多发送 20 份邀请、每周最多 100 份（Premium 或 Sales Navigator 账号可发送更多：新连接的付费账号每天从 20 份开始，每周翻倍，直至达到上限）；发送时间为你所在时区周一至周五 08:00 至 22:00，间隔数分钟。LinkedIn 限制发送时，系统会放缓节奏，并自动恢复。你可以随时暂停任何营销活动。

结果跟踪 — 将交易标记为赢单/输单、跟踪转化率、识别停滞的潜在客户，并衡量互动投资回报率。

---

定价

方案	价格	包含内容
免费版	$0	每位潜在客户最多跟进 2 次
专业版	每个已连接账户每月 $29	每位潜在客户最多跟进 5 次

已连接账户是指一个 LinkedIn 席位或一个电子邮件邮箱。免费版包含其中一种。

邀请限额取决于 LinkedIn 账户（免费版、Premium 或 Sales Navigator），而非 HeyLead 方案。 可自托管的免费安装每月有以下配额：50 次邀请、20 条消息、30 次互动、1 个活跃营销活动、3 次 ICP 生成。

---

隐私

• AI 调用 — 通过 HeyLead 后端或您自己的密钥进行
• 云端 MCP — 您的数据会在服务器端处理，但绝不会与第三方共享
• 本地模式 — 联系人和消息保留在您的设备上，存储于本地 SQLite 数据库
• 工具调用遥测 — 登录后，您的 HeyLead 工作区会记录每次工具调用：所用工具、是否成功、错误类型、耗时以及发起调用的应用（Claude、ChatGPT、Cursor……）。绝不记录参数、结果、潜在客户姓名、链接或消息。运行 heylead config telemetry off 或设置 DO_NOT_TRACK=1 即可关闭

高级用户： 设置时传入您自己的 LLM 密钥（Gemini/Claude/OpenAI），即可使用自己的 AI。完全可选。

---

密钥的存储位置

HeyLead 会将其后端令牌、Unipile 密钥和任何 LLM 密钥保存在操作系统的 凭据存储中（macOS Keychain、Windows Credential Manager、Linux Secret Service）；若不存在凭据存储，则保存在 HeyLead 文件夹中仅所有者可访问的 secrets.json 文件里。配置文件仅保存普通设置。若要检查安装情况而不查看密钥：

• heylead config get backend_url 会打印一项普通设置
• heylead api get /api/v1/campaigns 会对托管 API 进行经过身份验证的读取，并屏蔽凭据
• heylead secrets status 会列出已存储的密钥，但绝不显示其值
• heylead secrets clean 会将密钥从旧配置文件中移出，删除云端发送型安装不会使用的密钥，并删除旧的配置备份副本

后端模式与环境变量

当 MCP 客户端与 HeyLead 后端（例如 heylead-api）通信时，后端会使用以下环境变量。运行自有后端的运维人员应根据需要设置这些变量。

用途	环境变量示例
LLM	GEMINI_API_KEY；如果使用其他提供商，则使用 OPENAI_API_KEY / ANTHROPIC_API_KEY
搜索 / 抓取	用于 ICP 和公司背景信息的 SERPER_API_KEY、FIRECRAWL_API_KEY（或类似变量）
身份验证 / 存储	GOOGLE_*（OAuth）、UNIPILE_*（LinkedIn 提供商），以及所用的 DB/Redis
可选	功能标志、速率限制、日志记录 — 请参阅后端仓库

有关完整的后端配置和部署说明，请参阅 heylead-api（或 backend）仓库及其文档。

---

可选依赖项

基础安装包含所有核心功能。要进行高级 ICP 生成：

pip install heylead[icp]    # Embeddings for RAG-powered ICP generation
pip install heylead[crawl]  # Web crawling for company context ingestion
pip install heylead[all]    # Both

---

故障排除

“uvx: command not found” 请先安装 uv：curl -LsSf https://astral.sh/uv/install.sh | sh（或在 Mac 上运行 brew install uv）

“MCP server not connecting” 添加 MCP 服务后，请重启编辑器。在 Cursor 中，检查 Settings > MCP — 服务应显示一个绿色圆点。

“Setup failed” 或 “LinkedIn not connected” 请确保您在登录页面的 LinkedIn 行上点击了“Connect”（控制面板：Settings → Connected accounts），并完成了 LinkedIn 登录。然后重新运行设置。

需要帮助？ 请提交一个 issue。

---

发布到 PyPI（维护者）

要让 HeyLead 在 PyPI 上架（或发布新版本）：

选项 A：通过 GitHub Release 发布（推荐）

1. 一次性操作： 创建 PyPI 账户和 API 令牌。在你的仓库中：进入 Settings → Secrets and variables → Actions → 添加名为 PYPI_TOKEN 的密钥，并填入令牌值。
2. 在 pyproject.toml 中升级版本（version = "0.2.4"）。
3. 提交并推送，然后创建一个 GitHub Release（标签示例：v0.2.4，发布标题可选）。工作流 .github/workflows/publish.yml 会在发布时运行，并将软件包发布到 PyPI。

选项 B：手动发布

pip install build twine
python -m build          # creates dist/
twine check dist/*       # optional: validate
twine upload dist/*      # prompts for PyPI username + password (use __token__ and your API token)

发布后，任何人都可以通过 claude mcp add heylead -- uvx heylead 添加该工具（Cursor：命令 uvx heylead）。

---

面向 AI Agent

HeyLead 是一款原生支持 MCP 的工具，专为 AI Agent 打造，而非供人点击按钮使用。

安装为 MCP 服务（stdio）：

{
  "heylead": {
    "command": "uvx",
    "args": ["heylead"]
  }
}

OpenClaw： 将相同条目添加到 openclaw.json 的 mcp.servers 下。 也可在 ClawHub 获取 — 搜索“HeyLead”。

在 heylead.dev 登录（托管版），或使用你自己的 Unipile 账户和大模型 API 密钥（可自托管）。

功能： LinkedIn 潜在客户开发、冷启动触达自动化、结合买家画像生成 ICP、匹配个人语气的个性化消息、多触点滴灌序列、回复情感分类、互动预热、活动分析，以及在云端定时发送（即使你的笔记本电脑处于关闭状态）。

22 个工具，涵盖从寻找合适的人选到回复对方消息：潜在客户发现、结合买家画像生成 ICP、附带备注的好友邀请、开场消息和后续跟进、预热（浏览个人资料、关注、评论）、回复处理（遇到任何含糊情况时会暂缓并交由你处理），以及结果跟踪。

完整的 Agent 集成指南请参阅 AGENTS.md。

---

链接

• PyPI
• MCP Registry
• Smithery
• ClawHub（OpenClaw 技能商店）
• Issues

许可证

MIT（代码）— 参见 LICENSE

知识库和提示词配置为专有内容。