Pearch

Pearch.ai MCP

Servidor MCP para Pearch.AI: busca em linguagem natural sobre pessoas e empresas/leads (B2B). Use-o a partir do Claude, Cursor, VS Code ou qualquer cliente compatível com MCP.

Avaliando Ferramentas de Sourcing de Recrutamento com IA por Preferência Humana

Ferramentas

Ferramenta	Descrição
search_people	Busca de pessoas em linguagem natural (ex.: "engenheiros de software na Califórnia com mais de 5 anos de Python"). Suporta tipos de busca rápida/pro/super-rápida, revelação de contatos e filtros de contato, atualização de perfil em tempo real, insights e paginação/acompanhamentos baseados em threads.
search_company_leads	Encontre empresas e leads/contatos dentro delas (B2B). Exemplo: empresa "startups de IA em SF, 50–200 funcionários" + leads "CTOs e gerentes de engenharia", com mensagens opcionais de abordagem personalizadas.
get_profile	Consulte e enriqueça uma única pessoa por slug do LinkedIn ou e-mail (revelação de contato, atualização em tempo real, enriquecimento via GitHub).
get_user_info	Informações do usuário autenticado: e-mail, créditos restantes, plano de preços. Gratuito.

Filtros estruturados personalizados (custom_filters / search_requirements) não são expostos intencionalmente — descreva tudo na consulta em linguagem natural.

Servidor remoto (recomendado)

O servidor hospedado está em https://mcp.pearch.ai/mcp e suporta dois esquemas de autenticação ao mesmo tempo:

OAuth (sem gerenciamento de chaves)

Adicione o servidor sem nenhum cabeçalho — clientes compatíveis com OAuth (Claude, Cursor, VS Code) descobrem o fluxo automaticamente e abrem um login do Google. Entre com a conta do Google cujo e-mail corresponde à sua conta Pearch:

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

Suas buscas debitam créditos da sua própria conta Pearch. Se sua conta Pearch ainda não tiver uma chave de API, crie uma primeiro no Painel Pearch.ai.

Chave de API

Passe a mesma chave de API Pearch como api.pearch.ai:

{
  "mcpServers": {
    "Pearch.ai": {
      "url": "https://mcp.pearch.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:PEARCH_API_KEY}"
      }
    }
  }
}

Use test_mcp_key para resultados mascarados (amostra) — sem necessidade de cadastro.

Instalação local (stdio)

Requer Python 3.10+ e pip install -r requirements.txt (ou pip install fastmcp).

Claude Desktop / Claude Code

fastmcp install claude-desktop pearch_mcp.py --env PEARCH_API_KEY=test_mcp_key

Ou manualmente em 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

Substitua test_mcp_key pela sua chave do painel para obter resultados completos.

Executando seu próprio servidor HTTP

uvicorn pearch_mcp:app --host 0.0.0.0 --port 8000

Saúde: GET /health ou /healthcheck (informa o modo de autenticação).

Variáveis de ambiente

Variável	Padrão	Finalidade
PEARCH_MCP_AUTH	api_key	oauth | api_key | none. No modo oauth, portadores de chave de API bruta ainda são aceitos (autenticação dupla).
PEARCH_MCP_BASE_URL	http://localhost:8000	URL pública deste servidor. Os metadados OAuth, o público do token e o URI de redirecionamento /auth/callback derivam dela.
PEARCH_MCP_GOOGLE_CLIENT_ID / PEARCH_MCP_GOOGLE_CLIENT_SECRET	—	Cliente Web do Google OAuth 2.0 (registre <base_url>/auth/callback como URI de redirecionamento). Necessário no modo oauth.
PEARCH_MCP_INTERNAL_TOKEN	—	Segredo compartilhado para o endpoint interno de mapeamento e-mail→chave de API da Pearch. Necessário no modo oauth.
PEARCH_MCP_OAUTH_STORE	disk	redis mantém o estado OAuth (registros de clientes, tokens — criptografados) no Redis para sobreviver a reinicializações e permitir mais de 1 réplica.
PEARCH_MCP_OAUTH_REDIS_HOST / REDIS_ENDPOINT, REDIS_PORT, PEARCH_MCP_OAUTH_REDIS_DB, REDIS_PASSWORD	—, 6379, 4, —	Conexão Redis para o armazenamento OAuth.
PEARCH_MCP_ALLOWED_CLIENT_REDIRECT_URIS	lista embutida	Padrões fnmatch separados por vírgula para URIs de redirecionamento de clientes MCP (* = qualquer).
PEARCH_MCP_TOKEN_CACHE_TTL_S	300	TTL do cache de identidade verificada; também o atraso de revogação.
PEARCH_API_URL	https://api.pearch.ai	Base da API Pearch (substituições por chamada via base_url).
PEARCH_API_KEY	test_mcp_key	Chave de fallback para uso stdio/local.
MCP_DISABLE_AUTH	—	1 é equivalente a PEARCH_MCP_AUTH=none (apenas desenvolvimento local).

No modo oauth, o proxy de entrada/reverso deve rotear o host inteiro para o servidor, não apenas /mcp: o fluxo adiciona /.well-known/oauth-*, /authorize, /token, /register, /revoke, /consent e /auth/callback.

Desenvolvimento

export PEARCH_API_KEY='test_mcp_key'   # or your key for full results
fastmcp dev inspector pearch_mcp.py

Política de Privacidade

Política de privacidade da Pearch.AI: https://pearch.ai/privacy-policy — cobre coleta de dados, uso, armazenamento, compartilhamento com terceiros, retenção e informações de contato. Exclusão de dados / opt-out: https://pearch.ai/opt-out. Termos de serviço: https://pearch.ai/tos.

Suporte

• Abra uma issue
• f@pearch.ai

Licença

MIT — veja LICENSE.