Este guia acompanha o workshop Conecta Claude y ChatGPT a datos del gobierno, que fizemos com o Lab10 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, 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, testar as ferramentas ou ler a documentação.
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#
- Entre em platform.usecroma.com/sign-up e crie sua conta. É grátis.
- Se aparecer o pedido para criar uma organização, dê a ela o nome da sua empresa e continue.
- Abra 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:
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, clique em + e depois em Add custom connector, e cole estes dois valores:
Croma | The API for government datahttps://api.croma.run/mcpPara confirmar que a conexão funcionou, abra um chat novo e pergunte:
Busca el NIT 900843898 en RUES y resume la empresaSe o Claude responder com os dados da Rappi, está tudo pronto. O guia por cliente, incluindo o ChatGPT, está em /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, 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#
lead-enrichmentDescrição#
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#
# 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.
Se preferir montar o arquivo você mesmo, este é o conteúdo completo:
empresa,nit
Rappi,900843898
Frisby,891408584
D1,900276962A 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#
- Abra um chat novo no Claude.
- Digite
/e escolhalead-enrichment. - Anexe
lab10-leads.csve 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, 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.
- Crie sua conta grátis em dashboard.composio.dev, procure o Gmail e clique em Connect.
- No Claude, vá em Customize → Connectors, clique em + e depois em Add custom connector, e cole estes dois valores.
- Clique em Add, depois em Connect, e autorize o Composio no navegador.
Composiohttps://connect.composio.dev/mcpDe volta ao chat onde a skill rodou, peça:
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, teste as ferramentas públicas ou confira a documentação. E, para o próximo workshop, siga o Lab10.
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.