Pearch
公式最高の人物検索エンジンで、人材発見にかかる時間を短縮します。
Pearch MCPで何ができますか?
- 自然言語で人を検索 — 「ベルリンのシニアReact開発者」などの候補を尋ねると、
search_peopleが連絡先情報やインサイトを含む一致するプロフィールを返します。 - 企業とリードを見つける —
search_company_leadsを使用してB2Bの見込み客を発見します。例:「従業員50〜200人のサンフランシスコのAIスタートアップ」に加え、CTOなどの連絡先や、任意のアウトリーチメッセージの下書きも取得できます。 - 単一のプロフィールを補完 — LinkedInのスラッグまたはメールアドレスを
get_profileに提供すると、連絡先の表示、リアルタイム更新、GitHubの補完が行われます。 - アカウントステータスを確認 —
get_user_infoを呼び出すと、メールアドレス、残りクレジット、現在の料金プランを確認できます。
ドキュメント
Pearch.ai MCP
Pearch.AI 用のMCPサーバー: 人および企業/リード(B2B)に対する自然言語検索。Claude、Cursor、VS Code、またはMCP互換クライアントから使用できます。
ツール
| ツール | 説明 |
|---|---|
| search_people | 自然言語による人材検索(例: 「カリフォルニア在住でPython歴5年以上のソフトウェアエンジニア」)。fast/pro/superfast検索タイプ、連絡先公開・連絡先フィルター、リアルタイムプロフィール更新、インサイト、スレッドベースのページネーション/フォローアップをサポート。 |
| search_company_leads | 企業およびその中のリード/連絡先を検索(B2B)。例: 企業 「サンフランシスコのAIスタートアップ、従業員50〜200人」 + リード 「CTOおよびエンジニアリングマネージャー」、オプションでパーソナライズされたアウトリーチメッセージ付き。 |
| get_profile | LinkedInスラッグまたはメールアドレスで個人を検索・エンリッチ(連絡先公開、リアルタイム更新、GitHubエンリッチメント)。 |
| get_user_info | 認証済みユーザー情報: メールアドレス、残りクレジット、料金プラン。無料。 |
カスタム構造化フィルター(custom_filters / search_requirements)は意図的に公開していません — すべて自然言語クエリで記述してください。
リモートサーバー(推奨)
ホスト型サーバーは https://mcp.pearch.ai/mcp にあり、2つの認証方式を同時にサポートしています:
OAuth(キー管理不要)
ヘッダーなしでサーバーを追加 — OAuth対応クライアント(Claude、Cursor、VS Code)はフローを自動的に検出し、Googleサインインを開きます。Pearchアカウントのメールアドレスと一致するGoogleアカウントでサインインしてください:
claude mcp add --transport http pearch https://mcp.pearch.ai/mcp
検索は自分のPearchアカウントのクレジットに請求されます。PearchアカウントにAPIキーがまだない場合は、先にPearch.aiダッシュボードで作成してください。
APIキー
同じPearch APIキーを api.pearch.ai として渡します:
{
"mcpServers": {
"Pearch.ai": {
"url": "https://mcp.pearch.ai/mcp",
"headers": {
"Authorization": "Bearer ${env:PEARCH_API_KEY}"
}
}
}
}
test_mcp_key をマスク(サンプル)結果に使用 — サインアップ不要です。
ローカル(stdio)インストール
Python 3.10+ と pip install -r requirements.txt(または pip install fastmcp)が必要です。
Claude Desktop / Claude Code
fastmcp install claude-desktop pearch_mcp.py --env PEARCH_API_KEY=test_mcp_key
または mcpServers の下で手動で:
"Pearch.ai": {
"command": "python",
"args": ["/path/to/mcp_pearch/pearch_mcp.py"],
"env": { "PEARCH_API_KEY": "test_mcp_key" }
}
Cursor
fastmcp install cursor pearch_mcp.py --env PEARCH_API_KEY=test_mcp_key
完全な結果を得るには、test_mcp_key をダッシュボードのキーに置き換えてください。
独自のHTTPサーバーを実行する
uvicorn pearch_mcp:app --host 0.0.0.0 --port 8000
ヘルスチェック: GET /health または /healthcheck(認証モードを報告)。
環境変数
| 変数 | デフォルト | 目的 |
|---|---|---|
PEARCH_MCP_AUTH | api_key | oauth | api_key | none。oauth モードでは、生のAPIキーベアラーも引き続き受け入れられます(デュアル認証)。 |
PEARCH_MCP_BASE_URL | http://localhost:8000 | このサーバーの公開URL。OAuthメタデータ、トークンオーディエンス、/auth/callback リダイレクトURIはすべてここから派生します。 |
PEARCH_MCP_GOOGLE_CLIENT_ID / PEARCH_MCP_GOOGLE_CLIENT_SECRET | — | Google OAuth 2.0 Webアプリケーションクライアント(<base_url>/auth/callback をリダイレクトURIとして登録)。oauth モードで必須。 |
PEARCH_MCP_INTERNAL_TOKEN | — | Pearch APIの内部メール→APIキーマッピングエンドポイント用の共有シークレット。oauth モードで必須。 |
PEARCH_MCP_OAUTH_STORE | disk | redis はOAuth状態(クライアント登録、トークン — 暗号化)をRedisに保持し、再起動後も存続し、1レプリカ以上を許可します。 |
PEARCH_MCP_OAUTH_REDIS_HOST / REDIS_ENDPOINT, REDIS_PORT, PEARCH_MCP_OAUTH_REDIS_DB, REDIS_PASSWORD | —、6379、4、— | OAuthストア用のRedis接続。 |
PEARCH_MCP_ALLOWED_CLIENT_REDIRECT_URIS | 組み込みリスト | MCPクライアントのリダイレクトURI用のカンマ区切りfnmatchパターン(* = 任意)。 |
PEARCH_MCP_TOKEN_CACHE_TTL_S | 300 | 検証済みIDキャッシュのTTL。失効ラグでもあります。 |
PEARCH_API_URL | https://api.pearch.ai | Pearch APIベース(呼び出しごとの base_url で上書き)。 |
PEARCH_API_KEY | test_mcp_key | stdio/ローカル使用時のフォールバックキー。 |
MCP_DISABLE_AUTH | — | 1 は PEARCH_MCP_AUTH=none と同等です(ローカル開発のみ)。 |
oauth モードでは、イングレス/リバースプロキシは /mcp だけでなくホスト全体をサーバーにルーティングする必要があります: フローは /.well-known/oauth-*、/authorize、/token、/register、/revoke、/consent、/auth/callback を追加します。
開発
export PEARCH_API_KEY='test_mcp_key' # or your key for full results
fastmcp dev inspector pearch_mcp.py
プライバシーポリシー
Pearch.AIのプライバシーポリシー: https://pearch.ai/privacy-policy — データ収集、使用、保存、第三者共有、保持、連絡先情報をカバー。データ削除/オプトアウト: https://pearch.ai/opt-out. 利用規約: https://pearch.ai/tos.
サポート
ライセンス
MIT — LICENSE を参照。