squirrelscan: deixar um agente auditar sites com o CLI oficial

Para quem

Este guia destina-se a quem vai entregar auditorias de site a um agente e aceita que cada skill é conduzida pelo squirrel CLI. Oficialmente está escrito como skills de auditoria de site, plugins e MCP para agentes, no mesmo repositório:

https://github.com/squirrelscan/skills

O material atual só desenvolve duas skills. squirrelscan opera o CLI: instalar, iniciar sessão, correr auditorias, publicar relatórios, créditos, chaves de API, ajuste MCP, configuração e resolução de problemas. Notas em

https://github.com/squirrelscan/skills/blob/main/skills/squirrelscan/SKILL.md

audit-website é o ciclo de correção: auditar um site, mapear achados para código, alterar em lotes e voltar a auditar até a pontuação melhorar. Notas em

https://github.com/squirrelscan/skills/blob/main/skills/audit-website/SKILL.md

Serve quando se consegue instalar o CLI e só se auditam sites que se tem direito a inspecionar. Não serve se o CLI não está no PATH ou se se querem as skills só como documentos sem CLI.

Concluir uma primeira tentativa em 3 minutos

Seguir só o caminho oficial recomendado.

Pré-condição: esta máquina consegue executar npx e o squirrel CLI está instalado e no PATH. O material diz que todas as skills conduzem esse CLI, mas não dá o comando de instalação do próprio CLI. Se squirrel ainda não está no PATH, deixar primeiro a skill squirrelscan tratar da instalação e da sessão; não saltar para o scan.

Local de instalação: tratado por npx skills add. O material não escreve o ponto de aterragem da pasta da skill; não inventar um caminho que não apareceu.

Copiar e executar:

npx skills add squirrelscan/skills

Sucesso: o comando termina normalmente. Primeiro uma confirmação só de leitura: pedir ao agente para verificar se squirrel está no PATH e explicar os passos de uma auditoria, sem fazer scan de qualquer URL, publicar relatório ou alterar código. Se conseguir repetir que é preciso o CLI e que sessão / auditoria / publicação são ações separadas, a skill está carregada.

Antes de um scan real, confirmar o URL alvo e o direito de auditar. Scan, publicar relatório e escrever código têm efeitos.

Casos de uso

Caso 1: operar só o CLI; iniciar sessão primeiro e depois decidir se audita. Corresponde a squirrelscan. Serve quando ainda não se correu um scan e só se quer confirmar instalação, sessão, configuração e créditos. Sucesso: o CLI é utilizável e o estado de sessão está claro. O material também menciona MCP alojado:

https://mcp.squirrelscan.com/mcp

Usa streamable-http e pode usar OAuth ou uma chave Authorization: Bearer sq_...; em local é squirrel mcp. A primeira tentativa não precisa de ligar MCP. Não inventar uma chave completa.

Caso 2: após a auditoria, relacionar com código, mas parar no mapeamento. Corresponde ao ciclo de correção de audit-website. Serve quando o CLI já corre e se quer ver em que ficheiros caem os problemas de um site confirmado. Auditar primeiro e pedir só a correspondência achados-para-código; proibir explicitamente alterações em lotes. Sucesso: vê-se a correspondência problema–ficheiro e o repositório ainda não mudou. Depois de confirmar o âmbito do patch, permitir lotes e um novo teste. O material não dá limiar de pontuação nem tamanho de lote.

Limites de uso

O material atual só prova as duas skills acima e um comando de instalação npx. Não inventar outros nomes de skills nem mudar para um instalador que não apareceu. O material não nomeia nenhum cliente obrigatório.

Não invocar estas skills sem o CLI. Publicar um relatório envia resultados para fora desta máquina; alterar código escreve o repositório. Verificar primeiro, depois autorizar. O prefixo de chave no material é sq_...; não inventar uma chave de exemplo. Para mais, seguir o repositório oficial:

https://github.com/squirrelscan/skills