--- title: "NLWeb, A2A e OpenAPI: quando um site precisa disso | Grupo Marfre" description: "NLWeb, A2A e OpenAPI explicados em poucas linhas: quem precisa de cada um e por que site de conteúdo não deve perseguir esses checks do is-agentic." canonical: https://grupomarfre.com.br/sites-agenticos/nlweb-a2a-e-especificacoes/ alternate_html: https://grupomarfre.com.br/sites-agenticos/nlweb-a2a-e-especificacoes/ language: pt-BR last_updated: 2026-10-27 type: guia --- # NLWeb, A2A e OpenAPI: quando um site precisa disso **Resposta rápida:** NLWeb, A2A e OpenAPI servem a quem oferece API ou serviço que um agente de IA aciona: OpenAPI descreve a API, A2A deixa agentes conversarem entre si e NLWeb cria um ponto de perguntas em linguagem natural. Num site de conteúdo, esses checks ficam fora dos elegíveis do is-agentic, e a régua do Grupo Marfre é não persegui-los. OpenAPI, A2A e NLWeb são padrões para quem tem algo que um agente de IA possa **acionar**: uma API, um serviço, um catálogo consultável por máquina. Um site de conteúdo (clínica, escritório, loja de bairro com página institucional) não tem nada disso para expor, e a ausência não é defeito. O erro a evitar é abrir um relatório de scanner, ver esses itens em amarelo ou vermelho e tratá-los como pendência. Esta página explica o que cada sigla faz, dá um critério de decisão e mostra um caso medido em que uma única palavra no endereço de uma página derrubou uma nota 100 para 79. ## O que são OpenAPI, A2A e NLWeb? **OpenAPI** é um formato de arquivo que descreve uma API: quais endereços existem, o que cada um recebe e o que devolve, e como são os erros. Um agente lê esse arquivo e sabe chamar o serviço sem adivinhar. **A2A** (Agent2Agent) é um protocolo para agentes de IA conversarem entre si. Faz sentido quando você opera um agente próprio e quer que outros agentes deleguem tarefas a ele. **NLWeb** é uma proposta aberta para dar a um site um ponto de perguntas em linguagem natural: o agente pergunta em texto e o site responde a partir do próprio conteúdo ou catálogo. Exige um serviço rodando, com índice e manutenção. Os três têm um ponto em comum: precisam de algo funcionando do outro lado. Publicar o arquivo sem o serviço real é só ruído. ## Quem precisa de cada um? | Padrão | Faz sentido quando você... | Site de conteúdo precisa? | | --- | --- | --- | | OpenAPI | tem API pública e documentada que terceiros ou agentes chamam | Não | | A2A | opera um agente que outros agentes acionam | Não | | NLWeb | quer manter um endpoint de perguntas sobre um acervo grande de conteúdo ou catálogo | Não | O critério é uma pergunta só: **existe uma ação que um agente executaria aqui sem passar por uma página?** Cotar, agendar, consultar estoque, emitir segunda via. Se a resposta é sim e já existe uma API por trás, OpenAPI é o primeiro passo, e o caso de [software e SaaS](https://grupomarfre.com.br/sites-agenticos/site-agentico-para-software-e-saas/) pode cair aqui. Se a resposta é não, o que importa é o texto legível, o [llms.txt](https://grupomarfre.com.br/sites-agenticos/llms-txt/) e o [espelho em Markdown](https://grupomarfre.com.br/sites-agenticos/espelho-markdown-por-pagina/). Para agentes que fazem compras, veja [quando a IA compra no seu site](https://grupomarfre.com.br/sites-agenticos/agentes-que-compram/). ## O que o is-agentic faz com um site de conteúdo? O is-agentic.com, ferramenta da Vercel com o scanner da Ora, detecta o perfil do site e pontua só os checks elegíveis para esse perfil. Para site de conteúdo, segundo a medição do Grupo Marfre, pontua 16 checks elegíveis: 6 essenciais (80 pontos) e 10 recomendados (20 pontos), mais bônus de até 5. O catálogo completo da Ora tinha 132 checks em 20/10/2026, incluindo MCP, OAuth, API e pagamentos, e ela marca N/A o que não se aplica. Na medição do Grupo Marfre, um site de conteúdo com 100 no is-agentic ainda aparece em warning ou fail nos itens que não são dele: presença na Wikipedia, MCP, OAuth, OpenAPI, A2A, NLWeb e preço. O ranker completo da Ora fica em cerca de 70 para clínica justamente por isso. A régua do Grupo Marfre é não perseguir esses itens. Para ler a nota sem se enganar, veja [como ler o is-agentic](https://grupomarfre.com.br/sites-agenticos/is-agentic/) e as [4 armadilhas](https://grupomarfre.com.br/sites-agenticos/armadilhas-do-is-agentic/). ## Como uma palavra no caminho derrubou a nota de 100 para 79? Foi um caso medido nos sites que o Grupo Marfre publica. A palavra "api" apareceu no **caminho** de uma página listada no llms.txt, até dentro de outra palavra. O scanner passou a enxergar o site como se ele tivesse API: os checks elegíveis foram de 16 para 23 e a nota caiu de 100 para 79, porque ele começou a cobrar OpenAPI e erro em JSON. O site não tinha ganhado API nenhuma: mudou só o perfil que o scanner detectou. O conserto foi trocar o slug da página e manter um [redirecionamento 301](https://grupomarfre.com.br/sites-agenticos/redirecionamentos-301/) do endereço antigo. Exemplo fictício de caminho que traz "api" dentro de outra palavra: `/servicos/terapia/`, onde "terapia" contém "api". Pela descrição do caso, é esse tipo de coincidência que engana o detector. ## Como conferir o seu site em 3 passos? 1. Procure "api" nos endereços do llms.txt: ```bash curl -s https://www.exemplo.com.br/llms.txt | grep -ioE 'https?://[^ )]*api[^ )]*' ``` 2. Se aparecer algo que não é uma API de verdade, troque o slug da página e crie o 301 do endereço antigo para o novo. Atualize o llms.txt e o sitemap. 3. Peça um scan novo (botão Rescan ou `force=1`). O relatório é cacheado: sem scan novo, o is-agentic devolve a nota antiga. Há cache de frescor de 6 horas, limite de 10 scans por minuto por IP e orçamento diário, e o relatório pode chegar de 5 a 10 minutos depois do disparo. ## Nota alta resolve a presença na IA? Não. Na medição do Grupo Marfre, um consultório com nota 100 teve zero citação em 5 perguntas no Perplexity (rodada de 12/10/2026). A nota mede se o site está pronto para agentes, não se a IA cita. Detalhes em [nota 100 não é citação](https://grupomarfre.com.br/sites-agenticos/nota-100-nao-e-citacao/). ## Perguntas frequentes ### Meu site tem formulário de contato. Preciso de OpenAPI? Não. Formulário é uma página para humanos, não uma API que agentes chamam. OpenAPI só entra se existir um serviço por trás, com endereços e respostas bem definidos. ### O NLWeb ajuda a ser citado pelo ChatGPT ou pelo Google? O Grupo Marfre não tem medição que ligue NLWeb a citação em site de conteúdo, e não há promessa possível nesse sentido. Para a Visão Geral por IA do Google, o próprio Google diz que não exige arquivo ou markup especial. ### Devo ignorar todo item N/A, warning ou fail do is-agentic? Ignore os que não se aplicam ao seu tipo de negócio, como OpenAPI, A2A e NLWeb num site de conteúdo. Os checks essenciais do seu perfil continuam valendo, então corrija esses primeiro. ### Uma mudança no site pode alterar o perfil detectado pelo scanner? Pode. No caso medido, só o caminho de uma página com "api" mudou o perfil e a nota. Depois de qualquer ajuste em endereços ou no llms.txt, rode um scan novo e compare o número de checks elegíveis. ## Leia também ### [MCP (Model Context Protocol): seu site precisa de um servidor MCP?](https://grupomarfre.com.br/sites-agenticos/mcp-para-sites/) MCP (Model Context Protocol) para sites: o que é, por que site de conteúdo e negócio local não precisam e quando SaaS, loja e agenda online passam a precisar. ### [WebMCP e ai-catalog.json: os padrões novos de agentes no navegador](https://grupomarfre.com.br/sites-agenticos/webmcp-e-ai-catalog/) WebMCP e ai-catalog.json no Lighthouse 13.3+ e 13.5: o que a auditoria checa, quando vale para site com ação e o que fazer no site institucional. ### [is-agentic.com: o que mede e como ler a nota](https://grupomarfre.com.br/sites-agenticos/is-agentic/) is-agentic.com mede se o site está pronto para agentes de IA. Veja como a nota é composta, por que o número de checks varia e como pedir scan novo. ### [is-agentic: 4 armadilhas que enganam quem lê a nota](https://grupomarfre.com.br/sites-agenticos/armadilhas-do-is-agentic/) is-agentic: 4 armadilhas na leitura da nota: relatório cacheado, scan em sequência, palavra api no caminho e soft 404. Veja como evitar cada uma. ### [Nota 100 não é citação: o que a medição de agente prova](https://grupomarfre.com.br/sites-agenticos/nota-100-nao-e-citacao/) Nota máxima no is-agentic e no Lighthouse prova que o site está pronto para agentes, não que a IA vai citar. Veja o caso medido e o que acompanha a citação. ### [Cabeçalho Link (RFC 8288): como o agente descobre a versão em Markdown](https://grupomarfre.com.br/sites-agenticos/cabecalho-link-rfc-8288/) Cabeçalho Link (RFC 8288): como apontar o espelho .md, o llms.txt e o sitemap por HTTP, com formato, exemplo e teste com curl, sem baixar o HTML. --- ## Sobre o Grupo Marfre Grupo Marfre Automação e Tecnologia LTDA (CNPJ 49.685.676/0001-55): agência de marketing digital e inteligência artificial com base em Contagem/MG, que atende o Brasil inteiro de forma remota. - Endereço: Alameda das Cotovias, 75, Cabral, Contagem - MG, Brasil - WhatsApp: (31) 93618-7272, https://wa.me/5531936187272 - E-mail: contato@grupomarfre.com.br - Instagram: https://instagram.com/marfregrupo - Serviços: gestão de tráfego pago (Meta Ads e Google Ads), site agêntico (site pronto pra assistentes de IA lerem), site que vira contato, SEO e Google, IA no WhatsApp, CRM e automação - Serviço de site agêntico: https://grupomarfre.com.br/servicos/site-agentico/ · serviço de gestão de tráfego: https://grupomarfre.com.br/servicos/gestao-de-trafego/ - Guias: https://grupomarfre.com.br/sites-agenticos/ e https://grupomarfre.com.br/gestao-de-trafego/ - Método em 4 etapas: Diagnóstico, Estratégia, Execução, Otimização - Segmentos já atendidos: clínica, consultório, advocacia, loja, igreja - Preço e escopo não são publicados: são definidos por diagnóstico, caso a caso - Todas as páginas em Markdown: https://grupomarfre.com.br/llms.txt · conteúdo completo: https://grupomarfre.com.br/llms-full.txt Página HTML equivalente: https://grupomarfre.com.br/sites-agenticos/nlweb-a2a-e-especificacoes/