People Data Labs

Accede a datos de personas, empresas, escuelas, ubicaciones, cargos y habilidades mediante la API de People Data Labs.

Documentación

Servidor MCP de People Data Labs

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que envuelve la API de People Data Labs. Proporciona acceso integral a los diversos modelos de datos y capacidades de búsqueda de People Data Labs.

People Data Labs Server MCP server

Características

API de Personas

  • Enriquecimiento de Personas: Enriquece el perfil de una persona con datos adicionales
  • Búsqueda de Personas: Busca personas que coincidan con criterios específicos usando consultas similares a SQL
  • Enriquecimiento Masivo de Personas: Enriquece múltiples perfiles de personas en una sola solicitud

API de Empresas

  • Enriquecimiento de Empresas: Enriquece el perfil de una empresa con datos adicionales
  • Búsqueda de Empresas: Busca empresas que coincidan con criterios específicos

Modelos de Datos Adicionales

  • Búsqueda de Escuelas: Busca escuelas que coincidan con criterios específicos
  • Búsqueda de Ubicaciones: Busca ubicaciones que coincidan con criterios específicos
  • Búsqueda de Títulos de Puesto: Busca títulos de puesto que coincidan con criterios específicos
  • Búsqueda de Habilidades: Busca habilidades que coincidan con criterios específicos

Utilidades

  • Autocompletar: Obtén sugerencias de autocompletado para varios campos

Instalación

  1. Clona este repositorio
  2. Instala las dependencias:
    npm install
    
  3. Compila el proyecto:
    npm run build
    
  4. Configura tu clave de API de People Data Labs usando uno de los scripts de configuración proporcionados

Configuración

Configuración Automática

Este proyecto incluye scripts para configurar automáticamente el servidor MCP tanto para Claude Desktop como para VS Code:

Para Claude Desktop:

npm run config:claude

Para VS Code:

npm run config:vscode

Ambos scripts harán lo siguiente:

  1. Verificar si el archivo de configuración existe y crearlo si es necesario
  2. Solicitar tu clave de API de People Data Labs
  3. Agregar la configuración del servidor MCP al archivo correspondiente
  4. Proporcionar instrucciones para los siguientes pasos

Configuración Manual

Si prefieres configurar el servidor MCP manualmente, debes agregarlo a tu archivo de configuración de MCP. La ubicación de este archivo depende de tu entorno:

  • Para VS Code: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json
  • Para Claude Desktop: %APPDATA%\Claude\claude_desktop_config.json

Agrega la siguiente configuración al objeto mcpServers en tu archivo de configuración de MCP:

{
  "mcpServers": {
    "peopledatalabs": {
      "command": "node",
      "args": ["path/to/peopledatalabs-mcp/build/index.js"],
      "env": {
        "PDL_API_KEY": "your-api-key-here"
      }
    }
  }
}

Reemplaza:

  • path/to/peopledatalabs-mcp/build/index.js con la ruta real al archivo index.js compilado
  • your-api-key-here con tu clave de API real de People Data Labs

Herramientas Disponibles

Herramientas de la API de Personas

enrich_person

Enriquece un perfil de persona con datos adicionales de People Data Labs.

Parámetros:

  • email (cadena, opcional): Dirección de correo electrónico de la persona
  • phone (cadena, opcional): Número de teléfono de la persona
  • name (cadena, opcional): Nombre completo de la persona
  • profile (arreglo de cadenas, opcional): URLs de perfiles de redes sociales de la persona
  • location (cadena, opcional): Ubicación de la persona (ciudad, estado, país)
  • company (cadena, opcional): Nombre de la empresa donde trabaja la persona
  • title (cadena, opcional): Título del puesto de la persona
  • min_likelihood (número, opcional): Puntuación mínima de probabilidad (0-1) para la coincidencia

Nota: Al menos uno de email, phone, name o profile debe ser proporcionado.

search_people

Busca personas que coincidan con criterios específicos usando consultas similares a SQL.

Parámetros:

  • query (cadena, obligatorio): Consulta similar a SQL para buscar personas
  • size (número, opcional): Número de resultados a devolver (máx. 100)

bulk_person_enrich

Enriquece múltiples perfiles de personas en una sola solicitud.

Parámetros:

  • requests (arreglo, obligatorio): Arreglo de solicitudes de enriquecimiento de personas

Herramientas de la API de Empresas

enrich_company

Enriquece un perfil de empresa con datos adicionales.

Parámetros:

  • name (cadena, opcional): Nombre de la empresa
  • website (cadena, opcional): Sitio web de la empresa
  • profile (arreglo de cadenas, opcional): URLs de perfiles de redes sociales de la empresa
  • ticker (cadena, opcional): Símbolo bursátil de la empresa

Nota: Al menos uno de name, website, profile o ticker debe ser proporcionado.

search_companies

Busca empresas que coincidan con criterios específicos.

Parámetros:

  • query (cadena, obligatorio): Consulta similar a SQL para buscar empresas
  • size (número, opcional): Número de resultados a devolver (máx. 100)

Herramientas de la API de Escuelas

search_schools

Busca escuelas que coincidan con criterios específicos.

Parámetros:

  • query (cadena, obligatorio): Consulta similar a SQL para buscar escuelas
  • size (número, opcional): Número de resultados a devolver (máx. 100)

Herramientas de la API de Ubicaciones

search_locations

Busca ubicaciones que coincidan con criterios específicos.

Parámetros:

  • query (cadena, obligatorio): Consulta similar a SQL para buscar ubicaciones
  • size (número, opcional): Número de resultados a devolver (máx. 100)

Herramientas de la API de Títulos de Puesto

search_job_titles

Busca títulos de puesto que coincidan con criterios específicos.

Parámetros:

  • query (cadena, obligatorio): Consulta similar a SQL para buscar títulos de puesto
  • size (número, opcional): Número de resultados a devolver (máx. 100)

Herramientas de la API de Habilidades

search_skills

Busca habilidades que coincidan con criterios específicos.

Parámetros:

  • query (cadena, obligatorio): Consulta similar a SQL para buscar habilidades
  • size (número, opcional): Número de resultados a devolver (máx. 100)

Herramientas de Utilidad

autocomplete

Obtén sugerencias de autocompletado para una consulta parcial.

Parámetros:

  • field (cadena, obligatorio): Campo para autocompletar (empresa, escuela, título, habilidad, ubicación)
  • text (cadena, obligatorio): Texto parcial para autocompletar
  • size (número, opcional): Número de resultados a devolver (máx. 100)

Ejemplos de Uso

Ejemplos de la API de Personas

<use_mcp_tool>
<server_name>peopledatalabs</server_name>
<tool_name>enrich_person</tool_name>
<arguments>
{
  "email": "john.smith@example.com"
}
</arguments>
</use_mcp_tool>
<use_mcp_tool>
<server_name>peopledatalabs</server_name>
<tool_name>search_people</tool_name>
<arguments>
{
  "query": "SELECT * FROM person WHERE location='San Francisco' AND job_title='Software Engineer'",
  "size": 5
}
</arguments>
</use_mcp_tool>

Ejemplos de la API de Empresas

<use_mcp_tool>
<server_name>peopledatalabs</server_name>
<tool_name>enrich_company</tool_name>
<arguments>
{
  "name": "Apple Inc."
}
</arguments>
</use_mcp_tool>
<use_mcp_tool>
<server_name>peopledatalabs</server_name>
<tool_name>search_companies</tool_name>
<arguments>
{
  "query": "SELECT * FROM company WHERE location='New York' AND industry='Finance'",
  "size": 5
}
</arguments>
</use_mcp_tool>

Ejemplo de Autocompletado

<use_mcp_tool>
<server_name>peopledatalabs</server_name>
<tool_name>autocomplete</tool_name>
<arguments>
{
  "field": "company",
  "text": "Goog"
}
</arguments>
</use_mcp_tool>

Licencia

Apache 2.0