Pearch

Pearch.ai MCP

Pearch.AI 向けの MCP サーバー: 人物と企業/リード（B2B）を対象とした自然言語検索を提供します。Claude、Cursor、VS Code、または MCP 互換の任意のクライアントから利用できます。

Evaluating AI Recruitment Sourcing Tools by Human Preference

ツール

ツール	説明
search_people	自然言語の query または構造化された search_requirements による人物検索。fast/pro/superfast の検索タイプ、連絡先の開示と連絡先フィルター、リアルタイムのプロフィール更新、インサイト、スレッドベースのページネーション/フォローアップをサポートします。
search_company_leads	企業とその中のリード/連絡先を検索します（B2B）。例: 企業 "AI startups in SF, 50–200 employees" + リード "CTOs and engineering managers"、任意でパーソナライズされたアウトリーチメッセージを付けられます。
get_profile	LinkedIn スラッグまたはメールアドレスで単一の人物を検索・エンリッチします（連絡先の開示、リアルタイム更新、GitHub エンリッチメント）。
get_user_info	認証済みユーザー情報: メールアドレス、残りクレジット、料金プラン。無料。

構造化された人物検索

すでに条件のリストがある場合は、search_requirements を search_people に渡します:

{
  "search_requirements": [
    {
      "search_requirement": "Software engineer with 5+ years of Python experience",
      "must_have": true
    },
    {
      "search_requirement": "Experience at a fintech company",
      "must_have": false
    }
  ],
  "search_type": "fast",
  "limit": 10,
  "insights": true,
  "reveal_emails": true
}

• search_requirement: 必須、空でないテキスト。各条件は短く、自己完結するようにしてください。
• must_have: 必須条件には true、あれば望ましい条件には false（デフォルト）。

リストには少なくとも 1 つの要件を含める必要があります。search_requirements を使用する場合、query は任意です。両方が指定された場合、API は search_requirements を優先します。詳細は Pearch search API contract を参照してください。

どちらの入力も同じ検索オプションをサポートします: 検索タイプ、インサイトとスコアリング、プロフィール更新、連絡先の開示とフィルター、厳格なフィルタリング、低信頼度の結果、時間予算、ページネーション、レスポンスフィールド、プロフィールの除外、無料のマスク済み結果。検索タイプの制限はどちらの入力でも同じです。たとえば、superfast はインサイト、プロフィールスコアリング、高い鮮度をサポートしません。

ページネーションでは、返された thread_id を limit とともに送信し、任意で offset を付け、query と search_requirements は省略します。条件を変更する場合は、thread_id を付けずに新しい検索を開始してください。既存の query 呼び出しとスレッドのフォローアップはこれまでどおり転送されます。どのフォローアップパラメータを受け入れるかは API が判断します。

custom_filters はこの MCP サーバーでは公開されていません。代わりに条件を query または 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 Dashboard で作成してください。

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 キー Bearer も引き続き受け入れられます（デュアル認証）。
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	—	内部のメール→API キーマッピングとリクエストソース署名用の共有シークレット。oauth モード、および API キーによる検証済み MCP アトリビューションに必須です。バックエンドの MCP_INTERNAL_TOKEN と一致する必要があり、エンドユーザーには決して配布しないでください。
PEARCH_MCP_OAUTH_STORE	disk	redis は OAuth 状態（クライアント登録、トークン — 暗号化済み）を Redis に保持するため、再起動後も維持され、複数レプリカが可能になります。
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 と同等です（ローカル開発専用）。

Pearch API へのツールリクエストは、POST と GET の両方の呼び出しで X-Pearch-Source: mcp を含みます。これには人物検索、企業リード検索、ページネーション、プロフィールエンリッチメントが含まれます。ホスト型サーバーは、内部シークレットが設定され、宛先オリジンが PEARCH_API_URL と一致する場合に X-Pearch-Source-Signature も送信します。HMAC は Bearer 資格情報、メソッド、デコードされたパスと生のクエリ、ボディ、タイムスタンプをバインドします。バックエンドは 300 秒以内の署名を受け入れるため、サーバーの時計を同期させる必要があります。他のオリジンで呼び出し元が指定した base_url の値には署名が付与されません。

バックエンドは検証済みの MCP トラフィックを分析および DevAdmin 履歴のために api_calls.request_source として記録します。ソースヘッダーだけでは不十分です。API キーを使用する署名なしのセルフホスト MCP トラフィックは api のままです。認証済みで許可リストに登録された OAuth クライアントはヘッダーなしで認識されます。バックエンドのソースログを有効にする前に、データベースマイグレーションを適用したうえで署名をデプロイしてください。古いバックエンドはヘッダーを無視します。認証、アカウントのアトリビューション、課金は変更されません。

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.

サポート

• Open an issue
• f@pearch.ai

ライセンス

MIT — LICENSE を参照してください。