# Conecte o Claude a dados do governo

**Publicado:** 27 de agosto de 2026 | **Autores:** Tomás Calle

---

Este guia acompanha o workshop [Conecta Claude y ChatGPT a datos del gobierno](https://luma.com/lab10-orxm), que fizemos com o [Lab10](https://luma.com/lab10-orxm) em 27 de agosto de 2026. Ele serve para você repetir tudo passo a passo, no seu ritmo.

## Objetivo

Vamos construir uma skill no Claude que recebe uma lista de empresas, enriquece cada uma com o registro mercantil e as demonstrações financeiras, e manda o resultado para a sua equipe por e-mail. Sem abrir um único portal.

## O que é a Croma

A Croma coloca os dados públicos da América Latina a uma chamada de distância do seu agente. Uma única chave abre mais de 70 fontes oficiais: [RUES](/co/fuentes), Supersociedades, Rama Judicial, SECOP, Registraduría e muitas outras, todas no mesmo formato. Você pergunta ao Claude sobre uma empresa e ele responde com a informação trazida do portal oficial, com a fonte e a data. Você pode explorar [as fontes](/co/fuentes), testar [as ferramentas](/co/tools) ou ler [a documentação](https://docs.usecroma.com/pt).

## O que é uma skill

Uma skill é uma pasta de instruções que o Claude carrega para fazer uma tarefa específica de forma repetível. É assim que a Anthropic a define. Ela tem três partes: um nome, uma descrição que diz ao Claude quando usá-la e as instruções com o passo a passo.

Ela serve para duas coisas: definir um processo uma vez para rodá-lo com facilidade da próxima vez, e compartilhá-lo com a sua equipe, que o instala pelo diretório da organização e o roda do mesmo jeito.

Uma skill descreve o processo. Os dados vêm da Croma, e por isso começamos conectando a Croma.

## Por que a Croma existe

Um agente é tão bom quanto a informação que ele consegue alcançar. Sem dados, não tem nada para processar. Com o registro mercantil, as demonstrações financeiras e os processos judiciais à mão, ele verifica, cruza e decide. Na América Latina essa informação é pública, mas está espalhada em dezenas de portais que não conversam entre si. A Croma transforma essa informação em uma ferramenta que o agente usa como qualquer outra.

## Passo 1: crie sua conta na Croma

1. Entre em [platform.usecroma.com/sign-up](https://platform.usecroma.com/sign-up) e crie sua conta. É grátis.
2. Se aparecer o pedido para criar uma organização, dê a ela o nome da sua empresa e continue.
3. Abra [platform.usecroma.com/mcp](https://platform.usecroma.com/mcp) e aceite os termos.

## Passo 2: conecte o MCP da Croma ao Claude

Funciona com o plano gratuito do Claude. Faça login e clique neste botão:

[Adicionar a Croma ao Claude](https://claude.ai/new?modal=add-custom-connector&connectorName=Croma%20%7C%20The%20API%20for%20government%20data&connectorUrl=https%3A%2F%2Fapi.croma.run%2Fmcp#settings/customize-connectors "cta")

O Claude abre com o conector já preenchido. Clique em *Add*, depois em *Connect*, e faça login com sua conta da Croma. As ferramentas aparecem em cada chat novo.

Se preferir fazer à mão, vá em [Customize → Connectors](https://claude.ai/customize/connectors), clique em *+* e depois em *Add custom connector*, e cole estes dois valores:

```text
Croma | The API for government data
```

```text
https://api.croma.run/mcp
```

Para confirmar que a conexão funcionou, abra um chat novo e pergunte:

```text
Busca el NIT 900843898 en RUES y resume la empresa
```

Se o Claude responder com os dados da Rappi, está tudo pronto. O guia por cliente, incluindo o ChatGPT, está em [/mcp/claude](/mcp/claude).

## Passo 3: o processo que vamos automatizar

Para cada empresa da lista, o agente faz três chamadas à Croma:

| Ferramenta | O que retorna |
| --- | --- |
| `rues_entities_by_name` | Candidatos por nome, com o NIT, para quando a lista não traz esse dado |
| `rues_entity_by_nit` | O registro mercantil completo: situação, câmara, atividade, renovações e representantes legais |
| `supersociedades_financial_statements` | Até dez anos de demonstrações financeiras: receita, lucro, ativos e fluxo de caixa |

Com isso, ele monta uma linha por empresa e entrega a tabela como CSV. O difícil não são as chamadas, é o critério: qual registro escolher quando há vários, em que unidade vêm os valores e o que fazer quando não há dados. Isso vai na skill.

## Passo 4: crie a skill no Claude

Abra [claude.ai/customize/skills](https://claude.ai/customize/skills), clique em *Criar habilidade* e cole estes três blocos nos campos correspondentes. O terceiro vai no editor grande de baixo, onde aparece *Adicionar arquivo*.

### Nome da habilidade

```text
lead-enrichment
```

### Descrição

```text
Enriquece una lista de empresas colombianas (CSV o texto) con datos públicos de RUES y Supersociedades usando las herramientas de Croma. Úsala cuando te pidan enriquecer, calificar o priorizar leads, o investigar varias empresas a la vez.
```

### Instruções

```markdown
# Lead enrichment con datos públicos de Colombia

Enriquece cada empresa de la lista con su registro mercantil (RUES) y sus
estados financieros (Supersociedades) usando las herramientas de Croma.

## Entrada

Un CSV o una lista con al menos el nombre de la empresa. Si trae la columna
`nit`, úsala. Si no, resuélvelo con la búsqueda por nombre.

## Herramientas de Croma

- `rues_entities_by_name`: busca por nombre y devuelve candidatos con su NIT.
- `rues_entity_by_nit`: registro completo por NIT, con renovaciones,
  representantes legales y avisos.
- `supersociedades_financial_statements`: estados financieros anuales por
  NIT, del más reciente al más antiguo.

## Proceso, empresa por empresa

1. Sin NIT: llama `rues_entities_by_name` y elige el registro con
   `registration_status` ACTIVA y categoría SOCIEDAD (no un establecimiento
   de comercio ni una persona natural). Toma su `nit`.
2. Con NIT: llama `rues_entity_by_nit`. Si el registro no está ACTIVA, es
   PERSONA NATURAL o un ESTABLECIMIENTO, repite el paso 1 con el nombre y
   quédate con la matrícula principal activa.
3. Llama `supersociedades_financial_statements` con el NIT. Usa el año más
   reciente y el anterior. Si `reporting_unit` es MILES DE PESOS, divide
   entre 1.000 para reportar en millones de pesos.
4. Calcula el crecimiento de ingresos frente al año anterior y clasifica:
   Pequeña (menos de 10.000 millones), Mediana (10.000 a 100.000 millones),
   Grande (más de 100.000 millones).
5. Del representante legal toma solo el nombre, nunca el número de documento.
6. Si una herramienta falla o no encuentra datos, escribe "sin datos" en esa
   columna y sigue con la siguiente empresa. Nunca inventes una cifra.

## Salida

Primero una tabla, luego el mismo contenido como CSV descargable con estas
columnas:

empresa, nit, razon_social, estado, camara, actividad_ciiu,
ultima_renovacion, representante_legal, anio_reporte, ingresos_millones,
utilidad_neta_millones, activos_millones, crecimiento_ingresos, segmento,
fuente

Si te piden enviar el resultado por correo, usa la herramienta de Gmail de
Composio, con el resumen y el CSV completo en el cuerpo del mensaje.

Cierra con tres líneas: qué empresas quedaron completas, cuáles quedaron
parciales y qué haría falta para completarlas.
```

Clique em *Criar*. A skill fica disponível em todos os seus chats.

## Passo 5: baixe a lista de exemplo

Para o workshop, usamos três empresas que todo mundo conhece e que têm dados no RUES e na Supersociedades.

[Baixe lab10-leads.csv](https://usecroma.com/blog/lab10-lead-enrichment-skill/lab10-leads.csv)

Se preferir montar o arquivo você mesmo, este é o conteúdo completo:

```csv
empresa,nit
Rappi,900843898
Frisby,891408584
D1,900276962
```

A coluna `nit` é opcional: sem ela, a skill identifica a empresa pelo nome. A Frisby é o caso interessante. O NIT dela leva primeiro a uma matrícula antiga, e o passo 2 da skill corrige isso. É por detalhes assim que vale a pena escrever a skill.

## Passo 6: execute a skill

1. Abra um chat novo no Claude.
2. Digite `/` e escolha `lead-enrichment`.
3. Anexe `lab10-leads.csv` e escreva: *Enriqueça estes leads*.

Na primeira vez, o Claude pede permissão para usar cada ferramenta da Croma. Aceite e deixe-o trabalhar. Com essas três empresas, o resultado fica assim (valores em milhões de pesos, da última demonstração financeira reportada):

| Empresa | NIT | Situação no RUES | Atividade | Receita 2025 | Lucro líquido 2025 | Crescimento |
| --- | --- | --- | --- | --- | --- | --- |
| Rappi | 900843898 | Ativa, Bogotá, renovada em 2026 | 6201, desenvolvimento de software | 766.929 | 210.176 | +12,5% |
| Frisby | 891408584 | Ativa, Pereira, renovada em 2026 | 5612, refeições preparadas | 1.183.955 | 63.442 | +23,0% |
| D1 | 900276962 | Ativa, Bogotá, renovada em 2026 | 4711, comércio varejista | 11.123.777 | 213.856 | +11,3% |

Três empresas levam menos de um minuto. Cem levam um café.

## Passo 7: envie o resultado para a sua equipe com o Composio

Um lead enrichment que fica no chat não serve para muita coisa. O último passo é mandar o resultado para quem vai ligar para essas empresas, sem sair do Claude.

Para isso, usamos o [Composio](https://composio.dev/for-you), a ponte que conecta o Gmail ao Claude. O Composio constrói conectores: com uma única conexão, o Claude alcança mais de 1.000 aplicativos. E, diferente dos conectores que o Claude traz por padrão, os dele também agem: enviam o e-mail, criam a tarefa, atualizam o CRM.

1. Crie sua conta grátis em [dashboard.composio.dev](https://dashboard.composio.dev/login), procure o Gmail e clique em *Connect*.
2. No Claude, vá em [Customize → Connectors](https://claude.ai/customize/connectors), clique em *+* e depois em *Add custom connector*, e cole estes dois valores.
3. Clique em *Add*, depois em *Connect*, e autorize o Composio no navegador.

```text
Composio
```

```text
https://connect.composio.dev/mcp
```

De volta ao chat onde a skill rodou, peça:

```text
Envíale por correo a nombre@tuempresa.com el resultado del lead enrichment: asunto "Leads enriquecidos: Rappi, Frisby y D1", un resumen de tres líneas y el CSV completo en el cuerpo del mensaje.
```

O Claude redige o e-mail, mostra para você e envia. Dados públicos, uma skill com critério e o resultado no e-mail da sua equipe, tudo em um único chat.

## O que vem a seguir

Assim como montamos aqui um lead enrichment, a Croma tem mais de 70 fontes para automatizar outros processos: due diligence com a Rama Judicial e a Procuraduría, acompanhamento de contratos no SECOP, validação de identidade com a Registraduría, ou o que a sua equipe repete toda semana. Explore [as fontes](/co/fuentes), teste [as ferramentas públicas](/co/tools) ou confira [a documentação](https://docs.usecroma.com/pt). E, para o próximo workshop, siga o [Lab10](https://luma.com/lab10-orxm).

## Participe da comunidade

Se você montou a skill, conte para a gente como foi. A comunidade da Croma está no WhatsApp: lá compartilhamos skills, tiramos dúvidas e avisamos sobre os próximos workshops.

[Entrar na comunidade da Croma](https://chat.whatsapp.com/KjvKXdPgbhm2mYqymm8aEp?mode=gi_t "cta")

---

**Mais artigos:** [Ver todos os artigos do blog](/pt/blog/sitemap.md) | [Croma](https://usecroma.com)