FAQ

Instalação, Chrome e renderização JavaScript, robots.txt em 5xx, antigos ficheiros .json, privacidade, utilização responsável e onde perguntar.

O Arachnide é mesmo gratuito?

Sim. O Arachnide SEO Spider é publicado sob licença MIT: pode usá-lo, modificá-lo e partilhá-lo livremente, incluindo em trabalho comercial. Não há nível pago, chave de licença nem conta. Os únicos custos que pode optar por pagar são os dos serviços de terceiros que você próprio liga: uma chave de API da Anthropic ou da OpenAI para as correções por IA, ou um projeto Google Cloud para as API do PageSpeed e do Search Console (gratuitas dentro das suas quotas).

Que sistemas e versões do Node.js são suportados?

macOS, Windows e Linux, com Node.js 18.17 ou mais recente; a suite de testes corre no Node 18, 20 e 22. Instale a LTS atual a partir de nodejs.org e verifique com node -v.

O lançador não abre no macOS

Na primeira vez, clique com o botão direito em start-mac.command e escolha Abrir, porque o macOS bloqueia os scripts não assinados. O lançador instala então as dependências e abre o seu navegador em http://localhost:4000.

Recebo «cd: no such file or directory» ou «npm ERR! enoent … package.json»

Não está na pasta do Arachnide. Use cd seguido do caminho da pasta descomprimida, por exemplo cd ~/Downloads/arachnide-seo-spider, depois npm install e npm start.

«--disable-warning= is not allowed in NODE_OPTIONS»

A sua shell define uma opção que a sua versão do Node não suporta. Execute unset NODE_OPTIONS (macOS, Linux) ou atualize o Node.js para a LTS mais recente. Os lançadores já a removem.

A renderização JavaScript não está disponível

Instale o Google Chrome, o Microsoft Edge, o Chromium ou o Brave. Se o navegador estiver instalado num local pouco habitual, inicie o Arachnide com CHROME_PATH="/path/to/chrome" npm start. O próprio Arachnide não transfere nada: usa o navegador já presente no seu computador através de puppeteer-core.

Algumas páginas não mostram H1 nem conteúdo

O site provavelmente constrói o conteúdo com JavaScript. Ative a Renderização JavaScript em Definições → Renderização e rastreie de novo. O separador JavaScript mostra então o que mudou entre o HTML bruto e o renderizado.

O rastreio para logo: «robots.txt indisponível, tudo proibido»

O robots.txt do site respondeu com um erro 5xx ou não foi possível alcançá-lo. A RFC 9309 exige que um crawler trate isto como proibir tudo, e o Arachnide fá-lo, com um aviso explícito. Se tem a certeza de que está autorizado a rastrear o site, defina robots.txt indisponível → permitir (--robots-unavailable allow na CLI) ou use o modo robots assinalar ou ignorar. Um robots.txt em 4xx, pelo contrário, significa que tudo é permitido.

Os meus rastreios antigos são ficheiros .json; ainda posso abri-los?

Sim. Desde a 3.18 os rastreios são gravados em NDJSON gzip (.jsonl.gz), mas as antigas exportações .json (formatos 1 e 2) são detetadas e continuam a abrir a partir do histórico ou do botão Importar. Os rastreios da 1.x abrem com menos detalhes.

O Arachnide envia os meus dados para algum lado?

Não. A aplicação não tem conta, telemetria nem nuvem; a interface só escuta em 127.0.0.1. Contacta os sites que rastreia, e apenas os serviços que você próprio configura: a Anthropic ou a OpenAI para as correções por IA (o excerto da página necessário para escrever um título ou uma descrição), o seu CMS através do seu conector, as API do Google, o seu servidor SMTP para os alertas. As chaves de API e as credenciais são guardadas cifradas no seu disco (AES-256-GCM) e nunca são devolvidas ao navegador, registadas ou exportadas.

A IA pode alterar o meu site sem mim?

Não. A IA propõe, você revê o antes / depois e aprova, um conector aplica, o Arachnide rastreia de novo para verificar, e cada alteração pode ser anulada a partir do histórico. O modo de simulação está ativo por predefinição e um aviso explícito precede a primeira escrita real. Para os agentes de IA (MCP, REST), as ferramentas de escrita estão assinaladas como consequentes, para que o Claude Code, o Claude Desktop e o ChatGPT peçam permissão, e cada site tem uma política (campos permitidos, tamanho dos lotes, só leitura).

Quantas páginas consegue rastrear?

O orçamento por predefinição é de 500 páginas: aumente-o em Definições → Limites. O Arachnide foi testado num site sintético local de 200 000 páginas e 19,9 milhões de links; consulte Sites grandes para os números medidos e o que esperar na sua máquina.

É um substituto do Screaming Frog?

Cobre o mesmo trabalho, um rastreio de desktop transformado numa auditoria técnica, e acrescenta correções aplicadas ao CMS e ferramentas para agentes de IA, mas não faz tudo o que um produto comercial maduro faz (análise de ficheiros de log, verificação ortográfica, autenticação por formulário…). Consulte a comparação honesta.

O que é a utilização responsável?

Rastreie apenas sites que lhe pertencem ou que está autorizado a auditar. Em sites de clientes, mantenha 2 a 5 pedidos simultâneos e adicione uma pausa em alojamento partilhado; respeite o robots.txt a não ser que tenha um motivo e o direito de fazer o contrário.

Onde comunico um bug ou faço uma pergunta?

Abra uma issue no GitHub com o seu sistema operativo e a versão do Node.js, os passos para reproduzir, o URL que rastreou se for público e o erro mostrado no terminal ou na consola do navegador. Os pull requests são bem-vindos; consulte Sobre.

Versão 3.21.0 As tabelas de referência e o registo de alterações são gerados a partir do repositório do Arachnide (commit f287355). Editar esta página no GitHub