Harmonic Search

Pesquise por empresas e profissionais usando a API do Harmonic.ai.

GitHub
2

Documentação

Servidor MCP Harmonic

Um servidor Model Context Protocol (MCP) que fornece acesso à API da Harmonic.ai para busca de empresas e pessoas/profissionais.

Recursos

  • Buscar empresas no banco de dados da Harmonic
  • Obter informações detalhadas da empresa por domínio
  • Buscar pessoas/profissionais
  • Obter informações detalhadas de uma pessoa por ID
  • Pacote autônomo com todas as dependências incluídas

Compilação

Instale as dependências:

npm install

Compile o servidor:

npm run build

Isso cria um pacote autônomo em dist/standalone/ com todas as dependências incluídas.

Uso com Claude Desktop

  1. Obtenha sua chave de API da Harmonic em https://console.harmonic.ai/docs/dashboard

  2. Adicione o servidor à sua configuração do Claude Desktop:

Edite ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "harmonic": {
      "command": "node",
      "args": ["/absolute/path/to/HarmonicMCPServer/dist/standalone/index.js"]
    }
  }
}

Importante:

  • Substitua /absolute/path/to/HarmonicMCPServer pelo caminho real do seu projeto
  • Use o caminho completo para o node (encontre-o com which node)
  • Certifique-se de que o caminho não tenha espaços ou caracteres especiais

  1. Reinicie o Claude Desktop

  2. No Claude, primeiro defina sua chave de API:

Use the harmonic_set_api_key tool with your API key
  1. Agora você pode usar as ferramentas da Harmonic:
  • harmonic_search_company_by_domain - Buscar uma empresa pelo domínio do seu site
  • harmonic_search_companies - Buscar empresas por consulta
  • harmonic_search_people - Buscar pessoas/profissionais
  • harmonic_get_saved_search_results - Obter resultados de uma busca salva
  • harmonic_get_company_employees - Obter todos os funcionários ativos de uma empresa

Ferramentas Disponíveis

harmonic_set_api_key

Defina sua chave de API da Harmonic para autenticação.

Parâmetros:

  • api_key (obrigatório): Sua chave de API da Harmonic

harmonic_search_company_by_domain

Buscar uma empresa pelo domínio do seu site usando o método POST.

Parâmetros:

  • domain (obrigatório): O domínio do site da empresa (ex.: harmonic.ai)

harmonic_search_companies

Buscar empresas por consulta usando o método GET.

Parâmetros:

  • query (obrigatório): Consulta de busca para empresas
  • size (opcional): Número de resultados a retornar (padrão: 50)
  • cursor (opcional): Cursor para paginação

harmonic_search_people

Buscar pessoas/profissionais usando o método GET.

Parâmetros:

  • query (obrigatório): Consulta de busca para pessoas
  • size (opcional): Número de resultados a retornar (padrão: 50)
  • cursor (opcional): Cursor para paginação

harmonic_get_saved_search_results

Obter resultados de uma busca salva.

Parâmetros:

  • search_id (obrigatório): O ID da busca salva
  • size (opcional): Número de resultados a retornar (padrão: 50)
  • cursor (opcional): Cursor para paginação

harmonic_get_company_employees

Obter todos os funcionários ativos de uma empresa.

Parâmetros:

  • company_id (obrigatório): O ID da empresa
  • size (opcional): Número de resultados a retornar (padrão: 50)
  • cursor (opcional): Cursor para paginação

Desenvolvimento

Execute em modo de desenvolvimento:

npm run dev

Documentação da API

Para mais informações sobre a API da Harmonic, visite: https://console.harmonic.ai/docs/api-reference/introduction