People Data Labs

Acesse dados de pessoas, empresas, escolas, localizações, cargos e habilidades usando a API do People Data Labs.

Documentação

Servidor MCP People Data Labs

Este é um servidor Model Context Protocol (MCP) que encapsula a API People Data Labs. Ele fornece acesso abrangente aos diversos modelos de dados e capacidades de busca do People Data Labs.

Recursos

API de Pessoa

Enriquecimento de Pessoa: Enriquece o perfil de uma pessoa com dados adicionais
Busca de Pessoas: Busca pessoas que correspondam a critérios específicos usando consultas no estilo SQL
Enriquecimento em Massa de Pessoas: Enriquece múltiplos perfis de pessoas em uma única solicitação

API de Empresa

Enriquecimento de Empresa: Enriquece o perfil de uma empresa com dados adicionais
Busca de Empresas: Busca empresas que correspondam a critérios específicos

Modelos de Dados Adicionais

Busca de Escolas: Busca escolas que correspondam a critérios específicos
Busca de Localizações: Busca localizações que correspondam a critérios específicos
Busca de Cargos: Busca cargos que correspondam a critérios específicos
Busca de Habilidades: Busca habilidades que correspondam a critérios específicos

Utilitários

Autocomplete: Obtém sugestões de autocomplete para vários campos

Instalação

Clone este repositório
Instale as dependências:
```
npm install
```
Compile o projeto:
```
npm run build
```
Configure sua chave de API do People Data Labs usando um dos scripts de configuração fornecidos

Configuração

Configuração Automática

Este projeto inclui scripts para configurar automaticamente o servidor MCP para Claude Desktop e VS Code:

Para Claude Desktop:

npm run config:claude

Para VS Code:

npm run config:vscode

Ambos os scripts irão:

Verificar se o arquivo de configuração existe e criá-lo se necessário
Solicitar sua chave de API do People Data Labs
Adicionar a configuração do servidor MCP ao arquivo apropriado
Fornecer instruções para os próximos passos

Configuração Manual

Se você preferir configurar o servidor MCP manualmente, você precisa adicioná-lo ao seu arquivo de configurações do MCP. A localização deste arquivo depende do seu ambiente:

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

Adicione a seguinte configuração ao objeto mcpServers no seu arquivo de configurações do MCP:

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

Substitua:

path/to/peopledatalabs-mcp/build/index.js pelo caminho real para o arquivo index.js compilado
your-api-key-here pela sua chave de API real do People Data Labs

Ferramentas Disponíveis

Ferramentas da API de Pessoa

enrich_person

Enriquece o perfil de uma pessoa com dados adicionais do People Data Labs.

Parâmetros:

email (string, opcional): Endereço de e-mail da pessoa
phone (string, opcional): Número de telefone da pessoa
name (string, opcional): Nome completo da pessoa
profile (array de strings, opcional): URLs de perfis de mídia social da pessoa
location (string, opcional): Localização da pessoa (cidade, estado, país)
company (string, opcional): Nome da empresa onde a pessoa trabalha
title (string, opcional): Cargo da pessoa
min_likelihood (número, opcional): Pontuação mínima de probabilidade (0-1) para a correspondência

Nota: Pelo menos um dos email, phone, name ou profile deve ser fornecido.

search_people

Busca pessoas que correspondam a critérios específicos usando consultas no estilo SQL.

Parâmetros:

query (string, obrigatório): Consulta no estilo SQL para buscar pessoas
size (número, opcional): Número de resultados a retornar (máx. 100)

bulk_person_enrich

Enriquece múltiplos perfis de pessoas em uma única solicitação.

Parâmetros:

requests (array, obrigatório): Array de solicitações de enriquecimento de pessoas

Ferramentas da API de Empresa

enrich_company

Enriquece o perfil de uma empresa com dados adicionais.

Parâmetros:

name (string, opcional): Nome da empresa
website (string, opcional): Site da empresa
profile (array de strings, opcional): URLs de perfis de mídia social da empresa
ticker (string, opcional): Símbolo de ticker de ações da empresa

Nota: Pelo menos um dos name, website, profile ou ticker deve ser fornecido.

search_companies

Busca empresas que correspondam a critérios específicos.

Parâmetros:

query (string, obrigatório): Consulta no estilo SQL para buscar empresas
size (número, opcional): Número de resultados a retornar (máx. 100)

Ferramentas da API de Escola

search_schools

Busca escolas que correspondam a critérios específicos.

Parâmetros:

query (string, obrigatório): Consulta no estilo SQL para buscar escolas
size (número, opcional): Número de resultados a retornar (máx. 100)

Ferramentas da API de Localização

search_locations

Busca localizações que correspondam a critérios específicos.

Parâmetros:

query (string, obrigatório): Consulta no estilo SQL para buscar localizações
size (número, opcional): Número de resultados a retornar (máx. 100)

Ferramentas da API de Cargo

search_job_titles

Busca cargos que correspondam a critérios específicos.

Parâmetros:

query (string, obrigatório): Consulta no estilo SQL para buscar cargos
size (número, opcional): Número de resultados a retornar (máx. 100)

Ferramentas da API de Habilidade

search_skills

Busca habilidades que correspondam a critérios específicos.

Parâmetros:

query (string, obrigatório): Consulta no estilo SQL para buscar habilidades
size (número, opcional): Número de resultados a retornar (máx. 100)

Ferramentas Utilitárias

autocomplete

Obtém sugestões de autocomplete para uma consulta parcial.

Parâmetros:

field (string, obrigatório): Campo para autocomplete (empresa, escola, cargo, habilidade, localização)
text (string, obrigatório): Texto parcial para autocomplete
size (número, opcional): Número de resultados a retornar (máx. 100)

Exemplo de Uso

Exemplos da API de Pessoa

<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>

Exemplos da API de Empresa

<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>

Exemplo de Autocomplete

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

Licença

Apache 2.0