Como escrever um userscript com IA

O que é um userscript

Um userscript é um pequeno programa em JavaScript que roda nos sites que você escolher, depois que a página carrega. Ele pode adicionar um botão, ocultar um painel, reformatar uma tabela, preencher um formulário ou exportar dados. Userscripts existem há mais de vinte anos, executados por gerenciadores como Greasemonkey, Violentmonkey e Tampermonkey. A novidade é que você não precisa mais escrevê-los.

Como um userscript é montado

Todo userscript começa com um cabeçalho, um bloco de comentários que diz ao gerenciador o que é o script e onde rodá-lo:

// ==UserScript==
// @name         Copy title as Markdown
// @match        https://example.com/*
// @grant        none
// ==/UserScript==

• @name é o rótulo que você vai ver no gerenciador.
• @match diz em quais páginas o script roda. O asterisco corresponde a qualquer coisa, então a linha acima significa todas as páginas de example.com.
• @grant lista capacidades especiais que o script precisa do gerenciador, como guardar valores ou fazer requisições a outros sites. none significa que ele não precisa de nenhuma.

Abaixo do cabeçalho vem JavaScript comum que trabalha com a página: encontrar o título principal, criar um botão e copiar texto quando o botão é clicado.

O jeito manual: um assistente de chat e um gerenciador

O jeito comum de ter um userscript escrito por IA:

1. Instale um gerenciador de userscripts, como o Tampermonkey, pela Chrome Web Store.
2. Peça ao ChatGPT, ao Claude ou ao Gemini um userscript que faça o que você quer no site.
3. Crie um script novo no gerenciador, cole o código e salve.
4. Recarregue o site e veja se funciona.

Para scripts simples, muitas vezes funciona. O problema começa no passo 4. O assistente nunca viu a página. Ele precisa adivinhar como o título, a lista ou o botão de que você fala se chamam no código da página, e sites modernos usam nomes gerados que ninguém conseguiria adivinhar. O script roda, não encontra nada e não faz nada, sem nenhum erro visível. Aí você copia pedaços do código da página para o chat, explica o que deu errado, cola a nova versão e tenta de novo. Várias rodadas são normais.

O Chrome agora também pede mais um passo. Desde as mudanças nas extensões, os gerenciadores de userscripts precisam ter Permitir scripts de usuário (Allow user scripts) ativado em chrome://extensions, nos Detalhes da extensão, antes de os scripts rodarem.

Deixe permanente com uma ferramenta

A solução é deixar a IA ver a página. O ScriptPanda é uma extensão do Chrome que escreve userscripts a partir de uma descrição simples enquanto você está na página. Quando você envia um pedido, ele manda suas palavras, o endereço da página e um esboço reduzido da estrutura dela, não uma captura de tela nem a página inteira, para conseguir encontrar o título, a lista ou o botão de verdade. Depois ele escreve o script, instala na página e roda, então você vê na hora se ele faz o que você pediu.

Cole o pedido do fim deste guia em qualquer página de artigo e você terá um botão Copiar título ao lado do título. Se algo não estiver certo, diga o que está errado e o ScriptPanda muda o script. Se você sabe JavaScript, pode abrir o código de qualquer ferramenta no editor e mudar você mesmo.

O ScriptPanda precisa do Chrome 138 ou mais recente e, como outros gerenciadores, de Permitir scripts de usuário ativado para ele.

Limites

Um userscript roda dentro da página, no seu navegador, enquanto a página está aberta. Ele não roda em segundo plano, em horários agendados nem com o Chrome fechado, e trabalha com um site por vez. O ScriptPanda cria uma ferramenta por página e não importa nem roda scripts existentes do Tampermonkey, então ele não substitui o gerenciador dos scripts que você já tem. Se o site mudar o layout, um script pode parar de encontrar o que precisa. Abra o ScriptPanda na página, diga o que quebrou e peça para ele ajustar a ferramenta.