Pearch

официальный

Лучший поисковик людей, сокращающий время на поиск талантов.

GitHub

Попробовать этот MCPСпонсировано

Что можно делать с Pearch MCP?

Поиск людей по естественному языку — Запрашивайте кандидатов, например, «senior React разработчиков в Берлине», и search_people возвращает подходящие профили с контактными данными и инсайтами.
Поиск компаний и лидов — Используйте search_company_leads для обнаружения B2B-потенциальных клиентов, например, «AI-стартапы в Сан-Франциско с 50–200 сотрудниками», а также контактов, таких как CTO, с опциональными черновиками исходящих сообщений.
Обогащение одного профиля — Укажите slug LinkedIn или email для get_profile, чтобы получить контакты, обновление в реальном времени и обогащение через GitHub.
Проверка статуса аккаунта — Вызовите get_user_info, чтобы увидеть вашу электронную почту, оставшиеся кредиты и текущий тарифный план.

Документация

MCP-сервер Pearch.ai

MCP-сервер для Pearch.AI: поиск по людям и компаниям/лидам (B2B) на естественном языке. Используйте его из Claude, Cursor, VS Code или любого MCP-совместимого клиента.

Оценка инструментов AI-рекрутинга по предпочтениям людей

Инструменты

Инструмент	Описание
search_people	Поиск людей на естественном языке (например, "инженеры-программисты в Калифорнии с опытом Python 5+ лет"). Поддерживает быстрые/про/супербыстрые типы поиска, раскрытие контактов и фильтры контактов, обновление профилей в реальном времени, аналитику, а также пагинацию и уточняющие запросы на основе потока обсуждения.
search_company_leads	Поиск компаний и лидов/контактов внутри них (B2B). Пример: компания "AI-стартапы в Сан-Франциско, 50–200 сотрудников" + лиды "CTO и инженерные менеджеры", с возможностью персонализированных сообщений для аутрича.
get_profile	Поиск и обогащение данных одного человека по LinkedIn-слагу или email (раскрытие контактов, обновление в реальном времени, обогащение через GitHub).
get_user_info	Информация об аутентифицированном пользователе: email, оставшиеся кредиты, тарифный план. Бесплатно.

Пользовательские структурированные фильтры (custom_filters / search_requirements) намеренно не предоставляются — описывайте всё в запросе на естественном языке.

Удалённый сервер (рекомендуется)

Размещённый сервер находится по адресу https://mcp.pearch.ai/mcp и поддерживает две схемы аутентификации одновременно:

OAuth (без управления ключами)

Добавьте сервер без каких-либо заголовков — клиенты с поддержкой OAuth (Claude, Cursor, VS Code) автоматически обнаружат процесс и откроют вход через Google. Войдите с помощью учётной записи Google, email которой совпадает с вашей учётной записью Pearch:

claude mcp add --transport http pearch https://mcp.pearch.ai/mcp

Ваши поиски списывают кредиты с вашей собственной учётной записи Pearch. Если в вашей учётной записи Pearch ещё нет API-ключа, сначала создайте его в панели управления Pearch.ai.

API-ключ

Передайте тот же API-ключ Pearch в качестве 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, аудитория токена и URI перенаправления `/auth/callback` выводятся из него.
`PEARCH_MCP_GOOGLE_CLIENT_ID` / `PEARCH_MCP_GOOGLE_CLIENT_SECRET`	—	Веб-клиент Google OAuth 2.0 (зарегистрируйте `<base_url>/auth/callback` как URI перенаправления). Требуется в режиме `oauth`.
`PEARCH_MCP_INTERNAL_TOKEN`	—	Общий секрет для внутренней конечной точки сопоставления email→API-ключ Pearch 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`, —	Подключение к Redis для хранилища OAuth.
`PEARCH_MCP_ALLOWED_CLIENT_REDIRECT_URIS`	встроенный список	Разделённые запятыми шаблоны fnmatch для URI перенаправления MCP-клиентов (`*` = любой).
`PEARCH_MCP_TOKEN_CACHE_TTL_S`	`300`	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.