LinkedIn Company Admin MCP

linkedin-company-admin-mcp

语言： English - Romana

用于管理 LinkedIn 公司主页的 MCP 服务。 查看分析数据、管理帖子、编辑主页详情、增加关注者，并通过个人资料桥接功能支持员工倡导工作流。

与 stickerdaniel/linkedin-mcp-server 互为补充。 Stickerdaniel 的项目涵盖个人 LinkedIn 使用场景（动态、消息、搜索）。本项目填补了其他项目尚未覆盖的空白：全面管理 LinkedIn 公司主页，并提供一小组个人资料桥接工具，专用于员工倡导工作流。

⚠️ 服务条款与账户风险。 LinkedIn 的用户协议禁止自动访问平台。本服务会代表你操作真实的浏览器会话，LinkedIn 可能会检测到使用行为并对账户限流或永久限制——包括导致无法继续访问公司主页。使用风险自负。 请勿在你承受不起损失的个人或企业账户上使用。如果账户受到限制，作者无法帮助你恢复。若符合条件，建议使用 LinkedIn 的社区管理 API。

🔐 安全提示——会话目录等同于凭据。“不存储凭据”是指本服务不会索要你的密码，也不会将密码写入配置文件。这并不意味着可以安全分享配置文件目录。登录后，~/.linkedin-company-admin/profile 中会包含 LinkedIn 会话 Cookie，其作用相当于你的密码和双重身份验证凭据的组合。任何能读取该目录的人都可以获得你账户和公司主页的完整管理权限。特别注意：请勿将此目录同步到 OneDrive / iCloud / Dropbox / 任何云备份服务。 仅将其保存在你信任的设备本地磁盘上。

为什么要做这个项目

LinkedIn 官方社区管理 API 仅限受邀用户使用。个人资料抓取已有充分支持。此前缺少的是一个稳定、以浏览器为先的 MCP，让主页管理员（或其助手大模型）可以查看分析数据、起草帖子、编辑简介、邀请关注者，以及从个人帖子中标记主页——整个过程中都不会接触任何已存储的密码。

功能一览

• 24 个 MCP 工具，分为 6 类——请参阅下方的工具参考。
• 磁盘上零凭据。 通过可见的 Chromium 窗口进行交互式登录；会话保存在持久化配置文件目录中（Unix 上使用 chmod 0o700）。
• 通过 Patchright 使用 隐匿模式 Chromium（Playwright 的反检测分支）。
• Provider 抽象（AdminProvider、PostsProvider），便于未来接入社区管理 API 后端，而无需重写工具。
• 实际启用限流（而非仅导入相关模块）——每个写入工具都有保守的每小时调用上限。
• 仅使用 aria-label / role / innerText 选择器——不使用混淆的 CSS 类哈希。LinkedIn 发布新版 UI 时，只需修改 selectors/__init__.py。
• 无巨型文件（每个文件约 300 行代码上限），通过 mypy 进行类型检查，并使用 ruff 进行代码检查。

安装

选项 1：uvx（推荐）

已发布到 PyPI，包名为 linkedin-company-admin-mcp。

uvx linkedin-company-admin-mcp@latest --login

然后将其添加到 Claude Desktop 配置文件（~/.config/Claude/claude_desktop_config.json 或对应平台上的配置文件）：

{
  "mcpServers": {
    "linkedin-company-admin": {
      "command": "uvx",
      "args": ["linkedin-company-admin-mcp@latest"]
    }
  }
}

选项 2：本地开发

git clone https://github.com/negrueu/linkedin-company-admin-mcp.git
cd linkedin-company-admin-mcp
uv sync
uv run linkedin-company-admin-mcp --login

选项 3：Docker

docker build -t linkedin-company-admin-mcp .
docker run --rm -it \
  -v linkedin_profile:/home/mcp/.linkedin-company-admin \
  linkedin-company-admin-mcp --login

首次登录

此服务不会存储凭据。 登录过程需要交互操作：

uvx linkedin-company-admin-mcp --login

系统会打开一个可见的 Chromium 窗口。像平常一样登录 LinkedIn（包括 2FA）。持久化浏览器配置文件保存在 ~/.linkedin-company-admin/profile（在 Unix 上执行 chmod 0o700）。之后的所有 MCP 调用都会自动复用此会话。

要退出登录：uvx linkedin-company-admin-mcp --logout（清除配置文件目录）。

工具参考

完整的参数列表和示例请参见 docs/TOOL_REFERENCE.md。概要如下：

会话（3）

工具	用途
session_status	持久化配置文件是否有效且已登录？
session_warmup	预先打开浏览器和 /feed/，减少首次调用延迟。
session_logout	关闭浏览器并清除配置文件目录。

公司信息读取（6）

工具	用途
company_read_page	名称、标语、关注者、简介、行业、网站。
company_list_posts	最近发布的内容，包括 URN、文本、互动和评论。
company_list_followers	关注者列表（仅管理员可用；分页显示）。
company_list_mentions	提及该主页的帖子（管理员通知）。
company_manage_admins	列出管理员及其角色。
company_analytics	7d / 28d / 90d 时间范围内的关注者 / 帖子指标。

公司管理员写入（3）

工具	用途
company_edit_about	更新简介部分（标语可作为备用选项）。
company_edit_logo	上传新徽标（横幅可选）。
company_update_details	网站、行业、规模、专长。

公司内容（6）

工具	用途
company_create_post	发布文本帖子（链接 / 图片可选）。
company_edit_post	替换现有帖子的正文。
company_delete_post	永久删除——请参见 docs/RCA_DELETE_POST.md。
company_schedule_post	按未来的 ISO-8601 日期时间发布。
company_reply_comment	以主页身份回复你某条帖子下的评论。
company_reshare_post	在主页上转发其他帖子，评论内容可选。

公司增长（2）

工具	用途
company_invite_to_follow	向 1 度人脉发送关注邀请（LinkedIn 每月上限为 250 次）。
company_list_scheduled	列出已排队等待未来发布的帖子。

个人账号 -> 公司主页桥接（4）

工具	用途
personal_tag_company	发布提及该主页（@）的个人帖子。
personal_reshare_company_post	在个人主页上转发公司主页的帖子。
personal_comment_as_admin	以公司主页（或你本人）的身份评论主页帖子。
personal_read_company_mentions	检查你的近期动态，查找标记该主页的帖子。

安全模型

• 不处理电子邮件地址 / 密码。 此代码不会接触凭据。
• 会话状态保存在持久化浏览器配置文件目录中，按 OS 用户隔离，且位于仓库之外。
• .env 仅包含配置（日志级别、传输方式、工具超时）。不含机密信息。
• 首次登录时会将配置文件目录权限设为 chmod'd 到 0o700（Unix）。
• 速率限制按工具执行；限额有意设置得较为保守，根据 LinkedIn 可接受的频率进行调整，而非按其允许的上限设置。

支持的工作流

• 在 Claude 中起草、审核并发布公司主页帖子。
• 在个人帖子中标记主页，并跟踪社区的反响。
• 审查本周发布过有关主页内容的用户（管理员提及）。
• 批量邀请一度人脉关注主页，达到 LinkedIn 的月度配额后停止。
• 在发布前，对已排期的帖子执行完整的 CRUD 流程。

端到端示例请参阅 docs/TOOL_REFERENCE.md。

故障排除

docs/TROUBLESHOOTING.md 涵盖了选择器变更、验证码、速率限制、Cookie 过期和 Chromium 启动问题。

贡献

欢迎贡献。有关本地设置、测试布局以及添加新工具的工作流，请参阅 docs/CONTRIBUTING.md。

状态

正在积极开发。版本历史请参阅 CHANGELOG.md，路线图请参阅 issues。

许可证

MIT