Linkedin Browser MCP Server

🚀 LinkedIn ブラウザ MCP サーバー

このサーバーは FastMCP をベースに構築されており、ブラウザ自動化を利用して LinkedIn の自動化とデータ抽出を行います。LinkedIn のサービス条項とレート制限を尊重しながら、LinkedIn とのプログラムによる対話を可能にする一連のツールを提供します。

✨ 主な機能

安全認証

• 環境は資格情報管理に基づいています。
• 暗号化されたクッキーを保存することで、セッションを持続させます。
• レート制限を回避するための保護機能があります。
• 自動的にセッションを復元します。

プロフィール操作

• プロフィール情報を表示し、抽出することができます。
• キーワードに基づいてプロフィールを検索します。
• LinkedIn のフィードを閲覧します。
• プロフィール機能にアクセスします。

投稿インタラクション

• 投稿にいいねをすることができます。
• 投稿にコメントを残すことができます。
• 投稿内容とエンゲージメント指標を閲覧します。

📦 インストール

前提条件

• Python 3.8 以上
• Playwright
• FastMCP ライブラリ
• LinkedIn アカウント

インストール手順

1. リポジトリをクローンします：

git clone [リポジトリのURL]
cd mcp-linkedin-server

2. 仮想環境を作成し、アクティブ化します：

python -m venv env
source env/bin/activate  # Windowsの場合：env\Scripts\activate

3. 依存関係をインストールします：

pip install -r requirements.txt
playwright install chromium

4. 環境変数を設定します： ルートディレクトリに .env ファイルを作成し、以下の内容を記述します。

LINKEDIN_USERNAME=your_email@example.com
LINKEDIN_PASSWORD=your_password
COOKIE_ENCRYPTION_KEY=your_encryption_key  # オプション：指定しない場合は自動生成されます

💻 使用例

基本的な使用法

1. MCP サーバーを起動します：

python linkedin_browser_mcp.py

2. 利用可能なツール：

• login_linkedin_secure：環境変数に設定された資格情報を使用して安全にログインします。
• browse_linkedin_feed：フィード内の投稿を閲覧し、抽出します。
• search_linkedin_profiles：指定された条件に合致するプロフィールを検索します。
• view_linkedin_profile：特定のプロフィールのデータを表示し、抽出します。
• interact_with_linkedin_post：投稿にいいねをしたり、コメントを残したり、内容を閲覧します。

コード例

from fastmcp import FastMCP

# クライアントを初期化します
client = FastMCP.connect("http://localhost:8000")

# ログインします
result = await client.login_linkedin_secure()
print(result)

# プロフィールを検索します
profiles = await client.search_linkedin_profiles(
    query="software engineer",
    count=5
)
print(profiles)

# プロフィールを表示します
profile_data = await client.view_linkedin_profile(
    profile_url="https://www.linkedin.com/in/username"
)
print(profile_data)

🔧 技術詳細

セキュリティ機能

• クッキーを暗号化して保存します。
• レート制限を回避するための保護機能があります。
• 資格情報を安全に管理します。
• セッションを持続させます。
• ブラウザ自動化に関するセキュリティ対策が施されています。

ベストプラクティス

1. レート制限の回避：サーバーは過度のリクエストを防止する機能を実装しています。
   • 1時間あたり最大5回のログイン試行
   • 自動的にセッションを再利用する
   • クッキーを持続させることでログイン回数を減らす
2. エラー処理：以下の問題に対する包括的なエラー処理が行われます。
   • ネットワーク問題
   • 認証失敗
   • LinkedIn のセキュリティチャレンジ
   • 無効な URL またはパラメータ
3. セッション管理：
   • クッキーを自動的に暗号化します。
   • セッションを持続させます。
   • 安全な保存方法を採用しています。

🤝 貢献ガイド

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. プルリクエストを作成します。

📄 ライセンス

MIT

⚠️ 重要提示

このツールは教育目的のみで使用されることを意図しています。このソフトウェアを使用する際には、LinkedIn のサービス条項とレート制限ガイドラインに準拠していることを確認してください。