Zooq

API de dados do LinkedIn e servidor MCP para agentes de IA: perfis públicos, empresas e posts como JSON limpo, sem login, 300 créditos gratuitos.

Ver em zooq.devExperimente este MCPPatrocinado

Documentação

Servidor MCP do Zooq

Adicione o Zooq a qualquer cliente compatível com MCP (Claude Desktop, Cursor, Codex, Hermes, Openclaw) e seu agente terá o catálogo completo do Zooq: todos os 44 endpoints disponíveis como ferramentas MCP cobradas por créditos.

Obtenha sua chave + 300 créditos grátis →

Instalação: escolha seu cliente

Instalar no Claude Desktop

Abra Configurações → Conectores → Adicionar conector personalizado e cole esta URL (sua chave está embutida nela — não são necessários cabeçalhos):

https://zooq.dev/api/mcp?key=zq_...

Substitua zq_... pela sua chave do /dash. Reinicie o Claude. As ferramentas aparecem no menu de ferramentas sob "zooq".

Mantenha essa URL privada — a chave está nela. Se ela vazar, gire a chave pelo seu painel. Reinicie o Claude Desktop após adicionar; as ferramentas aparecem na próxima conversa.

Instalar no Cursor

Configurações do Cursor → MCP → cole:

{
  "mcpServers": {
    "zooq": {
      "url": "https://zooq.dev/api/mcp",
      "headers": { "X-API-Key": "zq_..." }
    }
  }
}

Instalar no Codex

Edite ~/.codex/config.toml — acrescente:

[mcp_servers.zooq]
url = "https://zooq.dev/api/mcp"
http_headers = { "X-API-Key" = "zq_..." }

Instalar no Hermes

Edite ~/.hermes/config.yaml — mescle em mcp_servers:

mcp_servers:
  zooq:
    url: "https://zooq.dev/api/mcp"
    headers:
      X-API-Key: "zq_..."
    enabled: true

Instalar no Openclaw

Edite ~/.openclaw/openclaw.json — mescle no objeto raiz (ou execute openclaw mcp set zooq '<json>'):

{
  "mcp": {
    "servers": {
      "zooq": {
        "url": "https://zooq.dev/api/mcp",
        "headers": {
          "X-API-Key": "zq_..."
        }
      }
    }
  }
}

O que seu agente recebe (44 ferramentas)

O catálogo completo — 44 endpoints em 8 categorias, todos chamáveis pelo seu cliente MCP. Os nomes das ferramentas seguem a convenção category_endpoint (ex.: profile_full, companies_info_v2, search_jobs).

Empresas (11)

companies_entity_id

Resolva um slug de empresa para o ID numérico da organização usado pelos endpoints de empresa ao vivo (posts, similares, afiliadas, insights). Resolva uma vez e reutilize o ID.

companies_universal_name_to_id

Resolva um slug de empresa (a parte após linkedin.com/company/) para seu org_ id estável — o ID do conjunto de dados usado por /companies/info. Para os endpoints de empresa ao vivo (posts, similares, afiliadas, insights), use /api/v1/companies/entity-id; os dois IDs não são intercambiáveis. Retorna o registro COMPLETO da empresa (idêntico a /companies/info) — leia data.id\.

companies_info

Firmografia completa da empresa — descrição, setor, número de funcionários, sede, contagem de seguidores, especialidades.

companies_enrich

Perfil de empresa AO VIVO mais recente. Retorna três coisas que o registro do conjunto de dados por trás de /api/v1/companies/info não traz: sinais de financiamento, a lista COMPLETA de locais (não apenas a sede) e páginas matriz/afiliadas/relacionadas. Passe slug\ e o Zooq resolve para o ID numérico sem custo extra de crédito, ou passe id\ de /api/v1/companies/entity-id para pular a consulta. Não encontrado é gratuito no upstream.

companies_name_lookup

Pesquise empresas por nome, com o conjunto completo de filtros firmográficos. Paginação por cursor. Mesmo upstream de /api/v1/search/companies — use o ponto de entrada que preferir; eles são equivalentes.

companies_employees_data

Pessoas que trabalham ou trabalharam em uma organização (registros profissionais, mesmo formato de /search/people). Paginação por cursor.

companies_similar

Empresas similares / pares (id, nome, setor, seguidores, url). Baseado no ID numérico da organização: passe slug\ e o Zooq resolve para você sem custo extra de crédito, ou passe id\ de /api/v1/companies/entity-id para pular a consulta.

companies_affiliated_pages

Páginas afiliadas / subsidiárias / vitrine de uma empresa. Baseado no ID numérico da organização: passe slug\ e o Zooq resolve para você sem custo extra de crédito, ou passe id\ de /api/v1/companies/entity-id para pular a consulta.

companies_insights

Total de funcionários + buckets de distribuição (por departamento, senioridade, local). Baseado no ID numérico da organização: passe slug\ e o Zooq resolve para você sem custo extra de crédito, ou passe id\ de /api/v1/companies/entity-id para pular a consulta.

companies_posts

Posts recentes de uma empresa. data.activities[].entityId é o ID de atividade consumido por /posts/info, /posts/comments, /posts/likes. Baseado no ID numérico da organização: passe slug\ e o Zooq resolve para você sem custo extra de crédito, ou passe id\ de /api/v1/companies/entity-id para pular a consulta.

companies_jobs

Vagas de emprego abertas em uma ou mais organizações.

E-mail (5)

email_verify

Verifique se um endereço de e-mail pode receber mensagens, com veredito de entregabilidade e sinalizadores de risco (catch-all, descartável, sem MX).

email_find

Descubra o e-mail profissional de uma pessoa a partir do nome, sobrenome e domínio da empresa. Retorna o endereço mais uma pontuação de confiança.

email_find_by_profile

Identifique uma pessoa e sua empresa atual a partir de uma URL de perfil profissional (ou handle) e encontre seu e-mail profissional — resolve nome + domínio para você.

email_reverse

Resolva a pessoa e a empresa por trás de um endereço de e-mail COMERCIAL. Caixas públicas/de função/descartáveis são rejeitadas (422, sem cobrança) antes de qualquer processamento.

email_prospects

E-mails de página já conhecidos para um domínio de empresa. Paginação por cursor; retorna até 20 contatos por página com nome/sobrenome.

Vagas (5)

jobs_details_v2

Detalhes completos da vaga — título, descrição, funções, URL de candidatura, organização, local.

jobs_similar

Vagas similares (título, organização, local, faixa salarial, data de publicação).

jobs_people_also_viewed

Publicações "vistas também por" (relacionamento comportamental).

jobs_hiring_team

Perfis de membros da equipe de contratação para uma vaga. Membros vazios podem significar que a vaga realmente não lista equipe OU que o ID da vaga não foi reconhecido.

jobs_posted_by_profile

Vagas publicadas por uma pessoa (funções de recrutador, gerente de contratação ou fundador). Inclui vagas fechadas (jobState\). Apenas pessoas que publicaram vagas retornam resultados: para qualquer outra pessoa, o upstream responde 422 "os dados não podem ser exibidos ou não existem" — isso é um não encontrado, não um ID inválido. Encontre quem publica via /api/v1/jobs/hiring-team em uma vaga ativa.

Consultas (3)

g_title_skills_lookup

Pesquisa no catálogo de habilidades por nome (correspondência parcial) — apenas habilidades, apesar do nome do endpoint. Paginação por página. Use para encontrar o skl_ id ou normalized_name de uma habilidade para o filtro de habilidades de /search/people.

g_institution_lookup

Resolva uma instituição pelo nome normalizado — retorna o nome da escola, url e inst_ id estável. Obtenha o normalized_name de /api/v1/search/schools primeiro.

g_skill_lookup

Resolva uma habilidade pelo skl_ id estável — retorna o nome de exibição e o nome normalizado. Obtenha o ID de /api/v1/g/title-skills-lookup (pesquisa de habilidades).

Posts (4)

posts_all

Posts recentes / fluxo de atividades de uma pessoa. Paginação por cursor ou offset. Baseado no entityId da pessoa: passe handle\ e o Zooq resolve para você sem custo extra de crédito, ou passe entityId\ de /api/v1/profile/entity-id para pular a consulta.

posts_info

Conteúdo completo de um post (retornado em data.post). Para comentários, use /posts/comments.

posts_likes

Pessoas que reagiram a um post + tipo de reação e total.

Perfil (7)

profile_full

Perfil completo em uma chamada — cargos, educação, habilidades, certificações, geolocalização, contagens de seguidores/conexões e sinalizadores. Esta é a leitura canônica de perfil; os outros caminhos profile/* (overview, details, about, education, skills, certifications, full-experience, social-matrix) são aliases nomeados que retornam exatamente este mesmo registro.

profile_entity_id

Resolva um handle público para o entityId da pessoa usado pelos endpoints de pessoa ao vivo (posts, comentários, interesses, lookalikes). Resolva uma vez e reutilize o ID.

profile_enrich

Snapshot AO VIVO mais recente de um perfil, por handle ou entityId — não o registro deduplicado do conjunto de dados que os outros endpoints profile/* retornam. Traz sinalizadores exclusivos ao vivo (openToWork, isHiring, isTopVoice) e retorna o entityId da pessoa, o ID que todo outro endpoint de pessoa ao vivo precisa.

profile_employment_history

Histórico de trabalho AO VIVO completo de uma pessoa: organização por função, título, descrição, local, datas analisadas, habilidades por função e agrupamentos de posições paralelas (títulos simultâneos mantidos distintos em vez de achatados). Sobreposto a /api/v1/profile/full-experience, que lê o registro do conjunto de dados — use este quando precisar de atualização, habilidades por função ou tratamento correto de funções simultâneas. Passe handle\ e o Zooq resolve sem custo extra de crédito, ou passe entityId\ de /api/v1/profile/entity-id para pular a consulta. Não encontrado é gratuito no upstream.

profile_recommendations

Recomendações escritas para a pessoa, com detalhes do autor e texto.

profile_similar

Perfis profissionais similares — expanda uma lista curta a partir de um exemplo.

profile_interests

Entidades que a pessoa segue (empresas, grupos, pessoas, newsletters).

Pesquisa (8)

search_people

Pesquise registros profissionais com filtros ricos — nome, título, empresa, habilidades, educação, tempo de casa, geografia. Paginação por cursor.

search_companies

Pesquise organizações por nome ou site com filtros firmográficos. Paginação por cursor.

search_jobs

Pesquisa de vagas/oportunidades com o conjunto completo de filtros. O filtro de local funciona: passe locations\ um ID de geo do LinkedIn (ex.: 101570771 para Tel Aviv-Yafo) — veja esse parâmetro para saber como encontrar um, e observe que é correspondência EXATA, então use um ID de cidade em vez de um ID de país. Ainda tipados por ID e ainda não utilizáveis: títulos, setores, funções, benefícios, compromissos. Paginação por offset. data.jobs[].id é o opportunityEntityId consumido por /jobs/details-v2, /jobs/similar, /jobs/people-also-viewed, /jobs/hiring-team.

search_people_live

Pesquisa de pessoas AO VIVO — o único endpoint que filtra por empresa atual, empresa anterior E escola juntos. Complementa /api/v1/search/people (o conjunto de dados deduplicado, paginação por cursor, geo em string simples): use este para histórico de empresas, aquele para filtragem firmográfica ampla. Paginação por offset. Não encontrado é gratuito no upstream.

search_companies_live

Pesquisa de empresas AO VIVO. Seu diferencial é hasJobs\ — um filtro de contratação ativa disponível em nenhum outro lugar do catálogo — além de pesquisa por faixa de funcionários. Para filtragem firmográfica (contagens de funcionários/seguidores, ano de fundação, site), use /api/v1/search/companies. Paginação por offset. Não encontrado é gratuito no upstream.

search_schools

Pesquise instituições por nome (correspondência parcial). Paginação por página. Use para descobrir o inst_ id ou normalized_name de uma instituição.

search_job_changes

Eventos recentes de mudança de emprego — pessoas que entraram, saíram ou mudaram de cargo em organizações. Paginação por página. Feito para prospecção baseada em gatilhos e monitoramento de território.

search_alumni

Ex-alunos e alunos atuais de uma instituição (registros profissionais + o vínculo educacional). Paginação por página. Feito para recrutamento e prospecção com apresentação calorosa.

Cada ferramenta custa a mesma taxa por chamada que sua contraparte REST — verifique seu saldo ao vivo e o custo por chamada em /dash.

O que é MCP?

Model Context Protocol é o padrão aberto da Anthropic para permitir que clientes de IA (Claude, etc.) descubram e chamem ferramentas externas em tempo de execução. Em vez de você escrever wrappers de API no código do seu agente, seu agente lê uma lista de ferramentas de um servidor MCP e as chama diretamente via JSON-RPC. O Zooq expõe seus endpoints de dados dessa forma.

Por que é seguro instalar

Limite de consumo por hora

Uma chave vazada não pode drenar seu saldo — o servidor impõe um limite de créditos máximos por hora por usuário (padrão 10.000/h, ~1.000 chamadas). Mesmo o dano de uma chave comprometida é limitado.

Dedução atômica de créditos

Cada chamada de ferramenta deduz créditos atomicamente. O upstream retorna 5xx? Os créditos são reembolsados automaticamente em segundos. Sem novas tentativas que cobrem em dobro.

Lista branca estrita de argumentos

Os argumentos das ferramentas são comparados ao esquema declarado do endpoint. Chaves desconhecidas são descartadas; valores superdimensionados são truncados. Impede tentativas de injeção no proxy upstream.

Revogável em um clique

Suspeita que sua chave vazou? Abra /dash e regenere. A chave antiga para de funcionar imediatamente.

Exemplos de uso

Após a instalação, seu agente vê todas as ferramentas listadas acima. Exemplos de prompts e a ferramenta que o agente escolherá:

"Me traga o perfil completo do LinkedIn de satyanadella " → profile_full
"O que diz a página do LinkedIn da Stripe?" → companies_name_lookup e depois companies_info
"Encontre 10 VPs de Engenharia em empresas de SaaS em São Francisco" → search_people
"Puxe todas as vagas abertas na Microsoft" → companies_universal_name_to_id e depois search_jobs com o filtro companies
"Mapeie o crescimento de headcount da empresa X no último ano" → companies_insights

Agentes podem encadear ferramentas nativamente — o protocolo MCP expõe o esquema completo de parâmetros para que o modelo saiba qual ID passar para onde.

Preços

Cada chamada de ferramenta MCP deduz créditos em tempo real, igual à API REST. Sem mínimo mensal, sem sobretaxa para MCP. Veja /pricing para os pacotes de créditos e planos de assinatura.

Solução de problemas

Ferramentas não aparecem no cliente: reinicie o aplicativo completamente (saia, não apenas feche). Verifique se seu JSON de configuração é válido.
"Invalid API key": confira se você copiou a chave completa de /dash (ela começa com zq_).
"Insufficient credits" / "Payment required": recarregue em /billing.
"Hourly credit cap reached": o padrão é 10.000/h. Envie um e-mail para hello@zooq.dev para aumentar.
A ferramenta não retorna dados: o serviço upstream pode estar temporariamente degradado — verifique /status. Se for 5xx, seus créditos são reembolsados automaticamente.