Captura de página Latchshot

Use o cliente incluso e sem dependências para transformar uma URL pública de página da web em um PNG, JPEG ou PDF local validado. Comece com uma demonstração JPEG restrita sem chave quando apropriado. Comandos autenticados enviam a chave da API apenas para a origem fixa https://latchshot.fly.dev, e cada artefato é gravado atomicamente.

Latchshot é um serviço hospedado de terceiros mantido pelo contribuidor desta skill. Mantenha seu uso opcional e preserve um fluxo de trabalho de navegador local existente quando a tarefa precisar de páginas privadas ou ações de navegador não suportadas.

Pré-requisito

Requer Node.js 20 ou mais novo e acesso à rede. Leia a chave apenas de LATCHSHOT_API_KEY para captura autenticada e comandos de uso.

Se a variável estiver ausente, use a demonstração sem chave para um JPEG limitado quando ele se encaixar na solicitação. Para PNG, PDF, página completa, limpeza ou trabalho repetido, direcione o usuário para a documentação de configuração de Agent Skills e, em seguida, pare. Nunca peça ao usuário para colar uma chave no chat, em um argumento de comando, código-fonte, arquivo commitado ou saída. Nunca imprima ou retorne a chave.

Demonstração sem chave

Use este comando para uma página pública quando um JPEG de viewport for aceitável:

node scripts/latchshot.mjs demo \
  --url 'https://example.com' \
  --output './artifacts/example-demo.jpg'

A demonstração é apenas JPEG, não usa conta nem cota de renderização e permite três tentativas por endereço IP por hora. Ela aceita apenas opções de largura, altura, confirmação de consulta e sobrescrita explícita. A URL pública ainda é enviada para o Latchshot, e a solicitação carrega o rótulo de aquisição agentskill. Rejeite páginas privadas, segredos, URLs assinadas e acesso autenticado exatamente como no fluxo de trabalho de captura. Trate o resultado como um artefato de prova, não como uma ativação de cliente ou inscrição em plano.

Fluxo de trabalho de captura

1. Confirme se o destino é uma página HTTP ou HTTPS pública. Rejeite credenciais, páginas privadas/internas, portas não web, URLs assinadas, segredos de consulta e qualquer solicitação que exija login, cookies, tratamento de CAPTCHA, rotação de proxy, scripts arbitrários, cliques, digitação ou bypass de anti-bot.

2. Escolha um caminho de saída aprovado pelo usuário. Inferir o formato de .png, .jpg/.jpeg, ou .pdf, ou passar o --format correspondente explicitamente.

3. Execute o cliente a partir deste diretório de skill:

   node scripts/latchshot.mjs capture \
     --url 'https://example.com' \
     --output './artifacts/example.png'
   

4. Para uma captura de tela de página completa limitada que ativa conteúdo lazy loading:

   node scripts/latchshot.mjs capture \
     --url 'https://example.com' \
     --output './artifacts/example-full.png' \
     --full-page \
     --scroll-page
   

5. Para um PDF:

   node scripts/latchshot.mjs capture \
     --url 'https://example.com' \
     --output './artifacts/example.pdf' \
     --paper A4
   

6. Analise o resultado JSON de uma linha. Confirme ok, output, format, contentType e bytes; inspecione o artefato local quando a tarefa circundante exigir verificação visual ou de documento. Relate o caminho e diagnósticos relevantes de renderização/cota sem expor a chave.

Execute node scripts/latchshot.mjs --help para as opções limitadas exatas. Use --block-ads, --block-trackers, --block-chats, --hide-cookie-banners e --hide-popups apenas como melhor esforço de limpeza — não para bypass. Use --allow-query apenas após confirmar que a consulta não contém credenciais, assinatura, token, dados do cliente ou qualquer outro segredo. O cliente se recusa a sobrescrever um arquivo a menos que --force seja explícito.

Ler cota

Use o comando somente leitura quando o usuário perguntar sobre renderizações restantes ou tempo de redefinição:

node scripts/latchshot.mjs usage

Isso não consome cota de renderização nem altera um plano.

Tratamento de falhas

• Leia o código de erro estruturado e a mensagem do stderr; não tente novamente falhas de validação ou autenticação.
• Para demo_limit, espere a redefinição horária em vez de entrar em loop ou trocar de identidade.
• Para rate_limited, espere a redefinição reportada ou o limite de retry-after em vez de entrar em loop.
• Para uma falha de renderização, declare a falha e preserve qualquer arquivo de saída existente. Não substitua silenciosamente por um navegador local, um provedor diferente ou acesso a páginas privadas não suportadas.
• Não inicie um upgrade, checkout, pagamento, solicitação de implementação ou outra ação comercial. Estes permanecem controlados pelo usuário e pelo proprietário.

Limites rígidos

…