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.
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.
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.
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 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:
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.
Duas linhas:
npm install astro-webmcpimport webmcp from 'astro-webmcp'export default defineConfig({
integrations: [webmcp()]
})
Próximo build, manifesto gerado, tools disponíveis.
Coloquei em produção em dois sites no mesmo dia:
ft.ia.br — 129 páginas indexadas. Meu 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.
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.
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 indexará conteúdo completo via Pagefind
Primeiro pacote npm público. Depois de anos consumindo open source, contribuir de volta com algo que resolve um problema concreto é gratificante.
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:
Spec WebMCP: webmachinelearning.github.io/webmcp
Chrome docs: developer.chrome.com/docs/ai/webmcp
Nenhuma publicação
Comments
Nothing yet. Say the first thing.
Sign in to join the conversation.