Muita empresa descobre o llms.txt, publica um Markdown na raiz do site e acha que resolveu a parte de "dados para IA".
Na prática, existe pelo menos mais um arquivo crítico: o ai-catalog.json.
Ele é o que permite consultas precisas — com preço, categoria, disponibilidade e filtros — em vez de a IA ficar tentando extrair informações de textos confusos.
Neste artigo você vai entender o que é o ai-catalog.json, para que ele serve de verdade e por que ele faz tanta diferença na qualidade das respostas.
O que é o ai-catalog.json
O ai-catalog.json é um arquivo estruturado que organiza o catálogo (ou a lista de serviços) da empresa em formato legível por máquinas.
Enquanto o llms.txt funciona mais como um índice curado em Markdown, o ai-catalog.json carrega os dados de forma precisa e consultável: produtos, preços, categorias, atributos e condições.
É a diferença entre entregar um mapa genérico e entregar a lista oficial com os detalhes que a IA precisa para responder bem.
Por que ele existe (e o que o llms.txt não resolve)
O llms.txt ajuda a IA a entender a estrutura do site e quais páginas são importantes.
Ele não foi feito para carregar milhares de produtos com preço, estoque e atributos.
Quando a pergunta exige precisão ("quais opções até R$ 100?", "tem na cor X?", "qual o preço atual do serviço Y?"), a IA precisa de dados estruturados.
É exatamente esse o papel do ai-catalog.json.
O que costuma ir dentro do arquivo
Dependendo do tipo de empresa, o arquivo pode conter:
E-commerce:
- Nome do produto
- Preço atual
- Categoria
- Disponibilidade
- Atributos relevantes (tamanho, cor, material etc.)
- URL ou identificador
Empresas de serviço:
- Nome do serviço
- Escopo resumido
- Público-alvo
- Formas de contratação
- Região de atendimento
- Diferenciais objetivos
O importante é que os dados estejam limpos, consistentes e atualizados.
Como ele permite consultas precisas
Com o ai-catalog.json bem montado e exposto via MCP Server, a IA consegue:
- Filtrar por preço
- Filtrar por categoria ou tipo de serviço
- Responder com dados atuais
- Evitar inventar informações que não existem no catálogo
Sem esse arquivo (ou equivalente estruturado), a IA volta a depender de extração de texto — um processo bem mais frágil.
Diferença entre ai-catalog.json, server.json e llms.txt
- llms.txt: Índice curado do site. Tipo de informação: Orientação em Markdown.
- server.json: Manifesto do MCP Server. Tipo de informação: Metadados do servidor.
- ai-catalog.json: Catálogo/serviços estruturados. Tipo de informação: Dados consultáveis.
Os três se complementam. Nenhum substitui o outro.
Exemplos práticos de uso
E-commerce:
Pergunta: "Quais colares até R$ 100?"
- Com ai-catalog.json: lista objetiva com nome e preço atual.
- Sem ele: resposta genérica ou inventada.
Serviços:
Pergunta: "Quais serviços vocês oferecem para PMEs com plano mensal?"
- Com ai-catalog.json: lista clara de serviços e condições.
- Sem ele: texto vago ou "não tenho informações específicas".
Erros comuns que prejudicam o arquivo
- Dados desatualizados: Resposta errada com aparência de certeza. Como evitar: Atualização contínua.
- Campos incompletos: Filtros não funcionam bem. Como evitar: Preencher os campos essenciais.
- Inconsistência de nomes e categorias: IA se confunde. Como evitar: Padronizar nomenclatura.
- Arquivo grande demais e mal organizado: Consultas lentas ou imprecisas. Como evitar: Manter estrutura limpa.
- Achar que só o llms.txt basta: Expectativa frustrada. Como evitar: Entender o papel de cada arquivo.
O próximo passo
O ai-catalog.json só entrega valor quando está completo, atualizado e acessível via MCP Server.
Antes de investir tempo na estruturação dos dados, vale medir o ponto de partida atual do seu site.
O diagnóstico gratuito da Scrypta analisa em segundos:
- Rastreabilidade
- Dados estruturados
- Presença e qualidade do llms.txt
- Legibilidade geral para agentes de IA
Leva cerca de 15 segundos e mostra objetivamente o que falta para a sua empresa conseguir responder com precisão às consultas dos agentes.