HeyLead 是一个面向 LinkedIn 外联的 AI 智能体（MCP 原生工具），通过 MCP（Model Context Protocol）让 AI 助手执行 LinkedIn 外联工作。用户可以在 Claude Code、Cursor、任意 MCP 客户端或 Web 仪表板中使用它，先登录网页端，再对 AI 说“find me leads”。
【用途与目标】 每个 campaign（营销活动）对应六种目标之一，ICP、匹配检查与消息内容都跟随该目标：销售产品或服务；求职；招聘；寻找合作伙伴或投资人；寻找供应商；调研访谈。其中招聘、寻找合作伙伴或投资人、调研访谈三种目标以自定义简报方式运行，直到具备对应消息集。
【主要能力】
- Voice Matching（语气匹配）：分析用户 LinkedIn 个人资料和帖子以捕捉写作风格，使每条消息听起来像用户本人写的。
- ICP 生成：RAG 驱动的流程，抓取公司背景，生成包含痛点、顾虑、障碍的买家画像，并映射到 LinkedIn 搜索参数。
- 线索发现与评分：搜索 LinkedIn，按匹配度对潜在客户评分。
- 互动预热：在发送连接请求前，自动与目标对象的帖子互动（评论、点赞）。
- 个性化邀请：语气匹配的消息，而非机器人式内容。
- 自动跟进：连接被接受后的多触点序列。
- 处理回复：检测情绪，推进积极线索走向会面，回答问题。
- 结果追踪：标记成交/失败/退出，并提供转化分析。
- 自主调度器：后台运行，遵守工作时间与速率限制。托管账户默认使用云端发送，启动即启用云端；本地安装仅从本机发送。 共提供 22 个工具，涵盖目标客户发现、ICP 生成、带备注的连接邀请、开场消息与跟进、预热（资料查看、关注、评论）、回复处理（对模糊内容暂扣）以及结果追踪。
【使用方式】 前置条件：Cursor 或 Claude Code 等支持 MCP 的 AI 编辑器。 第 1 步：安装 HeyLead。Claude Code 可作为插件（托管，无需安装）：运行 /mcp，选择 heylead 并 Authenticate 登录。该插件连接托管服务器 https://heylead.dev/mcp，并添加启动活动、审核等待消息、回复、每周回顾、暂停、添加人员列表等技能；源码在 plugins/heylead。也可通过 stdio 在本地运行客户端，需要 uv：Cursor 中在 Settings > MCP > “Add new MCP server” 填写 Name: heylead，Command: uvx heylead；任意 MCP 客户端同理。更新使用 uvx --refresh heylead。 第 2 步：设置账户。
- 选项 A（托管，最简便）：完成 90 秒测验或在 heylead.dev/dashboard/login 登录，测验画像会生成草稿活动；在 Settings → Connected accounts 连接 LinkedIn，然后从仪表板启动，或从 Settings → Integrations → Chat client 复制设置消息到 AI 聊天。启动前不会发送任何内容。托管用户共享一个专业目录，campaign 和收件箱保持私密。
- 选项 B（自托管）：针对自己的账户运行全部流程。需要先准备：Unipile 账户（负责与 LinkedIn 通信，在 unipile.com 注册，从 Access Tokens 页面获取 DSN 和 API key，然后运行 heylead config set unipile_api_url <DSN> 和 heylead secrets set unipile_api_key，密钥保存在操作系统钥匙串而非配置文件）；LLM API key（AI 调用向用户计费，免费的 Gemini key 即可起步）。随后在 AI 聊天中说："Set up my HeyLead profile with this Gemini key: YOUR_KEY"，会获得 LinkedIn 认证链接，连接后说 "finish setup"，HeyLead 将抓取个人资料并分析写作风格。 第 3 步：寻找线索。可说“Generate an ICP for AI SaaS founders”生成 ICP；“Find me fintech CTOs”创建活动；后续由 HeyLead 执行预热、个性化邀请、自动跟进、回复处理和结果追踪。
【发送模型与节奏】 活动创建为草稿，仅在明确启动后开始。每次发送前都会通过速率限制、工作时间检查以及一度连接保护。HeyLead 从用户自己的 LinkedIn 账户以人类节奏发送：免费 LinkedIn 账户每天最多 20 个邀请、每周最多 100 个（Premium 或 Sales Navigator 更多），周一至周五当地时间 08:00 至 22:00，间隔以分钟计。遇到 LinkedIn 反推时会退避并自行恢复。可随时暂停任何活动。启动同时会启用云端发送；observe 模式下不会委托也不发送。
【审批模式】 托管模式下，未另行选择的 workspace 会暂扣所有开场 DM 和跟进，直到有人批准，发送的是获批文本。可在仪表板 Approvals 页面或 inspect(action="waiting") 查看等待项，用 prospect(action="approve_message") 或 discard_message 决定。Autopilot 会不读即发，仅一个开关之隔（Settings → Sending，或 scheduler(action="approval_mode", mode="autopilot")）。邀请、InMail 和回复永不暂扣。
【配额与计划】 连接账户指一个 LinkedIn 席位或一个邮箱。免费版包含两者之一。邀请限制跟随 LinkedIn 账户（免费、Premium 或 Sales Navigator），而非 HeyLead 计划。自托管免费安装有月度配额：50 个邀请、20 条消息、30 次互动、1 个活跃活动、3 次 ICP 生成。
【AI 调用与数据安全】 AI 调用经由 HeyLead 后端或用户自己的 key；云端 MCP 在服务端处理数据，不向第三方共享；本地模式下联系人和消息保存在本机 SQLite 数据库。工具调用遥测：登录后 workspace 记录每次工具调用（工具、是否成功、错误类型、耗时、调用应用），不记录参数、结果、目标姓名、链接或消息。可用 heylead config telemetry off 或 DO_NOT_TRACK=1 关闭。机密保存在操作系统凭据存储（macOS Keychain、Windows Credential Manager、Linux Secret Service），或在没有时保存在仅所有者可读的 secrets.json 中。配置文件仅存普通设置。可运行 heylead secrets status 查看存储了哪些机密（从不显示值），heylead secrets clean 清理旧配置。
【其他】 可选依赖：基础安装覆盖全部核心功能；高级 ICP 生成有额外依赖。故障排查：若提示“uvx: command not found”先安装 uv（curl -LsSf https://astral.sh/uv/install.sh | sh 或 Mac 上 brew install uv）；添加 MCP 服务器后重启编辑器；若“Setup failed”或“LinkedIn not connected”，确认已在登录页 LinkedIn 行点击 Connect 并完成登录后重试。支持 OpenClaw（在 openclaw.json 的 mcp.servers 下添加条目，ClawHub 搜索 "HeyLead"）。许可证：代码为 MIT，知识库和提示配置为专有（proprietary）。完整智能体集成指南见 AGENTS.md。
