Propaganda é a alma do negócio! O SEO trata isso desde que entendemos que aparecer para os buscadores é parte ativa no sucesso de um empreendimento. Com os agentes de IA participando em mais da metade dos acessos em um site, a corrida agora é ser visível para eles.
Já tratei de algumas técnicas anteriormente, mas hoje quero falar sobre o WebMCP, e como estudando sobre ele eu criei, de uma vez só, meu primeiro pacote público no npm e meu primeiro plugin para Astro.
O que é WebMCP?
WebMCP é uma proposta do time do Chrome que permite sites declararem tools para agentes de IA. Pense nele como um contrato: o site diz “eu tenho estas capacidades disponíveis para agentes” e qualquer agente compatível sabe exatamente como interagir.
Em vez de crawlear e adivinhar, o agente lê um manifesto e descobre que pode buscar conteúdo, listar seções, navegar para páginas específicas. Tudo tipado, documentado, previsível.
É progressive enhancement puro — browsers sem suporte nem percebem que existe.
Tip
WebMCP está em validação no Chrome 149+. O padrão ainda é proposta, mas a direção é clara: sites que declaram capacidades para agentes vão ter vantagem na era da IA agêntica.
Por que um plugin para Astro?
Tenho usado Astro em quase todos os meus projetos. É rápido, flexível, e os agentes de IA sabem programar para ele naturalmente. Para que meus sites tivessem suporte a WebMCP, eu precisaria integrar manualmente ou usar algum plugin pronto.
Pesquisei. Não achei nenhum.
Foi aí que decidi criar um. O Astro é baseado em Node.js, e para que a instalação seja simples para qualquer pessoa, o plugin precisa estar publicado no npm. Foi assim que acabei publicando meu primeiro pacote e criando meu primeiro plugin para Astro — tudo na mesma sessão.
O que o plugin faz
O astro-webmcp automatiza três coisas:
No build — escaneia todas as páginas geradas pelo Astro, extrai metadados (título, descrição, seção, URL) e gera um manifesto JSON em /_webmcp/manifest.json.
No runtime — injeta um script leve (~1KB) que registra tools via a API WebMCP do browser. O script usa feature detection e não executa nada em browsers sem suporte.
4 tools registrados:
| Tool | O que faz |
|---|---|
search_content | Busca por termo no conteúdo indexado |
list_sections | Lista todas as seções/categorias do site |
go_to | Navega para uma página específica pelo slug |
get_page_info | Metadados da página atual (título, headings, descrição) |
O agente não precisa crawlear 500 páginas para encontrar o que quer. Ele chama search_content("astro deploy") e recebe os resultados em milissegundos.
Como instalar
Duas linhas:
npm install astro-webmcpimport webmcp from 'astro-webmcp'
export default defineConfig({ integrations: [webmcp()]})Próximo build, manifesto gerado, tools disponíveis.
Resultados reais
Coloquei em produção em dois sites no mesmo dia:
- ft.ia.br — 129 páginas indexadas. Este blog.
- designmd.app — 509 páginas indexadas. Referência de design systems para IA.
Validei no Chrome 149 com a flag chrome://flags/#enable-webmcp-testing habilitada. O browser reconhece os tools e agentes conseguem chamá-los.
Resultado: 509 páginas. Busca instantânea. Nenhum endpoint manual.
Segurança
Decisão de design intencional: o plugin só expõe o que já está público. Se uma página existe no HTML gerado, ela aparece no manifesto — exatamente como o sitemap.xml já faz.
- Páginas de admin? Não expostas.
- Rotas autenticadas? Não expostas.
- Drafts? Não expostos.
Nenhuma superfície de ataque nova. O manifesto WebMCP é equivalente ao sitemap — mesmo conteúdo, interface diferente.
O que vem a seguir
Três coisas no roadmap:
- Astro Integrations Directory — keywords já configuradas, deve aparecer no catálogo oficial na próxima varredura semanal
- Landing page dedicada — com playground interativo para testar tools ao vivo
- Busca full-text — hoje busca por metadados; próxima versão indexa conteúdo completo via Pagefind
Marco pessoal
Primeiro pacote npm público. Depois de anos consumindo open source, contribuir de volta com algo que resolve um problema concreto é gratificante.
Tip
Se você tem um site Astro com conteúdo relevante, instale. Quando WebMCP virar padrão nos browsers, seu site já vai estar pronto.
Links:
- npm: npmjs.com/package/astro-webmcp
- GitHub: github.com/fabricioctelles/astro-webmcp
- Spec WebMCP: webmachinelearning.github.io/webmcp
- Chrome docs: developer.chrome.com/docs/ai/webmcp