O que herohunt-mcp faz?
Servidor MCP para a API de Pesquisa de Pessoas HeroHunt. Busque talentos no LinkedIn, GitHub e StackOverflow a partir de qualquer agente de IA compatível com MCP.
Início Rápido
Opção 1: URL Remota (recomendada)
Claude Desktop, Cursor e a maioria dos clientes MCP modernos suportam endpoints HTTP remotos diretamente. Nenhuma instalação de pacote necessária.
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"herohunt-people-search": {
"url": "https://api.herohunt.ai/api/v1/mcp",
"headers": {
"Authorization": "Bearer SUA_CHAVE_DE_API"
}
}
}
}
Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"herohunt-people-search": {
"url": "https://api.herohunt.ai/api/v1/mcp",
"headers": {
"Authorization": "Bearer SUA_CHAVE_DE_API"
}
}
}
}
Opção 2: stdio (via npx)
Para clientes MCP que suportam apenas transporte stdio:
{
"mcpServers": {
"herohunt-people-search": {
"command": "npx",
"args": ["-y", "herohunt-mcp"],
"env": {
"HEROHUNT_API_KEY": "SUA_CHAVE_DE_API"
}
}
}
}
Obtenha Sua Chave de API
Cadastre-se em herohunt.ai/app/api/sign-up para obter sua chave de API.
Ferramentas
| Ferramenta | Tipo | Descrição |
|---|---|---|
people_search | Escrita | Pesquisar perfis de pessoas usando linguagem natural. 1 crédito por slot reservado. |
people_search_paginate | Leitura | Obter mais resultados de uma pesquisa existente. Grátis, a menos que o enriquecimento esteja ativado. |
account_usage_get | Leitura | Obter informações sobre plano, créditos e limite de taxa. Grátis. |
account_searches_list | Leitura | Listar pesquisas anteriores. Grátis. |
account_upgrade_link | Leitura | Obter URL de upgrade de plano. Grátis. |
account_billing_portal_link | Leitura | Obter URL do portal de cobrança do Stripe. Grátis. |
api_keys_list | Leitura | Listar prefixos e escopos das chaves de API. Grátis. |
api_keys_create | Escrita | Criar uma nova chave de API. |
api_keys_rotate | Escrita | Rotacionar uma chave de API existente. |
api_keys_revoke | Escrita | Revogar permanentemente uma chave de API. |
Exemplo
Após conectar, pergunte ao seu agente de IA:
"Use o HeroHunt para me encontrar 5 engenheiros seniors em Go em Berlim e resuma os 3 melhores."
O agente chamará people_search com uma consulta em linguagem natural, receberá dados estruturados do perfil (nome, cargo, empresa, localização, habilidades, links de plataformas) e resumirá os resultados.
Para obter informações de contato, pergunte:
"Enriqueça os resultados com e-mails e números de telefone."
O agente chamará people_search_paginate com enrich: true.
Variáveis de Ambiente
| Variável | Obrigatório | Padrão | Descrição |
|---|---|---|---|
HEROHUNT_API_KEY | Sim | - | Sua chave da API de Pesquisa de Pessoas |
HEROHUNT_MCP_URL | Não | https://api.herohunt.ai/api/v1/mcp | Substituir a URL do endpoint MCP |
Links
Licença
MIT