linkedin-analytics

LinkedIn Analytics

跟踪 LinkedIn 帖子和个人资料的展示次数、互动情况及关注者增长，并通过反应、评论和转发与帖子互动。统计数据来自 REST API；反应、评论、转发和提及查询则由 MCP 工具提供。

先决条件

**套餐：**免费 Starter 套餐即可使用。当前限制和定价：publora.com/pricing。

开始使用

1. 创建账户：publora.com/register（免费）
2. 连接 LinkedIn：在 Publora Dashboard 中通过 OAuth 连接
3. 获取 API 密钥：前往 app.publora.com/dashboard/api，仅当 Agent 无法通过 OAuth 登录，或你将使用下方的 REST API 后备方案时才需要
4. 将 Agent 连接到 MCP 服务：https://mcp.publora.com/mcp
   • 升级不带 /mcp 的手动连接： Claude 会将 https://mcp.publora.com 视为与内置服务不同的服务。请在当前作用域中，将现有连接改为 https://mcp.publora.com/mcp，并保留其身份验证和所选账户；如果系统提示，请重新登录。或者，确认内置连接使用的是预期账户，然后仅移除旧的手动条目。请勿添加第二个条目，也不要自动删除凭据。
   • Publora 工具已可用（publora-skills 插件或 Claude 中的 Publora 连接器）：无需设置。首次运行工具时，Claude 会要求你登录 Publora。
   • 支持 OAuth 的 Agent（Claude Code、Cursor，以及 Claude 和 ChatGPT 应用）：按 URL 添加服务并登录，无需 API 密钥。在 Claude Code 中，先添加服务，然后运行 /mcp 登录：

claude mcp add --transport http --scope user publora https://mcp.publora.com/mcp

• **不支持 OAuth 的 Agent：**将 API 密钥作为 Authorization: Bearer sk_YOUR_API_KEY 发送：

claude mcp add --transport http --scope user publora https://mcp.publora.com/mcp \
  --header "Authorization: Bearer sk_YOUR_API_KEY"

Claude Desktop、Cursor、Codex、OpenClaw 和 claude.ai 连接器各自需要不同的配置文件或流程：具体路径和代码片段请参阅客户端设置。

REST API 后备方案

如果 MCP 服务不可用或返回错误，请直接使用 REST API：

基础 URL： https://api.publora.com/api/v1

**身份验证：**使用 x-publora-key 标头（不是 Authorization: Bearer）：

# Get your connected platforms
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_your_api_key"

# Get post statistics
curl -X POST "https://api.publora.com/api/v1/linkedin-post-statistics" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platformId": "linkedin-abc123",
    "postedId": "urn:li:share:7123456789012345678",
    "queryTypes": "ALL"
  }'

# Get account statistics
curl -X POST "https://api.publora.com/api/v1/linkedin-account-statistics" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platformId": "linkedin-abc123",
    "queryTypes": "ALL"
  }'

平台 ID 格式：linkedin-{id}，其中 {id} 来自 /platform-connections 响应。

示例 ID：linkedin-Tz9W5i6ZYG、linkedin-abc123xyz

📖 完整 API 文档：docs.publora.com

Analytics 工具（仅限 REST）

LinkedIn 分析功能未作为 MCP 工具提供。MCP 服务包含发布、媒体和 LinkedIn 互动工具；统计数据仅通过 REST API 提供，因此请使用 x-publora-key 标头直接调用这些端点。要求 Agent 使用 linkedin_post_stats MCP 工具会失败：该工具不存在。

POST /linkedin-post-statistics

单条帖子的互动指标。

请求体：

• platformId：平台连接 ID（例如 linkedin-abc123），来自 list_connections
• postedId：帖子 URN（urn:li:share:... 或 urn:li:ugcPost:...）
• queryTypes（可选）：IMPRESSION、MEMBERS_REACHED、RESHARE、REACTION、COMMENT 或 ALL

**返回：**展示次数、独立展示次数（触达成员数）、反应数、评论数、转发数，以及用于说明数据是否来自缓存的 cached 标记。

POST /linkedin-account-statistics

账户汇总统计数据。

请求体：platformId、可选的 queryTypes、可选的 aggregation（DAILY 或 TOTAL，默认值为 TOTAL）。

POST /linkedin-followers

关注者数量或随时间的增长情况。

请求体：platformId、可选的 period（lifetime 或 daily）、可选的 dateRange（{start: {year, month, day}, end: {year, month, day}}）。

POST /linkedin-profile-summary

个人资料综合概览：关注者数量及统计数据。

请求体：platformId、可选的 dateRange。

curl -X POST "https://api.publora.com/api/v1/linkedin-post-statistics" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"platformId": "linkedin-abc123", "postedId": "urn:li:share:7123456789012345678", "queryTypes": "ALL"}'

互动工具

linkedin_create_reaction

对 LinkedIn 帖子作出回应。

参数：

• postedId：LinkedIn 帖子 URN
• platformId：平台连接 ID
• reactionType：以下类型之一：

类型	描述
LIKE	标准点赞
PRAISE	鼓掌
EMPATHY	爱心／喜爱
INTEREST	灯泡／有见地
APPRECIATION	表示支持
ENTERTAINMENT	有趣／大笑

linkedin_delete_reaction

移除你对帖子的回应。

参数：

• postedId：LinkedIn 帖子 URN
• platformId：平台连接 ID

linkedin_create_comment

在 LinkedIn 帖子下发表评论（最多 1,250 个字符）。

参数：

• postedId：LinkedIn 帖子 URN
• platformId：平台连接 ID
• message：评论内容（最多 1,250 个字符）
• parentComment（可选）：用于嵌套回复的评论 URN

linkedin_delete_comment

删除你发布的评论。

参数：

• postedId：LinkedIn 帖子 URN
• commentId：评论 URN 或数字 ID
• platformId：平台连接 ID

linkedin_create_reshare

转发现有帖子，可选择添加评论。

参数：

• platformId：平台连接 ID
• parent：要转发的帖子，格式为 share URN（urn:li:share:... 或 urn:li:ugcPost:...）。请注意参数名称：此工具使用 parent，而回应和评论工具使用 postedId。
• commentary（可选）：转发上方的文字，最多 3,000 个字符
• visibility（可选）：PUBLIC 或 CONNECTIONS，默认值为 PUBLIC。CONNECTIONS 适用于个人账户。

注意：LinkedIn 动态消息 URL 中包含一个 activity ID，它不一定与 share ID 相同。请使用 get_post 返回的 postedId，不要手动转换 activity ID。

linkedin_list_mentionables

将姓名解析为 @提及所需的 URN，无需手动填写成员 ID。

参数：

• q（可选）：要搜索的姓名
• limit（可选）：返回的结果数量

两者均为可选参数，且此工具不接受 platformId：它会搜索整个账户，而非单个连接。

示例提示词

每周绩效回顾

Analyze my LinkedIn performance for the last 7 days.
Show me:
1. Which posts performed best
2. My engagement rate trends
3. Follower growth
4. Recommendations for improvement

帖子分析

Get detailed stats for my last 5 LinkedIn posts and identify patterns in what content resonates with my audience.

互动活动

React with PRAISE to my colleague's post about their promotion (urn:li:share:123456) and add a congratulatory comment.

关注者追踪

Show my LinkedIn follower growth for the last 30 days. How many new followers did I gain each week?

指标参考

指标	描述
IMPRESSION	内容在动态消息中出现的总次数
MEMBERS_REACHED	看过帖子的 LinkedIn 独立成员数量
RESHARE	转发／分享次数
REACTION	回应总数（所有类型合计）
COMMENT	评论数量

互动率基准

按关注者数量划分的 LinkedIn 平均互动率：

关注者	良好互动率
< 5K	3-5%
5K-50K	2-3%
50K+	1-2%

表现良好的帖子通常具备以下特点：

• 展示次数达到你的平均值的 2 倍
• 评论与回应的比例超过 10%
• 互动率高于你的基准值

重要说明

1. 分析数据延迟：LinkedIn 分析数据可能需要最多 24 小时才能完整生成。发布后立即查询会返回部分数据。

2. URN 格式：LinkedIn URL 使用 urn:li:activity:xxx，但 API 要求使用 urn:li:share:xxx 或 urn:li:ugcPost:xxx。请使用 Publora 的 get_post 响应中的 postedId，以获取准确的 URN。

3. 缓存：分析响应可能会被缓存。响应包含一个 cached 字段，用于指示数据是否来自缓存。

4. 速率限制：LinkedIn 每小时大约限制 200+ 次 API 调用。遇到 429 错误时，请采用退避策略。

故障排除

错误	原因	解决方法
"Platform ID not found"	连接 ID 无效	运行 list_connections 获取有效 ID
"Post not found"	URN 格式错误	使用 urn:li:share: 或 urn:li:ugcPost: 格式
429 Too Many Requests	触发速率限制	等待后使用指数退避策略重试
"message cannot exceed 1250 characters"	评论过长	将评论缩短至 1,250 个字符以内