Pearch

공식

인재 발굴에 소요되는 시간을 줄여주는 최고의 인물 검색 엔진입니다.

GitHub

이 MCP 사용해 보기스폰서

Pearch MCP(으)로 무엇을 할 수 있나요?

자연어로 사람 검색 — "베를린의 시니어 React 개발자" 같은 후보를 요청하면 search_people이 연락처 정보와 인사이트가 포함된 일치하는 프로필을 반환합니다.
회사 및 리드 찾기 — search_company_leads를 사용하여 "직원 50-200명 규모의 SF 소재 AI 스타트업" 같은 B2B 잠재 고객과 CTO 등 연락처를 발견하고, 선택적으로 아웃리치 메시지 초안도 제공합니다.
단일 프로필 보강 — get_profile에 LinkedIn 슬러그 또는 이메일을 제공하면 연락처 공개, 실시간 업데이트, GitHub 보강이 이루어집니다.
계정 상태 확인 — get_user_info를 호출하여 이메일, 남은 크레딧, 현재 요금제를 확인하세요.

문서

Pearch.ai MCP

Pearch.AI용 MCP 서버: 사람 및 회사/리드(B2B)에 대한 자연어 검색. Claude, Cursor, VS Code 또는 MCP 호환 클라이언트에서 사용하세요.

인간 선호도에 따른 AI 채용 소싱 도구 평가

도구

도구	설명
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에 있으며 두 가지 인증 방식을 동시에 지원합니다:

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 메타데이터, 토큰 대상(audience), `/auth/callback` 리다이렉트 URI가 모두 여기에서 파생됩니다.
`PEARCH_MCP_GOOGLE_CLIENT_ID` / `PEARCH_MCP_GOOGLE_CLIENT_SECRET`	—	Google OAuth 2.0 웹 애플리케이션 클라이언트(`<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`	검증된 신원 캐시 TTL; 또한 폐기 지연 시간.
`PEARCH_API_URL`	`https://api.pearch.ai`	Pearch API 기본 URL(호출별 `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 — 데이터 수집, 사용, 저장, 제3자 공유, 보존 및 연락처 정보를 다룹니다. 데이터 삭제/옵트아웃: https://pearch.ai/opt-out. 서비스 약관: https://pearch.ai/tos.

지원

라이선스

MIT — LICENSE 참조.