Repolode
tamnd

tamnd/kage

Uma CLI em Go que clona sites para uma pasta com HTML sem scripts, pronto para navegar offline, renderizando as páginas primeiro no Chrome headless.

Alternativa open source a:HTTrackEvernote Web Clipper

Estrelas
3,485
Forks
135
Issues abertas
9
Último commit
há 2 meses

O que é?

kage clona um site para uma pasta local que você pode navegar offline. Ele abre cada página no Chrome headless, espera o carregamento terminar, captura o DOM como um usuário o veria e, em seguida, remove todo o JavaScript e baixa CSS, imagens e fontes para caminhos locais. Os arquivos .html resultantes abrem diretamente do disco e não executam código.

A varredura é feita em largura e respeita o robots.txt; também pode começar pelo sitemap.xml e ser limitada por profundidade, número de páginas, prefixo de caminho ou subdomínios. Varreduras interrompidas podem ser retomadas a partir do estado salvo, e uma nova execução com refresh atualiza um espelho existente no próprio local.

Um espelho concluído pode ser servido com um servidor estático integrado, empacotado em um único arquivo ZIM legível pelas ferramentas do Kiwix ou transformado em um executável independente que serve o site ao ser iniciado. O empacotamento também pode gerar um pacote .app para macOS ou um iniciador no estilo AppImage para Linux; uma compilação opcional com webview abre o site em uma janela nativa.

Recursos principais

  • 01Renderiza páginas no Chrome headless e salva o DOM final sem scripts.
  • 02Baixa e ajusta os caminhos de CSS, imagens e fontes para que as páginas funcionem offline.
  • 03Respeita o robots.txt e pode começar pelo sitemap.xml.
  • 04Retoma varreduras interrompidas e permite atualizar o espelho no próprio local.
  • 05Empacota espelhos em um arquivo ZIM ou em um executável independente.
  • 06Disponibiliza binários pré-compilados, imagem Docker e pacotes para Linux.

Casos de uso

  • Manter uma cópia de um blog ou site de documentação para ler offline em um avião ou sem Wi-Fi.
  • Arquivar uma página cuja versão online pode mudar ou desaparecer.
  • Compartilhar com outra pessoa uma captura estática de um site em um único arquivo.
  • Criar um visualizador offline de um site para desktop, que possa ser aberto com um clique duplo.

Início rápido

  1. 1

    Instale o kage com Go

    go install github.com/tamnd/kage/cmd/kage@latest
  2. 2

    Clone um site em uma pasta local

    kage clone paulgraham.com
  3. 3

    Navegue pelo clone offline no navegador em http://127.0.0.1:8800

    kage serve $HOME/data/kage/paulgraham.com

Antes de usar

  • É necessário ter o Chrome ou Chromium instalado no host, a menos que você use a imagem de contêiner.
  • Os binários empacotados ocupam cerca de 13 MiB, além do site, pois incluem toda a ferramenta kage.
  • A janela WebView nativa requer cgo e o WebView da plataforma, por isso é opcional.

Tópicos

Perguntas frequentes

O que é kage?
Uma CLI em Go que clona sites para uma pasta com HTML sem scripts, pronto para navegar offline, renderizando as páginas primeiro no Chrome headless. kage clona um site para uma pasta local que você pode navegar offline. Ele abre cada página no Chrome headless, espera o carregamento terminar, captura o DOM como um usuário o veria e, em seguida, remove todo o JavaScript e baixa CSS, imagens e fontes para caminhos locais. Os arquivos .html resultantes abrem diretamente do disco e não executam código.
kage é gratuito? Qual é a licença?
kage é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
kage ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de kage foi em 10 de ago. de 2026.
Para que posso usar kage?
Manter uma cópia de um blog ou site de documentação para ler offline em um avião ou sem Wi-Fi. Arquivar uma página cuja versão online pode mudar ou desaparecer. Compartilhar com outra pessoa uma captura estática de um site em um único arquivo. Criar um visualizador offline de um site para desktop, que possa ser aberto com um clique duplo.
Como instalar kage?
Instale o kage com Go: go install github.com/tamnd/kage/cmd/kage@latest Clone um site em uma pasta local: kage clone paulgraham.com Navegue pelo clone offline no navegador em http://127.0.0.1:8800: kage serve $HOME/data/kage/paulgraham.com
Onde consigo kage?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/tamnd/kage

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados