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.
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
- Clona este repositorio
- Instala las dependencias:
npm install - Compila el proyecto:
npm run build - 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:
- Verificar si el archivo de configuración existe y crearlo si es necesario
- Solicitar tu clave de API de People Data Labs
- Agregar la configuración del servidor MCP al archivo correspondiente
- 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.jscon la ruta real al archivo index.js compiladoyour-api-key-herecon 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 personaphone(cadena, opcional): Número de teléfono de la personaname(cadena, opcional): Nombre completo de la personaprofile(arreglo de cadenas, opcional): URLs de perfiles de redes sociales de la personalocation(cadena, opcional): Ubicación de la persona (ciudad, estado, país)company(cadena, opcional): Nombre de la empresa donde trabaja la personatitle(cadena, opcional): Título del puesto de la personamin_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 personassize(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 empresawebsite(cadena, opcional): Sitio web de la empresaprofile(arreglo de cadenas, opcional): URLs de perfiles de redes sociales de la empresaticker(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 empresassize(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 escuelassize(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 ubicacionessize(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 puestosize(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 habilidadessize(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 autocompletarsize(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