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 | Write | 自然言語で人材プロフィールを検索します。確保されたスロット1つにつき1クレジット消費。 |
people_search_paginate | Read | 既存の検索結果をさらに取得します。エンリッチメントがオフの場合は無料。 |
account_usage_get | Read | プラン、クレジット、レート制限情報を取得します。無料。 |
account_searches_list | Read | 過去の検索一覧を表示します。無料。 |
account_upgrade_link | Read | プランアップグレード用 URL を取得します。無料。 |
account_billing_portal_link | Read | Stripe 請求ポータル URL を取得します。無料。 |
api_keys_list | Read | API キーのプレフィックスとスコープを一覧表示します。無料。 |
api_keys_create | Write | 新しい API キーを作成します。 |
api_keys_rotate | Write | 既存の API キーをローテーションします。 |
api_keys_revoke | Write | API キーを完全に無効化します。 |
使用例
接続後、AI エージェントに次のように依頼します:
「HeroHunt を使って、ベルリン在住のシニア Go エンジニアを5人見つけて、上位3人の要約を作成して。」
エージェントは自然言語クエリで people_search を呼び出し、構造化されたプロフィールデータ（名前、役職、会社、場所、スキル、プラットフォームリンク）を受け取り、結果を要約します。
連絡先情報を取得するには、次のように依頼します:
「結果にメールアドレスと電話番号を追加して。」
エージェントは people_search_paginate を enrich: true で呼び出します。
環境変数
| 変数 | 必須 | デフォルト値 | 説明 |
|---|---|---|---|
HEROHUNT_API_KEY | はい | - | People Search API キー |
HEROHUNT_MCP_URL | いいえ | https://api.herohunt.ai/api/v1/mcp | MCP エンドポイント URL の上書き |
リンク
ライセンス
MIT