LinkedIn MCP Server Skill 技能

LinkedIn MCP Server — LinkedIn 营销自动化 MCP 服务器

技能简介

LinkedIn MCP Server 是由开发者 oliverhruby 开源的 Python MCP（Model Context Protocol）服务器，专为 AI Agent 提供 LinkedIn 接口能力而设计。它不是简单的 LinkedIn 数据抓取工具，而是一套完整的 LinkedIn API 封装：支持 OAuth 授权流程、内容发布（帖子/评论/互动）、广告投放管理、媒体上传和组织机构管理。该项目最大亮点是其预览执行模式（Dry-Run Default）：所有写操作（发帖、评论、删除等）默认 execute=false，仅返回请求预览，确认为真后再执行，避免误操作导致的生产事故。目前已支持 Cursor、Claude、opencode 等主流 MCP 客户端，是数字营销团队和 LinkedIn 运营人员提升效率的利器，MIT 许可证开源。

核心能力

1. 完整 OAuth 2.0 授权流程：auth_start → auth_poll → auth_finish 三步完成浏览器授权码交换，本地回调，Token 自动刷新。
2. 预览执行模式（Dry-Run Default）：所有写操作默认 execute=false，返回请求预览；确认无误后传入 execute=true 才真正执行。
3. 广告管理能力：支持 Ad Account 查询、广告系列（Campaign）和广告组（Campaign Group）的创建、查询和管理，是 MCP 生态中少见的 LinkedIn Ads 功能。
4. 内容发布全套工具：发帖、评论、互动（点赞/反应）、删除帖子，覆盖 LinkedIn 运营日常操作。
5. 媒体上传工作流：initialize_media_upload → finalize_media_upload 完整流程，支持图片和视频上传到 LinkedIn。
6. 组织机构权限管理：基于 ACL 的组织可见性控制，按角色分配 LinkedIn 页面管理权限。
7. 每工具能力矩阵：list_capabilities 工具返回每个操作的有效性状态和缺失权限提示。
8. Capability-Aware 工具目录：内置 tool_catalog.json，明确标注每个工具的写操作性质和前置要求。
9. 安全优先设计：不包含 DM（私信）功能，避免 Sales Navigator/Partner 批准的 w_member_social 权限滥用风险。
10. 多 MCP 客户端兼容：opencode、Claude Desktop、Cursor 等主流 MCP 客户端均可接入使用。

安装配置

前置要求

• Python 3.10+
• 已注册 LinkedIn Developer App 并获取 Client ID 和 Client Secret

LinkedIn App 注册步骤

1. 前往 LinkedIn Developer Portal 创建新 App
2. 在 Auth Settings 中添加 OAuth Redirect URL（如 http://127.0.0.1:8765/callback）
3. 复制 Client ID 和 Client Secret
4. 在产品/权限页面申请所需 Scope（建议从登录类权限开始逐步加）

安装方式

# 方式一：pip 可编辑安装（推荐开发）
pip install -e .
linkedin-mcp-full

# 方式二：uvx 从源码运行
uvx --from . linkedin-mcp-full

环境变量配置

export LINKEDIN_CLIENT_ID="your_client_id"
export LINKEDIN_CLIENT_SECRET="your_client_secret"
export LINKEDIN_REDIRECT_URI="http://127.0.0.1:8765/callback"

MCP 客户端配置示例（opencode）

{
  "mcp": {
    "linkedin": {
      "type": "local",
      "enabled": true,
      "command": ["uvx", "--from", "git+https://github.com/oliverhruby/linkedin-mcp.git", "linkedin-mcp-full"],
      "env": {
        "LINKEDIN_CLIENT_ID": "{env:LINKEDIN_CLIENT_ID}",
        "LINKEDIN_CLIENT_SECRET": "{env:LINKEDIN_CLIENT_SECRET}",
        "LINKEDIN_REDIRECT_URI": "{env:LINKEDIN_REDIRECT_URI}"
      }
    }
  }
}

使用步骤

第一步：启动 LinkedIn 登录流程 在 AI 助手中输入：启动 LinkedIn 登录 助手调用 auth_start，返回授权 URL 和本地回调监听信息，打开链接完成浏览器授权。

第二步：查询当前账户能力 输入：检查我的 LinkedIn 账户有哪些操作权限 调用 list_capabilities，返回每个工具的有效性状态和缺失权限提示。

第三步：预览发帖 输入：帮我创建一条帖子草稿，内容是介绍我们的 AI Agent 新产品 调用 create_post execute=false，返回请求体预览，确认无误后进行下一步。

第四步：正式发布 输入：请发布这条帖子 调用 create_post execute=true，正式创建 LinkedIn 帖子，返回发布结果。

第五步：管理广告系列（如需要） 输入：列出我的广告账户 调用 list_ad_accounts → list_campaigns 查看现有广告系列 → create_campaign 创建新广告。

适用场景

1. AI 驱动的 LinkedIn 内容运营：AI Agent 自动撰写和发布 LinkedIn 帖子，保持品牌活跃度。
2. 社交媒体管理平台：聚合管理多个 LinkedIn 主页，AI 辅助内容规划和发布。
3. LinkedIn 广告自动化投放：AI Agent 根据数据自动创建和调整广告系列，提升投放效率。
4. B2B 销售情报：AI Agent 自动抓取 LinkedIn 帖子和评论，提取行业洞察和竞品动态。
5. 招聘自动化：结合 LinkedIn 组织机构 API，自动分析目标公司员工结构和招聘动态。
6. 内容合规审核：所有操作默认预览模式，确保 AI 生成的 LinkedIn 内容经过人工确认再发布。

适用人群

• LinkedIn 运营人员：需要高频发布内容、管理广告的数字营销团队。
• B2B 营销经理：通过 LinkedIn 拓展客户资源，需要自动化工具辅助。
• AI 应用开发者：构建 LinkedIn 集成的 AI Agent 系统的工程师。
• 出海企业营销团队：通过 LinkedIn 进行海外市场推广，需要高效运营工具。

工作原理

LinkedIn MCP Server 基于 Model Context Protocol 实现，作为 MCP 客户端（Claude Code/opencode 等）和 LinkedIn 官方 API 之间的中间层。OAuth 授权流程通过本地 HTTP Server 接收 LinkedIn 回调，完成授权码交换和 Token 存储。每次 MCP 工具调用均通过 linkedin_get/linkedin_post 原始 API 助手发送到 LinkedIn 接口，由 MCP Server 统一管理认证 Token。写操作默认 Dry-Run 模式，仅在收到显式 execute=true 参数时才会真正发起写请求，确保操作安全可控。

官方链接

• PyPI：https://pypi.org/project/linkedin-mcp-full/
• GitHub：https://github.com/oliverhruby/linkedin-mcp
• LinkedIn Developer Portal：https://www.linkedin.com/developers/