linkedin-posts

📝 LinkedIn Posts API：投稿とエンゲージメントを構造化 JSON に

LinkedIn Posts API を利用する最も効率的で、信頼性が高く、開発者に優しい方法です。

Actor ページ： apify.com/johnvc/linkedin-posts-api 入力スキーマ： apify.com/johnvc/linkedin-posts-api/input-schema

公開 LinkedIn プロフィールの URL を指定すると、その人の最近の投稿を検出します。特定の投稿 URL を渡して直接取得することもできます。投稿ごとに、テキスト、リアクション、コメント、シェア、ハッシュタグ、メディア、投稿者の詳細を含む、すっきりした JSON 行が返されます。API ファーストで MCP に対応しているため、Python から呼び出したり、AI エージェントのツールとして操作したりできます。

動画ガイド

クイックスタート

前提条件

• Python 3.11 以降
• Apify アカウントと API キー（こちらから無料のキーを取得）

1. リポジトリをクローンする

   git clone https://github.com/johnisanerd/Apify-LinkedIn-Posts-API.git
   cd Apify-LinkedIn-Posts-API
   

2. UV で依存関係をインストールする

   # Install UV if you do not have it:
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Install project dependencies:
   uv sync
   

3. API キーを設定する

   cp .env.example .env
   # Edit .env and add your Apify API key
   # Get your free API key at: https://apify.com?fpr=9n7kx3
   

4. サンプルを実行する

   uv run python linkedin-posts-api-example.py
   

別の方法：API キーを直接設定する

export APIFY_API_TOKEN="your_api_key_here"
uv run python linkedin-posts-api-example.py

この LinkedIn Posts API を使う理由

URL を渡すだけで、構造化データが得られます。 収集インフラに触れる必要はありません。プロフィール URL（または特定の投稿 URL）を渡すと、シート、データベース、BI ツールにそのまま取り込める、フラットで予測しやすいフィールドが得られます。

収集方法は 2 通りです。 プロフィールの最近の投稿を検出する（新しい順、件数の上限を指定でき、必要に応じて日付で絞り込み可能）か、URL を指定して既知の投稿を一度に最大 1000 件取得できます。

投稿ごとの従量課金です。 料金は返された投稿ごとに発生し、実行ごとの基本料金はないため、実際に提供された分だけお支払いいただきます。

信頼性が高く、予測可能です。 すべての投稿は同じフィールド構成で返されます。また、公開投稿がないプロフィールの場合は、実行全体を失敗させるのではなく、明確なエラー行が返されます。

MCP に対応しています。 Claude、Cursor、その他の AI エージェントからツールとして呼び出せます（以下のインストール手順を参照）。

機能

主な機能

• プロフィール URL から最近の投稿を検出するか、URL を指定して特定の投稿を取得
• 投稿テキスト、ハッシュタグ、メディア、リンクに加え、投稿タイプと日付
• すべての投稿のリアクション、コメント、シェア
• 投稿者の名前、見出し、フォロワー数、上位コメントのサンプル

データ品質

• 毎回、投稿ごとに一貫した JSON 行を返します
• すばやく確認したり AI で利用したりできる、わかりやすい文章の summary フィールドを各行に含みます
• 公開投稿がないプロフィールには明確なエラー行を返すため、空のプロフィールがバッチ全体を失敗させることはありません

使用例

プロフィールの投稿を検出する

{
  "profileUrls": ["https://www.linkedin.com/in/williamhgates"],
  "maxPostsPerProfile": 5
}

検出対象を日付範囲で絞り込む

{
  "profileUrls": ["https://www.linkedin.com/in/williamhgates"],
  "maxPostsPerProfile": 50,
  "startDate": "2025-01-01",
  "endDate": "2025-12-31"
}

URL を指定して特定の投稿を取得する

{
  "postUrls": [
    "https://www.linkedin.com/posts/williamhgates_activity-7446904645010210816"
  ]
}

入力パラメーター

パラメーター	型	必須	デフォルト	説明
profileUrls	list[str]	いずれか 1 つ	-	投稿を検出する公開 LinkedIn /in/ プロフィール URL。1 回の実行につき最大 25 件。
postUrls	list[str]	いずれか 1 つ	-	直接取得する特定の LinkedIn 投稿 URL。1 回の実行につき最大 1000 件。
maxPostsPerProfile	int	いいえ	20	検出モードでのプロフィールごとの最大投稿数（最大 200 件）。コストを抑えます。投稿 URL の場合は無視されます。
startDate	str	いいえ	-	この日付以降の投稿のみを検出します（YYYY-MM-DD）。検出モードのみ。
endDate	str	いいえ	-	この日付以前の投稿のみを検出します（YYYY-MM-DD）。検出モードのみ。

profileUrls または postUrls の少なくとも一方を指定してください。

出力形式

各投稿は、1 つの JSON 行として返されます。

{
  "result_type": "post",
  "postId": "7446904645010210816",
  "postUrl": "https://www.linkedin.com/posts/williamhgates_activity-7446904645010210816",
  "postType": "post",
  "datePosted": "2025-06-01T12:00:00.000Z",
  "text": "A few books shaped how I think about clean energy this year...",
  "hashtags": ["cleanenergy", "books"],
  "authorName": "williamhgates",
  "authorHeadline": "Co-chair, Bill & Melinda Gates Foundation",
  "authorUrl": "https://www.linkedin.com/in/williamhgates",
  "authorFollowers": 37000000,
  "numLikes": 12045,
  "numComments": 843,
  "numShares": 210,
  "summary": "Post by williamhgates, 12,045 reactions, 843 comments, posted 2025-06-01"
}

投稿にシェアがある場合、numShares フィールドが返されます。

---

FAQ

これを使うと、LinkedIn または LinkedIn Recruiter のアカウントが危険にさらされますか？

いいえ。サインアウトした状態で誰でも開ける、公開 LinkedIn ページのみを読み取ります。ログインすることはなく、Cookie を要求することもありません。アカウント、パスワード、li_at セッション Cookie を入力する欄はありません。実行内容が LinkedIn アカウント、LinkedIn Recruiter のシート、Sales Navigator のライセンスに関連付けられることはありません。リクエストはブラウザー上ではなく Apify のサーバー上で実行されるため、あなたと関連付けられることはありません。また、実行中も Recruiter での作業を続けられます。

---

Claude Cowork デスクトップアプリにインストールする

Cowork は、デスクトップアプリの自動化モードです。LinkedIn Posts API をツールとして使えるようにするには、Apify MCP サーバーをコネクターとして追加します。

1. Claude デスクトップアプリを開き、Settings → Connectors に移動します（または Settings → Developer → Edit Config を選択して、claude_desktop_config.json を直接編集します）。
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
2. この Actor のみが事前に読み込まれた Apify MCP サーバーを追加します。

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/linkedin-posts-api"
      ]
    }
  }
}

3. アプリを再起動します。Cowork が初めてツールを呼び出すときに、ブラウザーで OAuth プロンプトを完了するか、コネクターの設定に Apify API トークンを追加して OAuth をスキップします。
4. Cowork のチャットでツールが利用可能であることを確認し、LinkedIn Posts API の実行を依頼します。

デスクトップアプリをダウンロードして、無料トライアルを始めましょう：https://claude.ai/referral/uIlpa7nPLg 詳しい説明：https://docs.apify.com/platform/integrations/claude-desktop

---

Claude Code にインストールする

Claude Code はコマンドラインツールです。次のコマンドで Actor の MCP サーバーを追加します。

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/linkedin-posts-api"

ブラウザーでの OAuth の代わりにトークンを使うには、次のようにします。

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/linkedin-posts-api" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

その後、claude mcp list で確認するか、セッション内で /mcp を実行します。Claude Code に LinkedIn Posts API の呼び出しを依頼します。

Claude Code を無料でお試しください：https://claude.ai/referral/uIlpa7nPLg Claude Code MCP のドキュメント：https://code.claude.com/docs/en/mcp

---

Claude（ウェブサイト）にインストールする

claude.ai では、Apify をコネクターとして追加してから、この Actor のツールのみを有効にします。

1. Settings → Connectors → Browse connectors に移動し、Apify MCP server を検索します。インストールします（プロンプトが表示された場合は、有効化または更新します）。
2. 接続時に Apify API トークンで認証し、ツール johnvc/linkedin-posts-api を有効にします。
3. 任意のチャットで + → Connectors を開き、Apify をオンにします。
4. または、Add custom connector を選択して、MCP URL 全体 https://mcp.apify.com/?tools=actors,docs,johnvc/linkedin-posts-api を貼り付け、プロンプトが表示されたら OAuth を使用します。
5. Claude に LinkedIn Posts API の実行を依頼します。

ウェブで Claude を開く：https://claude.ai/referral/uIlpa7nPLg

---

Cursor にインストールする

Cursor は、プロジェクトファイル .cursor/mcp.json から MCP サーバーを読み込みます。

1. プロジェクト内に .cursor/mcp.json を作成します。

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/linkedin-posts-api"
    }
  }
}

2. ブラウザーでの OAuth の代わりにトークン認証を使う場合は、ヘッダーを追加します。

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/linkedin-posts-api",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. Cursor → Settings → MCP を開き、apify サーバーが接続されていること（緑色の点）を確認します。
4. Composer または Chat で、Cursor に LinkedIn Posts API の呼び出しを依頼します。

Cursor を初めて使いますか？こちらから入手してください：https://cursor.com/referral?code=XQP4VBLI3NNX

---

ChatGPT にインストールする

ChatGPT は Developer mode を通じて Apify MCP サーバーに接続します（ChatGPT Pro、Plus、Business、Enterprise、Education プランで利用できます）。

1. プロフィールアイコンをクリックし、Settings > Apps に移動します。Create app ボタンが表示されない場合は、Advanced settings を開いて Developer mode を有効にします。
2. Create app をクリックし、フォームに入力します。
   • Name: Apify
   • MCP Server URL: https://mcp.apify.com/?tools=actors,docs,johnvc/linkedin-posts-api
   • Authentication: OAuth
3. Create をクリックし、Apify との接続を認証します。
4. 会話でアプリを使用するには、チャットの + をクリックし、Developer mode を選択して、Apify を選びます。

詳しくは、https://docs.apify.com/platform/integrations/mcp をご覧ください。

---

心を込めて作成

LinkedIn Posts API を使って、信頼性の高い構造化された結果を活用し、コンテンツ調査、ソーシャルリスニング、エンゲージメント分析を行いましょう。

🤖 この Actor について AI アシスタントに質問する

LinkedIn Posts API に関する、すぐに送信できるプロンプトをお好みの AI で開きます。

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

最終更新日：2026.10.27