publora/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
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 連接器各自需要不同的設定檔或流程：請參閱 client setup 以取得確切路徑與程式碼片段。

REST API 備援方案

若 MCP 伺服器無法使用或回傳錯誤，請直接使用 REST API：

Base 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 動態消息網址中包含 activity 編號，這通常與分享編號不同。請使用 get_post 回傳的 postedId，而不是自行轉換的 activity 編號。

linkedin_list_mentionables

將名稱解析為 @提及所需的 URN，讓您無需手動查找成員 ID。

參數：

• q（可選）：要搜尋的名稱
• limit（可選）：回傳的結果數量

兩個參數皆為選填，且此工具不需要 platformId：它會搜尋整個帳號，而非單一連線。

範例提示

每週表現回顧

分析我過去 7 天的 LinkedIn 表現。
請告訴我：
1. 哪些貼文表現最佳
2. 我的互動率趨勢
3. 粉絲成長情況
4. 改善建議

貼文分析

取得我最近 5 篇 LinkedIn 貼文的詳細統計資料，並找出哪些內容能引起觀眾共鳴的模式。

互動活動

對我同事關於晉升的貼文（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 網址使用 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 個字元以內