Harmonic Search

Busca empresas y profesionales utilizando la API de Harmonic.ai.

GitHub
2

Documentación

Servidor MCP Harmonic

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a la API de Harmonic.ai para buscar empresas y personas/profesionales.

Características

  • Buscar empresas en la base de datos de Harmonic
  • Obtener información detallada de una empresa por dominio
  • Buscar personas/profesionales
  • Obtener información detallada de una persona por ID
  • Paquete independiente con todas las dependencias incluidas

Compilación

Instalar dependencias:

npm install

Compilar el servidor:

npm run build

Esto crea un paquete independiente en dist/standalone/ con todas las dependencias incluidas.

Uso con Claude Desktop

  1. Obtén tu clave de API de Harmonic desde https://console.harmonic.ai/docs/dashboard

  2. Agrega el servidor a tu configuración de Claude Desktop:

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

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

Importante:

  • Reemplaza /absolute/path/to/HarmonicMCPServer con la ruta real a tu proyecto
  • Usa la ruta completa a node (encuéntrala con which node)
  • Asegúrate de que la ruta no tenga espacios ni caracteres especiales

  1. Reinicia Claude Desktop

  2. En Claude, primero establece tu clave de API:

Use the harmonic_set_api_key tool with your API key
  1. Ahora puedes usar las herramientas de Harmonic:
  • harmonic_search_company_by_domain - Buscar una empresa por su dominio web
  • harmonic_search_companies - Buscar empresas por consulta
  • harmonic_search_people - Buscar personas/profesionales
  • harmonic_get_saved_search_results - Obtener resultados de una búsqueda guardada
  • harmonic_get_company_employees - Obtener todos los empleados activos de una empresa

Herramientas Disponibles

harmonic_set_api_key

Establece tu clave de API de Harmonic para autenticación.

Parámetros:

  • api_key (obligatorio): Tu clave de API de Harmonic

harmonic_search_company_by_domain

Busca una empresa por su dominio web usando el método POST.

Parámetros:

  • domain (obligatorio): El dominio web de la empresa (ej., harmonic.ai)

harmonic_search_companies

Busca empresas por consulta usando el método GET.

Parámetros:

  • query (obligatorio): Consulta de búsqueda para empresas
  • size (opcional): Número de resultados a devolver (predeterminado: 50)
  • cursor (opcional): Cursor para paginación

harmonic_search_people

Busca personas/profesionales usando el método GET.

Parámetros:

  • query (obligatorio): Consulta de búsqueda para personas
  • size (opcional): Número de resultados a devolver (predeterminado: 50)
  • cursor (opcional): Cursor para paginación

harmonic_get_saved_search_results

Obtiene resultados de una búsqueda guardada.

Parámetros:

  • search_id (obligatorio): El ID de la búsqueda guardada
  • size (opcional): Número de resultados a devolver (predeterminado: 50)
  • cursor (opcional): Cursor para paginación

harmonic_get_company_employees

Obtiene todos los empleados activos de una empresa.

Parámetros:

  • company_id (obligatorio): El ID de la empresa
  • size (opcional): Número de resultados a devolver (predeterminado: 50)
  • cursor (opcional): Cursor para paginación

Desarrollo

Ejecutar en modo de desarrollo:

npm run dev

Documentación de la API

Para más información sobre la API de Harmonic, visita: https://console.harmonic.ai/docs/api-reference/introduction