HeroHunt.ai MCP (People Search API)

herohunt-mcp

HeroHunt People Search API 用の MCP サーバーです。MCP 対応の AI エージェントから、LinkedIn、GitHub、StackOverflow 全体で人材を検索できます。

クイックスタート

方法 1：リモート URL（推奨）

Claude Desktop、Cursor、およびほとんどの最新 MCP クライアントは、リモート HTTP エンドポイントを直接サポートしています。パッケージをインストールする必要はありません。

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "herohunt-people-search": {
      "url": "https://api.herohunt.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "herohunt-people-search": {
      "url": "https://api.herohunt.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

方法 2：stdio（npx 経由）

stdio トランスポートのみをサポートする MCP クライアントの場合：

{
  "mcpServers": {
    "herohunt-people-search": {
      "command": "npx",
      "args": ["-y", "herohunt-mcp"],
      "env": {
        "HEROHUNT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

API キーを取得する

herohunt.ai/app/api/sign-up で登録すると、API キーを取得できます。

ツール

ツール	種類	説明
people_search	書き込み	自然言語で人物プロフィールを検索します。予約済みスロット 1 件につき 1 クレジットです。
people_search_paginate	読み取り	既存の検索結果をさらに取得します。エンリッチメントが有効でない限り無料です。
account_usage_get	読み取り	プラン、クレジット、レート制限情報を取得します。無料です。
account_searches_list	読み取り	過去の検索を一覧表示します。無料です。
account_upgrade_link	読み取り	プランのアップグレード URL を取得します。無料です。
account_billing_portal_link	読み取り	Stripe の請求ポータル URL を取得します。無料です。
api_keys_list	読み取り	API キーのプレフィックスとスコープを一覧表示します。無料です。
api_keys_create	書き込み	新しい API キーを作成します。
api_keys_rotate	書き込み	既存の API キーをローテーションします。
api_keys_revoke	書き込み	API キーを永久に無効化します。

例

接続後、AI エージェントに次のように依頼します。

「HeroHunt を使って、ベルリンにいるシニア Go エンジニアを 5 人探し、上位 3 人を要約してください。」

エージェントは自然言語のクエリで people_search を呼び出し、構造化されたプロフィールデータ（名前、役職、会社、所在地、スキル、プラットフォームへのリンク）を受け取って、結果を要約します。

連絡先情報を取得するには、次のように依頼します。

「結果にメールアドレスと電話番号を追加してください。」

エージェントは enrich: true を指定して people_search_paginate を呼び出します。

環境変数

変数	必須	デフォルト	説明
HEROHUNT_API_KEY	はい	-	People Search API キー
HEROHUNT_MCP_URL	いいえ	https://api.herohunt.ai/api/v1/mcp	MCP エンドポイント URL を上書きします

リンク

• API ドキュメント
• 登録
• ダッシュボード

ライセンス

MIT