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 キーを取得します。エージェントが OAuth でサインインできない場合、または下記の REST API フォールバックを使用する場合のみ必要です
4. エージェントを https://mcp.publora.com/mcp の MCP サーバーに接続します：
   • /mcp を使わない手動接続の更新： Claude は https://mcp.publora.com を、バンドル版とは別のサーバーとして扱います。既存の接続先を現在のスコープ内で https://mcp.publora.com/mcp に変更し、認証情報と選択済みアカウントを維持してください。求められた場合は再度サインインします。または、バンドル版の接続で意図したアカウントが使われていることを確認してから、古い手動エントリのみを削除してください。エントリを二重に追加したり、認証情報を自動的に削除したりしないでください。
   • Publora ツールがすでに利用可能な場合（publora-skills プラグイン、または Claude の Publora コネクター）：設定は不要です。初めてツールを実行するときに、Claude が Publora へのサインインを求めます。
   • OAuth に対応しているエージェント（Claude Code、Cursor、Claude アプリ、ChatGPT アプリ）：サーバーを URL で追加してサインインすればよく、API キーは不要です。Claude Code では、サーバーを追加してから /mcp を実行し、サインインします：

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

• OAuth に対応していないエージェント： 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 の形式： /platform-connections のレスポンスに含まれる {id} を使った linkedin-{id}

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：再共有する投稿。share URN（urn:li:share:... または urn:li:ugcPost:...）で指定します。名前に注意してください。このツールでは、リアクションやコメントのツールのような postedId ではなく、parent を指定します。
• commentary（任意）：再共有の上に表示するテキスト。最大 3,000 文字です。
• visibility（任意）：PUBLIC または CONNECTIONS。デフォルトは PUBLIC です。CONNECTIONS は個人アカウント用です。

注：LinkedIn のフィード URL に含まれるのは activity ID であり、share ID と常に同じとは限りません。手動で変換した activity ID ではなく、get_post が返す postedId を使用してください。

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 が必要です。正確な URN を取得するには、Publora の get_post レスポンスに含まれる postedId を使用してください。

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

4. レート制限：LinkedIn の API 呼び出しは、1 時間あたり約 200 回以上に制限されています。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 文字未満に短くしてください