HDW MCP サーバー

HorizonDataWave API を使用して LinkedIn のデータと機能への包括的なアクセスを提供し、データの取得だけでなくユーザー アカウントの堅牢な管理も可能にするモデル コンテキスト プロトコル (MCP) サーバーです。

特徴

• **LinkedIn ユーザー検索:**キーワード、名前、役職、会社、場所、業種、学歴で LinkedIn ユーザーをフィルタリングして検索します。
• プロフィール検索: LinkedIn ユーザーの詳細なプロフィール情報を取得します。
• **メール検索:**メールアドレスで LinkedIn ユーザーの詳細を検索します。
• **投稿と反応:**ユーザーの投稿と関連する反応を取得します。
• **投稿の再投稿とコメント:**特定の LinkedIn 投稿の再投稿とコメントを取得します。
• アカウント管理:
  • チャット機能: LinkedIn 管理 API を介してチャット メッセージを取得および送信します。
  • 接続管理: LinkedIn ユーザーに接続の招待を送信します。
  • 投稿コメント: LinkedIn の投稿または返信にコメントを作成します。
  • **ユーザー接続:**ユーザーの LinkedIn 接続のリストを取得します。
• 企業検索と詳細:
  • Google 企業検索: Google 検索を使用して LinkedIn 企業を検索します。通常、最初の結果が最も一致します。
  • 企業検索: LinkedIn 企業に関する詳細情報を取得します。
  • **会社の従業員:**指定された LinkedIn 会社の従業員を取得します。
• Google検索

ツール

HDW MCPサーバーは、MCPプロトコルを通じて複数のツールを公開します。各ツールは、名前、説明、および入力パラメータで定義されます。

1. LinkedInユーザーを検索
   名前: search_linkedin_users
   **説明:**さまざまなフィルターを使用して LinkedIn ユーザーを検索します。
   パラメータ:
   • keywords （オプション）：検索用の任意のキーワード。
   • first_name 、 last_name 、 title 、 company_keywords 、 school_keywords （オプション）。
   • current_company 、 past_company 、 location 、 industry 、 education （オプション）。
   • count (オプション、デフォルト: 10): 結果の最大数 (最大 1000)。
   • timeout （オプション、デフォルト：300）：タイムアウト（秒数）（20～1500）。
2. LinkedInプロフィールを取得
   名前: get_linkedin_profile
   説明: LinkedIn ユーザーの詳細なプロフィール情報を取得します。
   パラメータ:
   • user (必須): ユーザーエイリアス、URL、または URN。
   • with_experience 、 with_education 、 with_skills （オプション、デフォルト：true）。
3. LinkedInのメールユーザーを取得
   名前: get_linkedin_email_user
   説明: LinkedIn ユーザーの詳細を電子メールで検索します。
   パラメータ:
   • email (必須): メールアドレス。
   • count (オプション、デフォルト: 5)。
   • timeout （オプション、デフォルト：300）。
4. LinkedInユーザーの投稿を取得する
   名前: get_linkedin_user_posts
   説明: URN によって LinkedIn ユーザーの投稿を取得します。
   パラメータ:
   • urn (必須): ユーザー URN (プレフィックスを含める必要があります。例: fsd_profile:... )。
   • count (オプション、デフォルト: 10)。
   • timeout （オプション、デフォルト：300）。
5. LinkedInユーザーの反応を取得する
   名前: get_linkedin_user_reactions
   説明: URN によって LinkedIn ユーザーの反応を取得します。
   パラメータ:
   • urn （必須）。
   • count (オプション、デフォルト: 10)。
   • timeout （オプション、デフォルト：300）。
6. LinkedInチャットメッセージを取得する
   名前: get_linkedin_chat_messages
   説明: LinkedIn 管理 API から上位のチャット メッセージを取得します。
   パラメータ:
   • user (必須): ユーザー URN (プレフィックス付き)。
   • count (オプション、デフォルト: 20)。
   • timeout （オプション、デフォルト：300）。
7. LinkedInチャットメッセージを送信
   名前: send_linkedin_chat_message
   説明: LinkedIn 管理 API を使用してチャット メッセージを送信します。
   パラメータ:
   • user (必須): 受信者のユーザー URN (プレフィックス付き)。
   • text (必須): メッセージテキスト。
   • timeout （オプション、デフォルト：300）。
8. LinkedIn 接続リクエストを送信する
   名前: send_linkedin_connection
   説明: LinkedIn ユーザーに接続招待を送信します。
   パラメータ:
   • user （必須）。
   • timeout （オプション、デフォルト：300）。
9. LinkedInの投稿コメントを送信
   名前: send_linkedin_post_comment
   説明: LinkedIn の投稿または返信にコメントを作成します。
   パラメータ:
   • text (必須): コメントテキスト。
   • urn (必須): アクティビティまたはコメントの URN。
   • timeout （オプション、デフォルト：300）。
10. LinkedInユーザーのつながりを取得する
    名前: get_linkedin_user_connections
    説明: LinkedIn ユーザー接続のリストを取得します。
    パラメータ:

• connected_after (オプション): タイムスタンプ フィルター。
• count (オプション、デフォルト: 20)。
• timeout （オプション、デフォルト：300）。

11. LinkedInの投稿リポストを取得する
    名前: get_linkedin_post_reposts
    説明: LinkedIn 投稿の再投稿を取得します。
    パラメータ:

• urn (必須): 投稿 URN ( activity:で始まる必要があります)。
• count (オプション、デフォルト: 10)。
• timeout （オプション、デフォルト：300）。

12. LinkedInの投稿コメントを取得する
    名前: get_linkedin_post_comments
    説明: LinkedIn の投稿に対するコメントを取得します。
    パラメータ:

• urn （必須）。
• sort (オプション、デフォルト: "relevance" 、許可される値: "relevance" 、 "recent" )。
• count (オプション、デフォルト: 10)。
• timeout （オプション、デフォルト：300）。

13. LinkedIn Google Company を取得
    名前: get_linkedin_google_company
    説明: Google 経由で LinkedIn 企業を検索します。通常、最初の結果が最も一致します。
    パラメータ:

• keywords （必須）：会社のキーワードの配列。
• with_urn (オプション、デフォルト: false)。
• count_per_keyword （オプション、デフォルト：1、範囲：1～10）。
• timeout （オプション、デフォルト：300）。

14. LinkedInの会社情報
    名前: get_linkedin_company
    説明: LinkedIn 企業に関する詳細情報を取得します。
    パラメータ:

• company (必須): 会社のエイリアス、URL、または URN。
• timeout （オプション、デフォルト：300）。

15. LinkedInの従業員情報を取得する
    名前: get_linkedin_company_employees
    説明: LinkedIn 企業の従業員を取得します。
    パラメータ:

• companies (必須): 会社の URN の配列。
• keywords 、 first_name 、 last_name （オプション）。
• count (オプション、デフォルト: 10)。
• timeout （オプション、デフォルト：300）。

セットアップガイド

1. リポジトリのクローンを作成する (macOS)

ターミナルを開き、次のコマンドを実行します。

2. API認証情報を取得する

app.horizondatawave.aiに登録して、APIキーと100クレジットを無料で取得してください。HDW_ACCESS_TOKENとHDW_ACCOUNT_ID が付与されます。

3. 環境を構成する

プロジェクトのルートに次の内容の.envファイルを作成します。

4. クライアントの設定

4.1 クロードデスクトップ

Claude 構成ファイル ( claude_desktop_config.json ) を次の内容で更新します。

構成ファイルの場所:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

4.2 カーソル

簡単な方法:
カーソル設定を開き、次のコマンドで新しい MCP サーバーを追加します。

安全な方法:
提供されているテンプレートrun.template.sh新しいファイル (例: run.sh ) にコピーし、資格情報で更新して、Cursor を実行するように構成します。

4.3 ウィンドサーフィン

Windsurf 構成ファイル ( mcp_config.json ) を次の内容で更新します。

**注:**設定後、API クレジットを節約するために公式 Web ツールを無効にすることができます。

MCPクライアントの構成例

以下は、MCP クライアント (カスタム統合など) の構成例です。

パスと資格情報を独自の値に置き換えます。

ライセンス

このプロジェクトはMIT ライセンスに基づいてライセンスされています。