stickerdaniel/linkedin-mcp-server · 上手攻略

仓库：stickerdaniel/linkedin-mcp-server
链接：https://github.com/stickerdaniel/linkedin-mcp-server
分类：skill
作者：Tom
更新：2026-07-11

这是什么

开源 LinkedIn MCP Server，让 Claude 等兼容 MCP 的 AI Agent 直接读取你的 LinkedIn 数据：个人主页、公司主页、职位信息、消息收件箱。不同于 LinkedIn 官方 API（申请困难且有严格限制），本工具通过本地浏览器会话实现，真正的数据拥有者是你自己，零门槛。

官方赞助商 Unipile 提供同款能力的云托管版本（支持 LinkedIn 经典版、Sales Navigator、Recruiter），但本仓库是纯本地、开源、免费方案。

解决什么问题

招聘与人才挖掘：用自然语言搜索候选人、获取详细 profile，自动整理候选人资料
销售线索发现：通过公司名称查询员工结构，找到关键决策人
职位研究：批量获取目标公司正在招聘的职位，了解 JD 要求
竞品监控：追踪目标公司动态（通过公司 posts）
个人关系管理：AI 帮你分析消息收件箱，整理人脉信息

快速安装

前置要求

安装 uv：curl -LsSf https://astral.sh/uv/install.sh | sh
LinkedIn 账号（已在浏览器登录）
uv 版本需 ≥ 0.4.0

方式一：Claude Desktop 一键安装（最简）

从 Releases 页面下载最新的 .mcpb 文件
点击文件，自动安装进 Claude Desktop
首次调用工具时，会自动弹出 LinkedIn 登录浏览器窗口

方式二：uvx 通用部署（推荐，本地 MCP Host 均可用）

{
  "mcpServers": {
    "mcp-server-linkedin": {
      "command": "uvx",
      "args": ["mcp-server-linkedin@latest"],
      "env": {
        "UV_HTTP_TIMEOUT": "300"
      }
    }
  }
}

⚠️ 务必保留 @latest 标签，不要固定版本号。LinkedIn 页面结构频繁变化，版本不更新会导致抓取失败。@latest 每次启动自动解析最新版本。

方式三：从已登录浏览器导入会话（跳过登录）

如果你的 Chrome/Brave/Edge 等已登录 LinkedIn，可以直接复用该会话：

# 自动选择最近一个有 LinkedIn 登录态的浏览器
uvx mcp-server-linkedin@latest --import-from-browser

# 指定浏览器
uvx mcp-server-linkedin@latest --import-from-browser brave

Cookie 读取后存至 ~/.linkedin-mcp/profile/，后续启动无需再登录。

方式四：手动登录

uvx mcp-server-linkedin@latest --login

会打开浏览器窗口手动完成登录，超时时间默认 1800 秒（可配 --login-timeout）。

方式五：Docker 部署

docker run -i --rm \
  -p 127.0.0.1:8000:8000 \
  stickerdaniel/mcp-server-linkedin:latest

核心用法

配置文件格式（Claude Desktop 示例）

{
  "mcpServers": {
    "mcp-server-linkedin": {
      "command": "uvx",
      "args": ["mcp-server-linkedin@latest"],
      "env": {
        "UV_HTTP_TIMEOUT": "300",
        "AUTO_IMPORT_FROM_BROWSER": "true"
      }
    }
  }
}

核心工具一览

人物 Profile - get_person_profile：获取任意人主页（experience、education、skills、certifications 等分 section 指定） - get_my_profile：获取自己的 profile - get_sidebar_profiles：从推荐栏提取相似 profile URL - search_people：按关键词、地点、所在公司、连接度数搜索

公司信息 - get_company_profile：公司主页（about、posts、jobs 等 section） - get_company_posts：公司近期帖子 - search_companies：关键词搜索公司 - get_company_employees：列出公司员工（支持关键词过滤）

职位 - search_jobs：关键词 + 地点搜索职位 - get_job_details：单个职位详情（JD、公司信息）

消息 - get_inbox：收件箱最近对话列表 - get_conversation：读取指定会话历史 - search_conversations：关键词搜索聊天记录 - send_message：发送消息（需二次确认）

动态 - get_feed：获取自己首页信息流帖子 - connect_with_person：发送/接受连接请求（可选附言） - close_session：关闭浏览器会话

命令行参数

--no-headless          # 显示浏览器窗口（调试用）
--log-level DEBUG      # 调试日志
--timeout 10000        # 页面操作超时 ms（默认 5000）
--tool-timeout 300     # 单次工具调用超时 s（默认 180）
--chrome-path /path/to/chrome  # 指定 Chrome 路径
--user-data-dir ~/.linkedin-mcp/profile  # 指定 profile 目录

注意：所有工具调用共享同一个浏览器会话，并发请求会自动排队，而非并行执行。

典型适用场景

场景一：招聘 Sourcing

帮我搜索在北京、有 5 年以上机器学习经验、目前在 Google 或 DeepMind 的 LinkedIn 用户，给我列出前 10 个人的姓名、现任职位和工作邮箱。

AI 自动完成搜索 → 逐个读取 profile → 整理成表格，全程无需手动翻页。

场景二：销售情报

查一下 Salesforce 公司的 Engineering 部门员工，重点找 VP 或 Director 级别、懂 AI/ML 的，列出名字和他们的公开邮箱。

场景三：竞品职位监控

每周自动搜索竞品公司新发布的「Senior Backend Engineer」职位，汇总 JD 关键要求。

场景四：个人消息管理

帮我看看最近一周谁给我发了 LinkedIn 消息，整理一下有哪些是重要联系人。

坑与注意

非 LinkedIn 官方产品：明确声明与 LinkedIn/Microsoft 无附属关系。LinkedIn 可能随时调整页面结构，导致抓取失败——这正是使用 @latest 而非固定版本的原因。
research 成熟度：作者标注为 research（非 production），生产环境使用需谨慎，务必监控成功率。
Chrome 127+ app-bound 加密：Chrome 127 以上版本使用 app-bound 加密保护 Cookie，无系统管理员权限无法读取。这种情况只能使用 --login 手动登录，而非 --import-from-browser。
macOS Safe Storage：从浏览器导入 Cookie 时，OS Keychain 会弹出授权提示，需允许。
超时调优：首次工具调用如果报超时，适当增大 --timeout（页面操作，如元素查找）和 --tool-timeout（整个工具执行，含 Chromium 冷启动）。
只能一个活跃会话：LinkedIn 不允许同一账号多设备登录，抓取时请确保没有其他地方登录该账号。
发送消息限制：send_message 需二次确认，AI 无法自动批量发消息，这是有意设计，避免滥用。
API Key：本工具无需任何 API Key，但如需云托管方案（Unipile）则需注册其服务。

与同类对比

方案	认证方式	成本	本地/云	成熟度
linkedin-mcp-server（本仓库）	浏览器 Cookie	免费	本地	Research
Unipile LinkedIn API	官方 API	付费	云	Production
PhantomBuster	浏览器/官方 API	付费订阅	混合	Production
Phantombuster/Apify LinkedIn scraper	浏览器自动化	付费	云	Production

本仓库最大优势：完全免费、无需申请、无需等待审批，本地运行数据不经过第三方，适合需要快速验证想法或处理小量数据的场景。大量生产级使用建议评估 Unipile 等官方 API 方案。

一句话推荐结论

如果你需要 AI Agent 帮你读 LinkedIn 数据（招聘、销售、情报收集），这个开源 MCP Server 是零门槛起点——无需申请任何 API，用你自己的 LinkedIn 账号，uvx 一行命令启动；但请留意其 research 定位，生产级大规模使用建议评估 Unipile 等官方付费方案。