From nuvia-mcp
Investiga uma empresa brasileira cruzando o quadro de sócios e administradores (dados públicos da Receita) com a identidade digital da empresa (decisores públicos). Use quando o usuário quer entender quem realmente manda numa empresa, mapear donos vs executivos, descobrir a estrutura societária, seguir holdings/grupo econômico, ou qualificar uma conta antes de abordar. Distingue LTDA (sócios = donos) de S.A. (sócios = diretoria).
How this skill is triggered — by the user, by Claude, or both
Slash command
/nuvia-mcp:investigar-empresa-brThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Cruzar o **quadro de sócios e administradores** (quem é sócio/administrador no papel, via base de CNPJ da Receita) com a **identidade digital** da empresa (quem aparece e atua publicamente). O cruzamento revela a estrutura real de poder, equity e decisão — e os buracos entre uma coisa e outra.
Cruzar o quadro de sócios e administradores (quem é sócio/administrador no papel, via base de CNPJ da Receita) com a identidade digital da empresa (quem aparece e atua publicamente). O cruzamento revela a estrutura real de poder, equity e decisão — e os buracos entre uma coisa e outra.
Antes de começar, leia a skill nuvia-fundamentos (ordem de custo, lookups, e como falar sem expor termos internos da base). Faça todo o trabalho gratuito primeiro, gaste crédito só no fim.
A natureza jurídica define o que o quadro de sócios significa. Leia-a antes de qualquer coisa:
Fase 1 — Lado jurídico (grátis). Tendo o CNPJ:
search_brazil_companies(filters: { cnpjs: { values: ["<cnpj>"] } }, page_size: 1)
Sem o CNPJ, ancore pelo domínio (grátis): link_global_to_brazil(domain). Use o domínio institucional/histórico; se falhar, tente .com.br/raiz do site. Essa rota já devolve o cadastro inteiro com os sócios.
Leia natureza_juridica, socios[] (com PF e PJ), dominios[].
Fase 2 — Ponte para o global (consome crédito), só quando for cruzar.
link_brazil_to_global(cnpj, domain, company_name) → { business_id }
Sempre passe domain E company_name. found:false → tente outro domínio. Sem o identificador da empresa, não há fase digital.
Fase 3 — Lado digital (consome crédito).
search_prospects(filters: { business_id, job_level: ["c-suite","vice president","director"] }, page_size: 50/100)
Pagine até esgotar; alargue o nível progressivamente se faltar alguém.
Para cada nome, cruze presença no quadro de sócios × presença no digital e rotule em buckets (🟢 dono+digital, 🔵 dono silencioso, 🟡 executivo contratado, 🔗 sócio PJ/holding, ⚪ colaborador). O matching é heurístico por nome (não há chave comum entre as bases).
Estes detalhes estão em references/playbook-qsa-digital.md — leia antes de cruzar: a tabela completa de buckets, a árvore de decisão, as regras de normalização e níveis de confiança do match, os ruídos a descartar (ex-funcionários, inflação de senioridade, homônimos), e o teto de cobertura.
Se houver sócio PJ no quadro (bucket 🔗), é um gancho de grupo: pegue o CNPJ da holding e rode search_brazil_companies nele para seguir a cadeia de controle e outras empresas do grupo.
Para mapear a rede societária de alguém (todas as empresas em que consta como sócio): use nome_socio (não socio!), resolvendo o nome em brazil_socio antes. Detalhes em nuvia-fundamentos/references/mapeamentos-br.md.
Tabela: Nome · Papel no quadro de sócios · Cargo digital · Bucket · Confiança do match. Mais um parágrafo de leitura: quem é o alvo nº 1, onde está o controle, e (se S.A.) o aviso de que a decisão de compra pode subir para o controlador.
Provides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
npx claudepluginhub nuvia-ai/nuvia-mcp-plugin --plugin nuvia-mcp