Vitrine LLM-first: como agentes de IA consomem 2aFinder (MCP, JSON-LD, llms.txt)

# Vitrine LLM-first: como agentes de IA consomem 2aFinder (MCP, JSON-LD, llms.txt)

Em 2026, uma fatia crescente das decisões de compra começa numa conversa com um agente IA — Claude, ChatGPT, Gemini, Perplexity — e termina num link. O usuário pergunta "qual o melhor notebook até R$ 5.000 com 16GB?", o agente responde com recomendação, e a recomendação cita fontes.

A pergunta para qualquer comparador em 2026 é: **quando o agente IA cita fontes, ele cita você?**

A maioria dos comparadores brasileiros foi projetada para humanos abrindo o site num navegador desktop em 2015. JavaScript pesado, SPA com renderização client-side, dados estruturados ausentes ou quebrados, robots.txt restritivo. Resultado: agente IA não consegue ler, não cita, e a recomendação vai para Wirecutter, Notebookcheck ou outras fontes anglófonas que descobriram a vitrine LLM-first cedo.

A 2aFinder foi projetada do zero para ser **consumível por agentes**. Esse é o ponto mais sutil — e talvez o mais estratégico — da arquitetura.

## O problema que isso resolve

Há três frentes onde comparadores tradicionais falham com agentes IA:

**Renderização cliente-side.** Buscapé, Zoom, Cuponomia carregam dados via JavaScript depois que a página abre. Crawler de LLM (que geralmente faz fetch HTTP simples, não roda JS pesado) recebe HTML vazio. Resultado: agente vê página em branco, não cita.

**Dados estruturados ausentes ou inválidos.** Schema.org (Product, Offer, AggregateRating, Review) é a "linguagem" que motores de busca e agentes IA usam pra entender o que está numa página. Sem isso, é texto solto. Com isso errado, é ruído.

**Política de acesso opaca.** O arquivo `llms.txt` (proposta emergente em 2024-2025, análoga ao `robots.txt` mas dirigida a LLMs) explicita o que o site permite e como prefere ser citado. A maioria dos sites brasileiros não tem. 2aFinder tem em todo conteúdo público.

A consequência é que **a vitrine de citação por agente IA está sendo dominada por sites estrangeiros** com SEO técnico bem feito, enquanto o ecossistema brasileiro fica de fora desse fluxo. Isso é um problema de produto, mas também é um problema de soberania de dado nacional.

## Como 2aFinder faz diferente

Quatro decisões arquiteturais sustentam a vitrine LLM-first:

### 1. SSR puro nas páginas de produto e oferta

Toda página pública da 2aFinder é renderizada **inteiramente no servidor**. Abre sem JavaScript. O crawler IA recebe HTML completo, com todos os dados, na primeira request. Lighthouse SEO 100 é o teto, e é o piso da 2aFinder — não a meta aspiracional. JSON-LD válido em toda página (Product, Offer, AggregateRating quando aplicável, Review quando há avaliação).

### 2. `.md` mirror em todo conteúdo público

Toda página HTML pública tem um espelho em **Markdown** acessível pela mesma URL com `.md` no fim — `findr.com.br/produto/abc.md` retorna versão markdown da página HTML. Markdown é o formato nativo de consumo de LLM: zero tag, zero CSS, zero JavaScript, dado puro. Agente IA prefere `.md` quando disponível porque processa mais rápido e com menos token.

### 3. `llms.txt` na raiz e por categoria

O arquivo `/llms.txt` na raiz lista as URLs principais do site, com descrição curta de cada uma, em formato pensado para LLM consumir. Agente IA fazendo discovery do site começa por aí, entende o mapa, decide o que ler. É o equivalente a um sitemap mas otimizado para consumo de modelo, não de motor de busca tradicional.

### 4. Servidor MCP nativo

A 2aFinder expõe um **servidor MCP** (Model Context Protocol, padrão da Anthropic) que agentes IA podem conectar diretamente — Claude Desktop, Cline, ou qualquer cliente MCP. Em vez de fazer scraping de página HTML, o agente faz chamada estruturada (`buscar_produto`, `comparar_ofertas`, `validar_cupom`) e recebe JSON tipado e versionado. É a diferença entre conversar com a 2aFinder versus ler a 2aFinder.

A combinação dessas quatro camadas significa que a 2aFinder funciona em **três modos simultâneos**:

- **Modo humano**: site renderizado, navegação visual, ranking ordenado, cards interativos.
- **Modo crawler tradicional** (Google, Bing): SSR + Schema.org + sitemap = SEO 100.
- **Modo LLM**: `.md` mirrors + `llms.txt` + MCP = consumível por agente sem fricção.

A regra arquitetural está em `CLAUDE.md` do projeto, regra 6 e 7: "SSR puro nas páginas de produto" e "`.md` mirror + `llms.txt` em todo conteúdo público". Não é feature opcional — é piso.

## Implicações práticas para o usuário

O que muda na sua experiência:

- **Quando você pergunta a um agente IA "qual notebook comprar", a 2aFinder aparece nas fontes.** Porque o agente conseguiu ler. Porque a citação tem schema correto. Porque há um caminho otimizado pra IA chegar até nós.
- **Você pode conectar a 2aFinder direto no seu Claude Desktop ou agente compatível.** Em vez de abrir o navegador, perguntar, copiar link, voltar — o agente busca direto. A vitrine vira ferramenta.
- **Citações são consistentes.** Quando vários agentes IA leem o mesmo dado da 2aFinder (via MCP ou `.md` mirror), a resposta tende a convergir, em vez de divergir como acontece quando cada agente faz scraping diferente do mesmo HTML.
- **Você é dono da pergunta, não do navegador.** A interface começa a importar menos. O que importa é se o dado é confiável, fresco e estruturado. 2aFinder otimiza pra isso.

## Perguntas frequentes

**O que é MCP exatamente?**
Model Context Protocol — um padrão aberto criado pela Anthropic em 2024 para que agentes IA conversem com ferramentas externas de forma estruturada e tipada. É a alternativa moderna a "plugin proprietário". Funciona com Claude Desktop, Cline, e clientes compatíveis. A 2aFinder expõe um servidor MCP em `apps/mcp/` no monorepo.

**`llms.txt` é padrão oficial?**
É proposta emergente (2024-2025), ainda não ratificada como padrão formal — mas adotada por sites técnicos relevantes (Anthropic, Cloudflare, vários comparadores estrangeiros). Adotar cedo não custa nada e posiciona a 2aFinder para quando virar default.

**`.md` mirror não duplica conteúdo? Google penaliza?**
Não. O `.md` é declarado como formato alternativo via header HTTP (`Link: rel="alternate"`) e canonical aponta sempre pro HTML. Google entende. LLMs preferem `.md`. Sem conflito.

**Vocês não temem que LLMs "roubem tráfego" da 2aFinder?**
Tráfego direto é uma das fontes de valor, mas **citação confiável é outra**. Quando o agente IA recomenda um produto e cita 2aFinder como fonte, o usuário aprende que 2aFinder é confiável — e na próxima compra de maior valor (onde quer ver com os próprios olhos), volta direto. Vitrine LLM é construção de marca de longo prazo. E o link de afiliado segue funcionando: o agente cita 2aFinder, usuário clica, compra acontece.

**E privacidade? LLMs estão sendo treinados nos dados da 2aFinder?**
Conteúdo público pode ser usado para treino — é a natureza da web aberta. Conteúdo de usuário (busca, conta, histórico de clique) nunca aparece em conteúdo indexável. A separação é arquitetural: SSR público é uma coisa, dados de usuário são outra, em rotas autenticadas que `llms.txt` exclui explicitamente.

**Quando o servidor MCP fica disponível para o público?**
O servidor já existe em desenvolvimento (`apps/mcp/` no repositório). Disponibilização pública é parte do pacote de soft launch (T-039 no backlog), depois da validação operacional do MVP real.

## Glossário

- **Vitrine LLM-first**: princípio 2aFinder de tratar consumo por agente IA como caso de uso primário, não secundário. Toda decisão arquitetural considera "como um LLM lê isso?".
- **MCP** (Model Context Protocol): padrão aberto da Anthropic para integração estruturada entre agente IA e ferramentas externas. 2aFinder expõe servidor MCP em `apps/mcp/`.
- **SSR puro**: server-side rendering sem hidratação obrigatória. Página abre sem JS, dados estão no HTML.
- **JSON-LD**: formato de dados estruturados (Schema.org) embutido em `<script type="application/ld+json">`. Padrão para Product, Offer, etc.
- **`.md` mirror**: espelho em Markdown da página HTML, acessível pela mesma URL com sufixo `.md`. Formato nativo de consumo LLM.
- **`llms.txt`**: arquivo na raiz do site que lista URLs principais e descrições para consumo de LLM. Análogo ao `robots.txt`, dirigido a agentes.
- **Lighthouse SEO 100**: nota máxima da auditoria de SEO técnico do Google Lighthouse. 2aFinder trata como piso, não meta.