LinkedIn Company Admin MCP

linkedin-company-admin-mcp

言語： 英語 - ルーマニア語

LinkedIn 企業ページを管理する MCP サーバーです。 分析データの確認、投稿の管理、ページ詳細の編集、フォロワーの増加、従業員による情報発信ワークフロー向けの個人プロフィール連携ができます。

stickerdaniel/linkedin-mcp-server を補完するプロジェクトです。 Stickerdaniel のプロジェクトは、フィード、メッセージ、検索など、個人での LinkedIn 利用を対象としています。このプロジェクトは、他のどのプロジェクトもカバーしていない領域を補います。LinkedIn 企業ページを全面的に管理する機能に加え、従業員による情報発信のワークフローでのみ使用する、個人プロフィール連携用の小規模なツール群を提供します。

⚠️ 利用規約とアカウントのリスク。 LinkedIn の利用規約では、プラットフォームへの自動アクセスが禁止されています。このサーバーはユーザーに代わって実際のブラウザーセッションを操作するため、LinkedIn に検知されたり、レート制限を受けたり、アカウントを永久に制限されたりする可能性があります。企業ページへのアクセスを失う場合もあります。ご自身の責任でご利用ください。 失うわけにはいかない個人用または業務用アカウントでは使用しないでください。制限されたアカウントを作者が復旧する方法はありません。利用資格がある場合は、LinkedIn のコミュニティ管理 APIの利用を推奨します。

🔐 セキュリティに関する注意 — セッションディレクトリは認証情報と同等です。 「認証情報を保存しない」とは、このサーバーがパスワードを尋ねたり、設定ファイルに保存したりしないという意味です。プロフィールディレクトリを安全に共有できるという意味ではありません。ログイン後、~/.linkedin-company-admin/profile には LinkedIn のセッションクッキーが保存されます。これらは実質的に、パスワードと 2 要素認証を組み合わせたものと同等です。このディレクトリを読み取れる人は、アカウントと企業ページの管理者権限を完全に取得できます。特に、このディレクトリを OneDrive／iCloud／Dropbox などのクラウドバックアップと同期しないでください。 信頼できるマシンのローカルディスクにのみ保存してください。

このプロジェクトの目的

LinkedIn の公式コミュニティ管理 API は招待制です。個人プロフィールのスクレイピングには、すでに十分なツールがあります。一方で不足していたのは、ページ管理者（またはそのアシスタント LLM）が、分析データの確認、投稿の下書き、概要セクションの編集、フォロワーへの招待、個人投稿からのページのタグ付けを行える、安定したブラウザーファーストの MCP です。保存されたパスワードにアクセスすることなく、これらすべてを実行できます。

主な機能

• 24 個の MCP ツールを 6 カテゴリーに分けて提供します。詳しくは下記のツールリファレンスをご覧ください。
• ディスク上に認証情報は一切保存されません。表示される Chromium ウィンドウで対話形式のログインを行い、セッションは永続的なプロフィールディレクトリに保存されます（Unix では chmod 0o700）。
• Patchright によるステルス Chromium（Playwright の検知回避フォーク）。
• AdminProvider と PostsProvider によるプロバイダーの抽象化により、将来的にコミュニティ管理 API のバックエンドを、ツールを書き換えることなく組み込めます。
• レート制限を実際に適用しています（インポートするだけではありません）。書き込みを行うすべてのツールに、保守的な時間単位の上限を設けています。
• aria-label／role／innerText セレクターのみを使用し、難読化された CSS クラスのハッシュは使いません。LinkedIn の UI が更新された場合、変更が必要なのは selectors/__init__.py だけです。
• 巨大な単一ファイルはありません（ファイルあたり約 300 LOC を上限としています）。mypy による型チェックと ruff によるリントを実施しています。

インストール

オプション 1：uvx（推奨）

PyPI で linkedin-company-admin-mcp として公開されています。

uvx linkedin-company-admin-mcp@latest --login

次に、Claude Desktop の設定ファイル（~/.config/Claude/claude_desktop_config.json または各プラットフォームに対応するファイル）に追加します。

{
  "mcpServers": {
    "linkedin-company-admin": {
      "command": "uvx",
      "args": ["linkedin-company-admin-mcp@latest"]
    }
  }
}

オプション 2：ローカル開発

git clone https://github.com/negrueu/linkedin-company-admin-mcp.git
cd linkedin-company-admin-mcp
uv sync
uv run linkedin-company-admin-mcp --login

オプション 3：Docker

docker build -t linkedin-company-admin-mcp .
docker run --rm -it \
  -v linkedin_profile:/home/mcp/.linkedin-company-admin \
  linkedin-company-admin-mcp --login

初回ログイン

このサーバーに認証情報が保存されることはありません。 ログインは対話形式で行います。

uvx linkedin-company-admin-mcp --login

Chromium のウィンドウが表示されます。通常どおり LinkedIn にサインインしてください（2FA を含む）。永続ブラウザプロファイルは ~/.linkedin-company-admin/profile に保存されます（Unix では chmod 0o700）。以降の MCP 呼び出しでは、このセッションが自動的に再利用されます。

ログアウトするには、uvx linkedin-company-admin-mcp --logout を実行します（プロファイルディレクトリが消去されます）。

ツールリファレンス

引数の全一覧と使用例は docs/TOOL_REFERENCE.md にあります。概要：

セッション（3）

ツール	用途
session_status	永続プロファイルが稼働し、ログイン済みか確認します。
session_warmup	ブラウザーと /feed/ を事前に開き、初回呼び出しの待ち時間を短縮します。
session_logout	ブラウザーを閉じ、プロファイルディレクトリを消去します。

会社情報の読み取り（6）

ツール	用途
company_read_page	名前、タグライン、フォロワー数、概要、業種、ウェブサイトを取得します。
company_list_posts	URN、本文、リアクション、コメントを含む最近の投稿を取得します。
company_list_followers	フォロワー一覧を取得します（管理者のみ。ページネーション対応）。
company_list_mentions	ページに言及した投稿を取得します（管理者向け通知）。
company_manage_admins	管理者とそのロールを一覧表示します。
company_analytics	7 日、28 日、90 日の期間におけるフォロワー数／投稿の指標を取得します。

会社管理者による書き込み（3）

ツール	用途
company_edit_about	概要セクションを更新します（タグラインへのフォールバックあり）。
company_edit_logo	新しいロゴをアップロードします（任意でバナーも指定できます）。
company_update_details	ウェブサイト、業種、規模、専門分野を更新します。

会社コンテンツ（6）

ツール	用途
company_create_post	テキスト投稿を公開します（任意でリンク／画像を指定できます）。
company_edit_post	既存の投稿本文を置き換えます。
company_delete_post	完全に削除します。詳しくは docs/RCA_DELETE_POST.md を参照してください。
company_schedule_post	ISO-8601 形式の日時に投稿を公開するよう予約します。
company_reply_comment	自社の投稿へのコメントに、ページとして返信します。
company_reshare_post	別の投稿をページで再共有します。任意でコメントを追加できます。

会社の成長（2）

ツール	用途
company_invite_to_follow	1 次のつながりにフォロー招待を送信します（LinkedIn の上限は月 250 件です）。
company_list_scheduled	今後公開予定の投稿一覧を取得します。

個人プロフィールと会社ページの連携（4）

ツール	用途
personal_tag_company	ページに @-メンションする個人投稿を公開します。
personal_reshare_company_post	個人プロフィールでページの投稿を再共有します。
personal_comment_as_admin	ページの投稿に、ページとして（または自分として）コメントします。
personal_read_company_mentions	最近のアクティビティを確認し、ページをタグ付けした投稿を探します。

セキュリティモデル

• メールアドレス／パスワードは扱いません。 認証情報がこのコードに渡ることはありません。
• セッション状態は、OS ユーザーごとに分離された、リポジトリ外の永続ブラウザプロファイルディレクトリに保存されます。
• .env には設定（ログレベル、トランスポート、ツールのタイムアウト）のみが含まれます。シークレットは含まれません。
• 初回ログイン時に、プロファイルディレクトリの権限が chmod で 0o700 に設定されます（Unix）。
• レート制限はツールごとに適用されます。上限は意図的に保守的に設定されており、LinkedIn が許可している範囲ではなく、実際に許容している範囲に合わせて調整されています。

対応ワークフロー

• Claude から会社ページの投稿を作成、レビュー、公開します。
• 個人の投稿からページにタグ付けし、コミュニティの反応を追跡します。
• 今週、ページについて投稿したユーザーを監査します（管理者へのメンション）。
• 1次のつながりにあるユーザーをまとめてページのフォローに招待し、LinkedIn の月間上限に達した時点で停止します。
• ローンチ前に、予約投稿に対して一連の CRUD 操作を実行します。

エンドツーエンドの例については、docs/TOOL_REFERENCE.md をご覧ください。

トラブルシューティング

セレクターの不整合、CAPTCHA、レート制限、Cookie の有効期限切れ、Chromium の起動に関する問題については、docs/TROUBLESHOOTING.md で説明しています。

貢献

貢献を歓迎します。ローカル環境のセットアップ、テストの構成、新しいツールを追加するワークフローについては、docs/CONTRIBUTING.md をご覧ください。

ステータス

現在、積極的に開発中です。バージョン履歴については CHANGELOG.md、今後のロードマップについては issues をご覧ください。

ライセンス

MIT