publora/linkedin-analytics

LinkedIn Analytics

LinkedInの投稿とプロフィールのインプレッション、エンゲージメント、フォロワー増加を追跡し、リアクション、コメント、リシェアを通じて投稿とインタラクションを行います。統計情報はREST APIから取得し、リアクション、コメント、リシェア、メンション検索はMCPツールを使用します。

前提条件

プラン: 無料のスタータープランで動作します。現在の制限と料金: publora.com/pricing

はじめに

1. アカウントを作成 publora.com/register（無料）
2. LinkedInを接続 Publoraダッシュボードで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コネクタでは、それぞれ異なる設定ファイルまたはフローが必要です。正確なパスとスニペットについてはクライアント設定を参照してください。

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"
  }'

プラットフォーム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

1つの投稿のエンゲージメント指標。

ボディ:

• 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:...）として指定します。注意: このツールはリアクションやコメントツールの postedId ではなく parent を使用します。
• commentary（オプション）: リシェアの上に表示するテキスト（最大3,000文字）
• visibility（オプション）: PUBLIC または CONNECTIONS、デフォルトは PUBLIC。CONNECTIONS は個人アカウント用です。

注: LinkedInフィードURLには activity IDが含まれますが、これはシェアIDと同じではない場合があります。手動で変換したactivity IDではなく、get_post が返す postedId を使用してください。

linkedin_list_mentionables

名前を@メンションに必要なURNに解決します。メンバーIDを手動で入力する必要がなくなります。

パラメータ:

• q（オプション）: 検索する名前
• limit（オプション）: 返す結果の数

両方ともオプションで、このツールは platformId を必要としません。接続ではなくアカウント全体を検索します。

プロンプト例

週間パフォーマンスレビュー

過去7日間のLinkedInパフォーマンスを分析してください。
以下の項目を表示:
1. 最もパフォーマンスの良かった投稿
2. エンゲージメント率のトレンド
3. フォロワー増加
4. 改善のための推奨事項

投稿分析

私の最新のLinkedIn投稿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 が必要です。正確なURNには、Publoraの get_post レスポンスから返される postedId を使用してください。

3. キャッシュ: 分析レスポンスはキャッシュされる場合があります。レスポンスには、データがキャッシュから取得されたかどうかを示す cached フィールドが含まれます。

4. レート制限: LinkedInには1時間あたり約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文字未満に短縮