Servidor HDW MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso integral a los datos y funcionalidades de LinkedIn mediante la API HorizonDataWave, lo que permite no solo la recuperación de datos sino también una gestión sólida de las cuentas de usuario.

Características

Búsqueda de usuarios de LinkedIn: filtre y busque usuarios de LinkedIn por palabras clave, nombre, cargo, empresa, ubicación, industria y educación.
Búsqueda de perfil: recupere información detallada del perfil de un usuario de LinkedIn.
Búsqueda de correo electrónico: encuentre detalles de usuarios de LinkedIn por dirección de correo electrónico.
Publicaciones y reacciones: recupera las publicaciones de un usuario y las reacciones asociadas.
Publicaciones repetidas y comentarios: recupera publicaciones repetidas y comentarios para una publicación específica de LinkedIn.
Gestión de cuentas:
- Funcionalidad de chat: recupere y envíe mensajes de chat a través de la API de administración de LinkedIn.
- Gestión de conexiones: envía invitaciones de conexión a usuarios de LinkedIn.
- Comentarios en publicaciones: crea comentarios en publicaciones o respuestas de LinkedIn.
- Conexiones de usuario: recupera una lista de las conexiones de LinkedIn de un usuario.
Búsqueda y detalles de la empresa:
- Búsqueda de empresas de Google: busque empresas de LinkedIn mediante la búsqueda de Google: el primer resultado suele ser la mejor coincidencia.
- Búsqueda de empresa: recupere información detallada sobre una empresa de LinkedIn.
- Empleados de la empresa: recupera empleados de una empresa determinada de LinkedIn.
Búsqueda de Google

Herramientas

El servidor HDW MCP expone varias herramientas mediante el protocolo MCP. Cada herramienta se define con su nombre, descripción y parámetros de entrada:

Buscar usuarios de LinkedIn
Nombre: search_linkedin_users
Descripción: Busca usuarios de LinkedIn con varios filtros.
Parámetros:
- keywords (opcional): Cualquier palabra clave para la búsqueda.
- first_name , last_name , title , company_keywords , school_keywords (opcional).
- current_company , past_company , location , industry , education (opcional).
- count (opcional, predeterminado: 10): Número máximo de resultados (máximo 1000).
- timeout (opcional, predeterminado: 300): tiempo de espera en segundos (20–1500).
Obtener perfil de LinkedIn
Nombre: get_linkedin_profile
Descripción: Recupere información detallada del perfil de un usuario de LinkedIn.
Parámetros:
- user (obligatorio): alias de usuario, URL o URN.
- with_experience , with_education , with_skills (opcional, predeterminado: verdadero).
Obtener usuario de correo electrónico de LinkedIn
Nombre: get_linkedin_email_user
Descripción: Busque detalles de usuarios de LinkedIn por correo electrónico.
Parámetros:
- email (obligatorio): Dirección de correo electrónico.
- count (opcional, predeterminado: 5).
- timeout (opcional, predeterminado: 300).
Obtener publicaciones de usuarios de LinkedIn
Nombre: get_linkedin_user_posts
Descripción: Recupera publicaciones de un usuario de LinkedIn por URN.
Parámetros:
- urn (obligatorio): URN de usuario (debe incluir prefijo, p. ej. fsd_profile:... ).
- count (opcional, predeterminado: 10).
- timeout (opcional, predeterminado: 300).
Obtenga reacciones de los usuarios de LinkedIn
Nombre: get_linkedin_user_reactions
Descripción: Recupera reacciones de un usuario de LinkedIn por URN.
Parámetros:
- urn (requerido).
- count (opcional, predeterminado: 10).
- timeout (opcional, predeterminado: 300).
Recibir mensajes de chat de LinkedIn
Nombre: get_linkedin_chat_messages
Descripción: Recupere los principales mensajes de chat de la API de administración de LinkedIn.
Parámetros:
- user (obligatorio): URN de usuario (con prefijo).
- count (opcional, predeterminado: 20).
- timeout (opcional, predeterminado: 300).
Enviar mensaje de chat de LinkedIn
Nombre: send_linkedin_chat_message
Descripción: Envíe un mensaje de chat utilizando la API de administración de LinkedIn.
Parámetros:
- user (obligatorio): URN del usuario destinatario (con prefijo).
- text (obligatorio): Texto del mensaje.
- timeout (opcional, predeterminado: 300).
Enviar solicitud de conexión de LinkedIn
Nombre: send_linkedin_connection
Descripción: Envía una invitación de conexión a un usuario de LinkedIn.
Parámetros:
- user (requerido).
- timeout (opcional, predeterminado: 300).
Enviar comentario de publicación de LinkedIn
Nombre: send_linkedin_post_comment
Descripción: Crea un comentario en una publicación o respuesta de LinkedIn.
Parámetros:
- text (obligatorio): Texto del comentario.
- urn (obligatorio): URN de actividad o comentario.
- timeout (opcional, predeterminado: 300).
Obtener conexiones de usuarios de LinkedIn
Nombre: get_linkedin_user_connections
Descripción: Recupere una lista de conexiones de usuarios de LinkedIn.
Parámetros:

connected_after (opcional): filtro de marca de tiempo.
count (opcional, predeterminado: 20).
timeout (opcional, predeterminado: 300).

Conseguir republicaciones de publicaciones de LinkedIn
Nombre: get_linkedin_post_reposts
Descripción: Recupera publicaciones repetidas de una publicación de LinkedIn.
Parámetros:

urn (obligatorio): Publicar URN (debe comenzar con activity: ).
count (opcional, predeterminado: 10).
timeout (opcional, predeterminado: 300).

Obtener comentarios de publicaciones de LinkedIn
Nombre: get_linkedin_post_comments
Descripción: Recuperar comentarios de una publicación de LinkedIn.
Parámetros:

urn (requerido).
sort (opcional, predeterminado: "relevance" ; valores permitidos: "relevance" , "recent" ).
count (opcional, predeterminado: 10).
timeout (opcional, predeterminado: 300).

Obtener LinkedIn Google Empresa
Nombre: get_linkedin_google_company
Descripción: Busque empresas de LinkedIn a través de Google: el primer resultado suele ser la mejor coincidencia.
Parámetros:

keywords (obligatorio): Matriz de palabras clave de la empresa.
with_urn (opcional, predeterminado: falso).
count_per_keyword (opcional, predeterminado: 1; rango 1–10).
timeout (opcional, predeterminado: 300).

Obtener LinkedIn de la empresa
Nombre: get_linkedin_company
Descripción: Recupere información detallada sobre una empresa de LinkedIn.
Parámetros:

company (obligatorio): alias de la empresa, URL o URN.
timeout (opcional, predeterminado: 300).

Conseguir empleados de la empresa en LinkedIn
Nombre: get_linkedin_company_employees
Descripción: Recuperar empleados de una empresa de LinkedIn.
Parámetros:

companies (obligatorio): Matriz de URN de empresas.
keywords , first_name , last_name (opcional).
count (opcional, predeterminado: 10).
timeout (opcional, predeterminado: 300).

Guía de configuración

1. Clonar el repositorio (macOS)

Abra su terminal y ejecute los siguientes comandos:

# Clone the repository
git clone https://github.com/horizondatawave/hdw-mcp-server.git

# Change directory to the project folder
cd hdw-mcp-server

# Install dependencies
npm install

2. Obtenga sus credenciales de API

Regístrate en app.horizondatawave.ai para obtener tu clave API y 100 créditos gratis. Recibirás tu HDW_ACCESS_TOKEN y HDW_ACCOUNT_ID .

3. Configurar el entorno

Crea un archivo .env en la raíz de tu proyecto con el siguiente contenido:

HDW_ACCESS_TOKEN=YOUR_HD_W_ACCESS_TOKEN
HDW_ACCOUNT_ID=YOUR_HD_W_ACCOUNT_ID

4. Configuración del cliente

4.1 Escritorio de Claude

Actualice su archivo de configuración de Claude ( claude_desktop_config.json ) con el siguiente contenido:

{
  "mcpServers": {
    "hdw": {
      "command": "npx",
      "args": ["@horizondatawave/mcp"],
      "env": {
        "HDW_ACCESS_TOKEN": "YOUR_HD_W_ACCESS_TOKEN",
        "HDW_ACCOUNT_ID": "YOUR_HD_W_ACCOUNT_ID"
      }
    }
  }
}

Ubicación del archivo de configuración:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Ventanas: %APPDATA%\Claude\claude_desktop_config.json

4.2 Cursor

Manera fácil:
Abra Configuración del cursor y agregue un nuevo servidor MCP con el comando:

env HDW_ACCESS_TOKEN=your-access-token HDW_ACCOUNT_ID=your-account-id node /path/to/your/build/index.js

Manera segura:
Copie la plantilla proporcionada run.template.sh en un nuevo archivo (por ejemplo, run.sh ), actualícelo con sus credenciales y configure Cursor para que se ejecute:

sh /path/to/your/run.sh

4.3 Windsurf

Actualice su archivo de configuración de Windsurf ( mcp_config.json ) con el siguiente contenido:

{
  "mcpServers": {
    "hdw": {
      "command": "node",
      "args": ["/path/to/your/build/index.js"],
      "env": {
        "HDW_ACCESS_TOKEN": "YOUR_HD_W_ACCESS_TOKEN",
        "HDW_ACCOUNT_ID": "YOUR_HD_W_ACCOUNT_ID"
      }
    }
  }
}

Nota: Después de la configuración, puede deshabilitar las herramientas web oficiales para conservar sus créditos API.

Ejemplo de configuración del cliente MCP

A continuación se muestra un ejemplo de configuración para un cliente MCP (por ejemplo, una integración personalizada):

{
  "mcpServers": {
    "hdw": {
      "command": "npx",
      "args": ["@horizondatawave/mcp"],
      "env": {
        "HDW_ACCESS_TOKEN": "YOUR_HD_W_ACCESS_TOKEN",
        "HDW_ACCOUNT_ID": "YOUR_HD_W_ACCOUNT_ID"
      }
    }
  }
}

Reemplace las rutas y credenciales con sus propios valores.

Licencia

Este proyecto está licenciado bajo la licencia MIT .

HDW MCP Server

Integrations