publora/linkedin-analytics

LinkedIn分析

追踪你的LinkedIn帖子和个人主页的展示量、互动和粉丝增长，并通过反应、评论和转发与帖子互动。统计数据来自REST API；反应、评论、转发和提及查找为MCP工具。

前提条件

计划： 适用于免费的Starter计划。当前限制和定价：publora.com/pricing。

快速开始

1. 在 publora.com/register 创建账号（免费）
2. 在 Publora Dashboard 通过OAuth连接LinkedIn
3. 在 app.publora.com/dashboard/api 获取API密钥
4. 将你的代理连接到MCP服务器，地址为 https://mcp.publora.com，使用 Authorization: Bearer sk_YOUR_API_KEY 进行身份验证。在Claude Code中：

claude mcp add publora --transport http https://mcp.publora.com \
  --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）：

# 获取已连接的平台
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_your_api_key"

# 获取帖子统计数据
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"
  }'

# 获取账号统计数据
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"
  }'

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

示例ID：linkedin-Tz9W5i6ZYG，linkedin-abc123xyz

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

分析工具（仅REST）

LinkedIn分析不作为MCP工具公开。MCP服务器提供发布、媒体和LinkedIn互动工具；统计数据仅存在于REST API中，因此请直接使用 x-publora-key 请求头调用这些端点。询问代理 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：要转发的帖子，以分享URN格式（urn:li:share:... 或 urn:li:ugcPost:...）。注意命名：此工具使用 parent，而不是像反应和评论工具那样的 postedId。
• commentary（可选）：转发上方的文字，最多3,000个字符
• visibility（可选）：PUBLIC 或 CONNECTIONS，默认为 PUBLIC。CONNECTIONS 适用于个人账号。

注意：LinkedIn feed URL中带有 activity ID，它并不总是与分享ID相同。请使用 get_post 返回的 postedId，而不是手动转换的 activity ID。

linkedin_list_mentionables

将名字解析为@提及所需的URN，这样你就无需手动编写成员ID。

参数：

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

两者均为可选，且此工具不接收 platformId：它跨账号而非单个连接进行搜索。

示例提示

每周表现回顾

分析我过去7天的LinkedIn表现。
请展示：
1. 哪些帖子表现最好
2. 我的互动率趋势
3. 粉丝增长情况
4. 改进建议

帖子分析

获取我最近5个帖子的详细数据，并找出哪些内容能引起观众共鸣的模式。

互动活动

对我同事关于晋升的帖子（urn:li:share:123456）用PRAISE反应，并添加一条祝贺评论。

粉丝追踪

展示我过去30天的LinkedIn粉丝增长情况。我每周新增了多少粉丝？

指标参考

指标	说明
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字符以内