Linkedin Ads Mcp

LinkedIn Ads MCP 服务

一个 MCP（Model Context Protocol）服务，可让 Claude AI 访问并分析你的 LinkedIn Ads 数据。专为希望利用 AI 优化广告系列、生成效果报告并做出数据驱动广告决策的营销人员、创业者和增长团队打造。

提示

想要无需任何设置就能使用吗？ 同一作者推出的 AdPlug 是托管式 LinkedIn Ads MCP。通过 OAuth 登录（无需 LinkedIn 开发者应用，也无需管理凭据），大约两分钟即可连接 Claude、ChatGPT 或 Cursor，还能在同一连接器中使用 Google Ads 和 Microsoft Ads。读取工具免费；每项写入操作都会在运行前预览。这个开源服务仍可免费使用并可自托管。

快速安装（无需编写代码！）

不想处理技术细节？ 只需复制下面的任一提示词并粘贴到 Claude 中。AI 会为你完成所有操作！

选项 1：使用 Claude Code 安装（推荐）

如果你已安装 Claude Code，只需复制并粘贴以下完整提示词：

I want you to install the LinkedIn Ads MCP server so I can analyze my LinkedIn advertising data. Please do the following:

1. FIRST, check if Node.js is installed by running `node --version`. If not installed, tell me to install it from https://nodejs.org first.

2. Clone the repository to my home directory:
   - cd ~
   - git clone https://github.com/danielpopamd/linkedin-ads-mcp.git
   - cd linkedin-ads-mcp

3. Install dependencies and build:
   - npm install
   - npm run build

4. Create the .env file with placeholder values:
   - cp .env.example .env

5. NOW IMPORTANT - Ask me for my LinkedIn API credentials:
   - Ask: "Please provide your LinkedIn Client ID (from https://www.linkedin.com/developers/apps)"
   - Ask: "Please provide your LinkedIn Client Secret"

6. Update the .env file with the credentials I provide.

7. Set up Claude Desktop configuration:
   - Read the current Claude Desktop config file:
     - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
     - Windows: %APPDATA%/Claude/claude_desktop_config.json
   - Add the linkedin-ads MCP server to mcpServers (merge with existing config if any):
     {
       "mcpServers": {
         "linkedin-ads": {
           "command": "node",
           "args": ["<FULL_PATH_TO>/linkedin-ads-mcp/dist/index.js"],
           "env": {
             "LINKEDIN_CLIENT_ID": "<MY_CLIENT_ID>",
             "LINKEDIN_CLIENT_SECRET": "<MY_CLIENT_SECRET>"
           }
         }
       }
     }
   - Replace <FULL_PATH_TO> with the actual path (e.g., /Users/username)
   - Replace the env values with my actual credentials

8. Run the authentication flow:
   - npm run auth
   - This will open my browser - tell me to authorize the app with LinkedIn

9. Tell me to restart Claude Desktop to activate the MCP server.

10. After restart, confirm setup by telling me to ask Claude: "List my LinkedIn ad accounts"

If you don't have my LinkedIn API credentials yet, first explain how to get them:
- Go to https://www.linkedin.com/developers/apps
- Create a new app (need a LinkedIn Company Page)
- Go to Products tab and request "Advertising API" access
- Go to Auth tab and add redirect URL: http://localhost:3000/callback
- Copy the Client ID and Client Secret

Start now!

选项 2：使用 Claude Desktop 安装（基于聊天）

如果你直接使用 Claude Desktop（不使用 Claude Code），请复制此提示词以开始引导式设置：

I want to install the LinkedIn Ads MCP server to analyze my LinkedIn advertising data with Claude. I'm not technical, so please guide me step by step with simple instructions.

Please walk me through:

1. **Check Prerequisites**
   - Do I have Node.js installed? (Tell me how to check and where to download if needed)
   - Do I have a LinkedIn Developer App? (If not, guide me through creating one at https://www.linkedin.com/developers/apps)

2. **Get LinkedIn API Access**
   Walk me through:
   - Creating a LinkedIn Developer App
   - Requesting Advertising API access (Products tab)
   - Adding the redirect URL: http://localhost:3000/callback (Auth tab)
   - Finding my Client ID and Client Secret

3. **Download and Install**
   Give me the exact commands to run in my terminal (one at a time):
   - How to open Terminal (Mac) or Command Prompt (Windows)
   - Clone the repository
   - Install dependencies
   - Build the project

4. **Configure Claude Desktop**
   - Tell me exactly where the config file is located
   - Give me the exact JSON to add (with placeholders for my credentials)
   - Show me how to edit the file

5. **Authenticate with LinkedIn**
   - What command to run
   - What to do when the browser opens

6. **Test the Setup**
   - Tell me to restart Claude Desktop
   - Give me a test question to ask

Please start with step 1 and wait for my response before moving to the next step. Use simple language and assume I've never used a terminal before.

安装前的准备工作

使用任一安装方式前，你需要准备：

1. Node.js（版本 18 或更高）- 在此下载
2. LinkedIn 公司主页 - 创建开发者应用时需要
3. 具有 Advertising API 访问权限的 LinkedIn 开发者应用 - 在此创建

获取 LinkedIn API 凭据（5-10 分钟）

1. 前往 LinkedIn Developer Portal
2. 点击 “Create App”
3. 填写：
   • 应用名称：“My LinkedIn Ads Analytics”（或填写任意名称）
   • LinkedIn 页面：选择你的公司主页
   • 应用徽标：上传任意方形图片
4. 创建完成后，前往 “Products” 标签页 → 申请 “Advertising API”（审批需要 1-5 天）
5. 前往 “Auth” 标签页 → 添加重定向 URL：http://localhost:3000/callback
6. 复制你的 Client ID 和 Client Secret——后续需要使用！

作者

Daniel Popa - 效果营销顾问与 AI 自动化专家

我帮助有抱负的初创企业通过付费广告、转化率优化和数据驱动的增长策略实现盈利增长。我拥有 10 多年的效果营销经验，曾管理超过 1 亿美元的广告预算；如今，我专注于实施 AI 工作流和自动化，以提升营销效率和效果。

创建此工具旨在连接 LinkedIn 广告数据与 AI 驱动的分析，让营销人员可以通过与 Claude 自然语言对话，更轻松地获取可执行的洞察。

• 网站：danielpopa.me
• 专注领域：效果营销、AI 自动化、增长战略

手动安装（面向开发者）

如果你希望手动安装或获得更多控制权，请按照以下说明操作。

功能说明

此 MCP 服务将 Claude Desktop（或任何兼容 MCP 的客户端）连接到 LinkedIn Marketing API，让你可以：

• 使用自然语言查询广告系列表现
• 分析受众人口统计信息，了解哪些人在与你的广告互动
• 跟踪 LinkedIn 广告系列中的转化和潜在客户
• 比较不同时间段、广告系列或广告系列组之间的表现
• 获取广告数据的 AI 洞察

与 Claude 的对话示例

"Show me campaign performance for the last 30 days"
"Which job functions are responding best to my ads?"
"Compare this week's performance vs last week"
"What's my cost per lead for the lead gen campaigns?"
"Which creatives have the best CTR?"
"Show me the daily trend for conversions"

功能

• 25 种专用工具 - 涵盖帐户、广告系列、创意、受众、转化、分析和完整的广告系列管理（创建、更新、删除）
• 全面的指标 - 每份报告都包含：支出、展示次数、点击次数、点击率、触达人数、频次、互动次数、互动率、千次展示费用、单次点击费用、转化次数、转化率、单次转化费用、受众渗透率和平均停留时间
• 统一 OAuth 身份验证 - 只需验证一次，即可访问所有 LinkedIn 广告帐户
• 自动刷新令牌 - 令牌会在过期前自动刷新
• 速率限制处理 - 内置针对 API 速率限制的指数退避机制
• 易读的名称 - 人口统计数据会显示实际名称（而非 ID），包括资历、职能、行业等

前提条件

1. LinkedIn 开发者应用

使用此 MCP 服务前，你需要设置 LinkedIn 开发者应用：

1. 前往 LinkedIn 开发者门户
2. 点击 “Create App”
3. 填写应用详情：
   • 应用名称：例如“我的 LinkedIn 广告分析”
   • LinkedIn 专页：选择你的公司专页
   • 应用徽标：上传徽标（必需）
4. 记下你的 Client ID 和 Client Secret

2. 申请广告 API 访问权限

1. 在应用中，前往 “Products” 选项卡
2. 选择 “Advertising API”
3. 提交申请表，并说明你的业务理由
4. 等待审批（通常需要 1-5 个工作日）

3. 配置 OAuth

1. 在应用中，前往 “Auth” 选项卡
2. 添加此重定向 URL：http://localhost:3000/callback
3. 确认以下 OAuth 2.0 作用域可用：
   • r_ads - 读取广告帐户
   • r_ads_reporting - 读取报告数据
   • rw_ads - 创建和管理广告系列、创意和广告
   • r_organization_social - 读取组织帖子（用于创意内容）

安装

# Clone the repository
git clone https://github.com/danielpopamd/linkedin-ads-mcp.git
cd linkedin-ads-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Create your environment file
cp .env.example .env

使用你的 LinkedIn 凭据编辑 .env：

LINKEDIN_CLIENT_ID=your_client_id
LINKEDIN_CLIENT_SECRET=your_client_secret

身份验证

运行身份验证流程以获取访问令牌：

npm run auth

此操作将：

1. 在浏览器中打开 LinkedIn OAuth 页面
2. 要求你授权此应用
3. 在本地将令牌存储到 ~/.linkedin-ads-mcp/tokens.json
4. 令牌有效期为 60 天，并会自动刷新

Claude Desktop 设置

将以下内容添加到 Claude Desktop 配置文件中：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "linkedin-ads": {
      "command": "node",
      "args": ["/full/path/to/linkedin-ads-mcp/dist/index.js"],
      "env": {
        "LINKEDIN_CLIENT_ID": "your_client_id",
        "LINKEDIN_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

重要提示：将 /full/path/to/linkedin-ads-mcp 替换为你克隆此仓库的实际路径。

更新配置后，重启 Claude Desktop 以使更改生效。

可用工具

帐户管理

广告系列与创意表现

受众与人口统计

转化与潜在客户开发

高级分析

广告系列管理（写入操作）

标准指标

每份效果报告都包含以下指标：

API 限制与最佳实践

LinkedIn API 限制

• 速率限制：每个 5 分钟窗口最多 4,500 万个指标值
• 响应限制：每次响应最多 15,000 个元素
• 每次请求的指标数：最多 20 个指标
• 人口统计数据延迟：12-24 小时
• 触达数据：日期范围最多 92 天

最佳实践

1. 从列出账户开始 - 始终先列出账户，以获取有效的账户 ID
2. 使用合理的日期范围 - 范围越短，返回越快；定期报告建议使用 30 天
3. 指定广告系列 - 知道要分析哪些广告系列时，按广告系列 ID 筛选
4. 善用比较 - 使用比较工具快速识别效果变化

项目结构

linkedin-ads-mcp/
├── src/
│   ├── index.ts              # MCP server entry point
│   ├── auth-cli.ts           # OAuth CLI tool
│   ├── auth/
│   │   ├── oauth.ts          # OAuth 2.0 flow
│   │   └── token-store.ts    # Secure token storage
│   ├── lib/
│   │   ├── linkedin-api.ts   # LinkedIn Marketing API client
│   │   └── types.ts          # TypeScript type definitions
│   └── tools/
│       ├── accounts.ts       # Account management tools
│       ├── performance.ts    # Campaign & creative performance
│       ├── demographics.ts   # Audience demographics tools
│       ├── conversions.ts    # Conversion & lead gen tools
│       ├── analytics.ts      # Advanced analytics tools
│       └── campaign-management.ts  # Campaign CRUD & image upload tools
├── dist/                     # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── .env.example

开发

# Build the project
npm run build

# Run the server (for testing)
npm run dev

# Run authentication flow
npm run auth

故障排除

出现“未通过身份验证”错误

运行 npm run auth，以通过 LinkedIn 进行身份验证。

收到“速率受限”响应

服务会自动通过指数退避处理速率限制。如果频繁触及限制，请降低请求频率。

令牌已过期

令牌会自动刷新。如果问题仍未解决，请删除 ~/.linkedin-ads-mcp/tokens.json，然后运行 npm run auth 重新进行身份验证。

API 访问被拒绝

请确保你的 LinkedIn Developer 应用已满足以下条件：

1. 已获批使用“Advertising API”产品
2. 已启用正确的 OAuth 权限范围（r_ads、r_ads_reporting）
3. 你的用户账号有权访问你要查询的广告账号

广告系列名称显示为“Unknown”

这通常意味着分析数据中的广告系列 ID 与账号中的任何广告系列都不匹配。这种情况可能是由已归档的广告系列或同步延迟造成的。

技术栈

• Model Context Protocol (MCP) - 使 Claude 能够与外部工具交互的协议
• LinkedIn Marketing API - 用于获取 LinkedIn 广告数据的官方 API
• TypeScript - 类型安全的开发语言
• Node.js - 运行时环境

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

致谢

本项目使用 Anthropic 提供的 Model Context Protocol SDK 构建。

由 Daniel Popa 借助 AI 工作流打造