ExtensionDash: rastreando uma extensão de navegador a partir do seu agente

Depois de lançar duas extensões de navegador este ano — Pesquisa de Imagem Reversa em Qualquer Lugar e Stackpeek — eu ainda não conseguia responder à pergunta mais simples sobre uma listagem: está funcionando?

Ambas as lojas informam quantas pessoas instalaram a extensão. Nenhuma delas informa o número que decide se alguém a instala ou não: onde você aparece quando alguém pesquisa as palavras que realmente digitariam. O painel de desenvolvedor da Chrome Web Store não tem noção da posição de busca. O do Firefox não é melhor. Então, a resposta honesta para "a mudança de título da semana passada ajudou?" era abrir uma janela anônima, digitar a palavra-chave e contar os resultados com o dedo. Em três idiomas.

Então eu construí ExtensionDash. Ele coleta dados de ambas as lojas todas as noites e registra instalações, avaliações, classificação de categoria, posições de palavras-chave, concorrentes e cópia da listagem — e mantém o histórico.

A decisão que importava

Não o scraper. Foi fazer do agente um leitor de primeira classe em vez de um botão de exportação.

POST /mcp fala o Protocolo de Contexto de Modelo sobre HTTP sem estado, autenticado com um token por usuário. Quinze ferramentas; onze leem, e as quatro que escrevem não podem deletar o histórico registrado. Tudo que o painel exibe, um agente pode ler.

Essa parte funciona na maioria das vezes. O que realmente exigiu reflexão é que um agente precisa que a ausência seja legível, e uma página da web não.

Um humano vendo uma célula em branco lê isso a partir do contexto: ainda carregando, nova linha ou genuinamente nada. Um agente recebe um documento JSON com um null nele, e um null é uma coisa maravilhosamente confiante para resumir como um zero. "Sua extensão não classifica para esta palavra-chave" e "ninguém olhou ainda" são fatos opostos, e uma ferramenta que retorna a mesma forma para ambos fará com que um seja narrado como o outro para um usuário que acredita nisso.

Assim, três estados permanecem distintos: nunca escaneado, escaneado e encontrado, escaneado mas ausente. add_keyword relata se uma busca foi realmente enfileirada e nomeia as ferramentas a serem consultadas. list_scrape_runs revela uma busca falhada como uma falha em vez de uma posição que silenciosamente nunca chega.

Mesma intuição por trás do campo ao qual estou mais ligado: cada posição viaja com a profundidade que foi escaneada. #1 de 9 e #1 de 50 são resultados diferentes. Relatar "você classifica #12" enquanto omite que a busca parou em 50 é como uma ferramenta mente por aritmética em vez de por engano.

Histórico que você não pagou

Cada busca de palavra-chave noturna já escaneia cinquenta resultados, então todos os cinquenta são registrados. add_competitor promove um — o que lhe garante uma busca de listagem, e portanto uma descrição, instalações e uma avaliação — mas as classificações já estão lá. Um concorrente que você adiciona hoje chega com histórico de classificação desde o dia em que você começou a rastrear a palavra-chave. Você pode perguntar "quando eles me ultrapassaram?" sobre alguém que você não havia pensado até esta manhã.

Stack é propositadamente sem destaque: Rails 8, Postgres, Solid Queue com trabalho de navegador em sua própria fila de thread única, Nokogiri e Ferrum para Chrome, a API pública AMO para Firefox. Kamal de um laptop.

O beta

Aberto, gratuito, sem cartão, em extensiondash.com. Os limites são três extensões por conta e quinze palavras-chave por extensão, porque uma palavra-chave é uma sessão de navegador noturna em perpetuidade — não porque há um nível pago por trás delas.

O que eu mais gostaria que as pessoas experimentassem é a parte que não posso avaliar sozinho: conecte-o ao seu agente e pergunte algo real.

claude mcp add --transport http extensiondash https://extensiondash.com/mcp \
  --header "Authorization: Bearer <seu token>"

O token e um comando pronto para colar estão na página de Ajuda. Então pergunte ao seu agente por que uma extensão caiu na classificação na semana passada, ou o que um concorrente mudou — e me diga onde ele trava, o que ele adivinha e o que ele busca que não está lá. Eu desenhei essas quinze ferramentas pensando sobre o que um agente precisaria. Raciocinar sobre isso não é o mesmo que assistir acontecer.

Qualquer outra coisa que você encontrar, eu quero também: anton@kopylov.net.