LinkedIn

linkedin-api-mcp

免责声明：这是一个独立的社区项目，与 LinkedIn Corporation 或 Microsoft 无关，也未获得其授权、认可或赞助。“LinkedIn”是 LinkedIn Corporation 的注册商标，在此仅用于说明本软件所互操作的第三方服务。

一个用于 LinkedIn 的 MCP 服务。它使用你自己的、已登录 LinkedIn 的会话 Cookie，通过真正的无头浏览器 (patchright，一个未被检测到的 Playwright 分支) 进行操作。这里没有抓取 API、没有撞库，也不会绕过 LinkedIn 的登录。你的 Agent 可以使用 12 个读取工具（个人资料、公司、职位、帖子、收件箱），以及两个刻意分开的写入工具：发送消息和发送连接请求。每项操作都通过单一浏览器会话逐一执行，并按照你控制的限制进行节流。请参阅下方的安全部分。

文档：mcp.johannsenlum.com/linkedin

安装（一键安装）

Cursor 和 VS Code 提供了深层链接；其他客户端均没有文档说明的安装链接格式。这些链接会预填下方的命令，无需填写其他内容，因为 Cookie 保存在你的操作系统密钥环中，而不是环境变量里。

所有客户端

claude mcp add linkedin -- uvx linkedin-api-mcp

{
  "mcpServers": {
    "linkedin": {
      "command": "uvx",
      "args": ["linkedin-api-mcp"]
    }
  }
}

{
  "mcpServers": {
    "linkedin": {
      "command": "uvx",
      "args": ["linkedin-api-mcp"]
    }
  }
}

{
  "servers": {
    "linkedin": {
      "type": "stdio",
      "command": "uvx",
      "args": ["linkedin-api-mcp"]
    }
  }
}

[mcp_servers.linkedin]
command = "uvx"
args = ["linkedin-api-mcp"]

{
  "context_servers": {
    "linkedin": {
      "source": "custom",
      "command": "uvx",
      "args": ["linkedin-api-mcp"]
    }
  }
}

{
  "mcpServers": {
    "linkedin": {
      "command": "uvx",
      "args": ["linkedin-api-mcp"]
    }
  }
}

如果你不想在某个客户端中依赖密钥环（例如在沙盒环境或 CI 中），可以直接传递 Cookie，而不必运行 auth：

{
  "mcpServers": {
    "linkedin": {
      "command": "uvx",
      "args": ["linkedin-api-mcp"],
      "env": { "LINKEDIN_COOKIE": "your-li_at-value" }
    }
  }
}

无论在哪里这样做，都要像保护 Cookie 本身一样谨慎地对待该配置文件：不要提交它，并限制其访问权限。

获取会话 Cookie

LinkedIn 不为此类访问提供 API 密钥，因此该服务会使用浏览器中已有的同一会话 Cookie。

1. 一次性操作：安装该服务所驱动的 Chromium 版本。

   uvx --from linkedin-api-mcp patchright install chromium
   

2. 在常规浏览器中登录 linkedin.com。
3. 打开开发者工具（F12 或 Cmd+Opt+I）→ 应用程序 → Cookie → https://www.linkedin.com。
4. 找到名为 li_at 的行，并复制其值。

警告

**此 Cookie 就是你的 LinkedIn 登录凭证。**任何持有它的人都可以冒充你操作：阅读你的消息、给你的联系人发消息，并查看你的账户可以看到的所有内容，而且无需你的密码。更改密码后，它仍然有效；LinkedIn 显示的任何会话列表也无法撤销它。切勿将它粘贴到聊天、提交记录、问题、截图中，或粘贴到 linkedin-api-mcp auth 以外的任何地方。

5. 保存它：

   uvx linkedin-api-mcp auth
   

   按提示粘贴该值；终端不会回显它。默认情况下，它会保存在操作系统的密钥环中（Keychain、Windows Credential Manager 或 Linux 上的 Secret Service），绝不会写入配置文件。
6. 在配置客户端之前，先验证 LinkedIn 是否接受该 Cookie：

   uvx linkedin-api-mcp --test
   

   该命令会打印服务的脱敏配置，并确认会话有效。它绝不会打印 Cookie 本身。

工具

共 14 个工具：12 个只读，2 个写入。send_message 和 connect 是仅有的两个会产生更改的工具，而且一旦运行，另一位真实用户就能立即看到结果：没有草稿、预览或撤销步骤。其他工具只会读取你的账号已有权限查看的内容。已通过 68 项测试。

已验证和未验证的内容

这是一个刚启动几天的项目。我们不声称所有功能都能正常运行，以下是针对真实账号实际检查过的内容，以及尚未检查的内容。

安全性

• 串行化操作队列。 每次工具调用（包括 linkedin_status）在操作浏览器前都会经过同一个队列：一次只执行一个操作，绝不并行。

• 强制执行最小间隔和每小时上限，而非仅仅声明：

  设置	默认值	环境变量	作用
  操作之间的最小间隔	2 秒	LINKEDIN_MIN_INTERVAL	根据上一次调用控制调用节奏，不会连续执行。
  每个滚动小时的操作次数	120	LINKEDIN_MAX_PER_HOUR	达到上限后，后续调用会立即失败并返回 rate_limited 错误，而不会排队或等待。

  此上限仅适用于本服务：它的作用是防止循环运行的 Agent 产生大量 LinkedIn 流量，并非 LinkedIn 告诉我们这些数字。调低上限始终安全；调高上限则意味着你愿意承担超出默认设置预期的风险。

• 对所有抓取到的自由文本进行提示词注入隔离。 从 LinkedIn 页面读取的任何内容（标题、个人简介、消息）都会作为数据传递给你的 Agent。在 Agent 看到这些内容前，它们会经过隔离，因此个人资料或消息中的文本无法伪装成指令。

• 默认情况下，Cookie 存储在操作系统密钥环中，而非配置文件中。请参阅获取会话 Cookie。

• send_message 会验证消息是否送达后才报告成功。 它会轮询对话，直到实际看到已发送的文本；如果没有看到，则会抛出 send_unconfirmed，而不会错误地返回 {"sent": true}。

服务还会读取以下环境变量：LINKEDIN_COOKIE（覆盖密钥环中的值）、LINKEDIN_HEADLESS（默认值为 true）、LINKEDIN_NAV_TIMEOUT_MS（默认值为 30000）。

常见问题

使用这个工具安全吗？我会被封禁吗？

此工具控制的是一个真实的浏览器会话；它不会利用未公开的 API，也不会绕过身份验证。LinkedIn 用户协议禁止自动访问，使用自动化工具的账号可能会受到限制或被封禁。使用风险由你自行承担；我们无法保证账号安全。如遇到任何问题，请在 Discussions 中告知我。

如果我的 Agent 执行了过多操作怎么办？

工具调用会通过队列按顺序执行。你需要对运行的自动化操作量负责；请谨慎使用，并合理地向 Agent 提供提示词。

许可证

MIT © 2026 Johannsen Lum。

你可以使用、修改、再分发，也可以基于它构建商业项目：唯一条件是保留版权声明和许可证文本。本项目不提供任何形式的保证。

接受以相同许可证提交的贡献。

贡献

欢迎提交问题和拉取请求： github.com/JohannsenLum/linkedin-api-mcp。 变更记录见 CHANGELOG.md。

运行测试

安装开发依赖，并在仓库根目录运行 pytest：

pip install -e ".[dev]"
python -m pytest -q

默认测试套件不需要 Chromium、LinkedIn 账号、LINKEDIN_COOKIE 或网络访问。浏览器交互由 tests/fakes.py 中的测试替身模拟；它们会解析预置的 HTML，并提供工具使用的少量 Playwright 接口。解析测试示例请参阅 tests/test_people_parsing.py。

这是一个独立项目，与 LinkedIn Corporation 无关联。请参阅本文档顶部的免责声明。