Capture de page Latchshot

Utilisez le client dépendance-libre fourni pour transformer une URL de page publique en PNG, JPEG ou PDF validé et local. Commencez par une démo JPEG sans clé et limitée, le cas échéant. Les commandes authentifiées envoient la clé API uniquement à l'origine fixe https://latchshot.fly.dev, et chaque artefact est écrit de manière atomique.

Latchshot est un service tiers hébergé maintenu par le contributeur de cette skill. Gardez son utilisation optionnelle et préservez un workflow local de navigateur existant quand la tâche nécessite des pages privées ou des actions de navigateur non supportées.

Prérequis

Nécessite Node.js 20 ou plus récent et un accès réseau. Lisez la clé uniquement depuis LATCHSHOT_API_KEY pour les commandes de capture et d'utilisation authentifiées.

Si la variable est manquante, utilisez la démo sans clé pour un JPEG limité quand elle convient à la demande. Pour PNG, PDF, page complète, nettoyage ou travail répété, dirigez l'utilisateur vers la documentation de configuration des Agent Skills, puis arrêtez-vous. Ne demandez jamais à l'utilisateur de coller une clé dans le chat, un argument de commande, du code source, un fichier commité ou une sortie. N'imprimez ni ne retournez jamais la clé.

Démo sans clé

Utilisez cette commande pour une page publique quand un JPEG de viewport est acceptable :

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

La démo est JPEG uniquement, n'utilise pas de compte ou de quota de rendu, et autorise trois tentatives par adresse IP par heure. Elle accepte uniquement les options de largeur, hauteur, confirmation de requête et de remplacement explicite. L'URL publique est toujours envoyée à Latchshot, et la requête porte l'étiquette d'acquisition grossière agentskill. Rejetez les pages privées, les secrets, les URL signées et l'accès authentifié exactement comme dans le workflow de capture. Traitez le résultat comme un artefact de preuve, pas comme une activation client ou une inscription à un plan.

Workflow de capture

1. Confirmez que la cible est une page HTTP ou HTTPS publique. Rejetez les identifiants, pages privées/internes, ports non-web, URL signées, secrets de requête, et toute demande nécessitant une connexion, des cookies, la gestion de CAPTCHA, la rotation de proxy, des scripts arbitraires, des clics, de la saisie ou du contournement anti-bot.

2. Choisissez un chemin de sortie approuvé par l'utilisateur. Déduisez le format de .png, .jpg/.jpeg, ou .pdf, ou passez le --format correspondant explicitement.

3. Exécutez le client depuis le répertoire de cette skill :

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

4. Pour une capture de page complète limitée qui active le contenu lazy :

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

5. Pour un PDF :

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

6. Analysez le résultat JSON d'une seule ligne. Confirmez ok, output, format, contentType, et bytes ; inspectez l'artefact local quand la tâche environnante nécessite une vérification visuelle ou de document. Signalez le chemin et les diagnostics de rendu/quota pertinents sans exposer la clé.

Exécutez node scripts/latchshot.mjs --help pour les options limitées exactes. Utilisez --block-ads, --block-trackers, --block-chats, --hide-cookie-banners, et --hide-popups uniquement comme nettoyage au mieux de ses efforts, pas comme contournement. Utilisez --allow-query uniquement après confirmation que la requête ne contient aucun identifiant, signature, token, donnée client ou autre secret. Le client refuse de remplacer un fichier à moins que --force soit explicite.

Quota de lecture

Utilisez la commande en lecture seule quand l'utilisateur demande les rendus restants ou l'heure de réinitialisation :

node scripts/latchshot.mjs usage

Cela ne consomme pas de quota de rendu et ne change pas le plan.

Gestion des défaillances

• Lisez le code d'erreur structuré et le message depuis stderr ; ne réessayez pas les défaillances de validation ou d'authentification.
• Pour demo_limit, attendez la réinitialisation horaire plutôt que de boucler ou changer d'identités.
• Pour rate_limited, attendez la limite de réinitialisation ou de retry-after rapportée plutôt que de boucler.
• Pour une défaillance de rendu, signalez la défaillance et préservez tout fichier de sortie existant. N'effectuez pas de substitution silencieuse d'un navigateur local, d'un fournisseur différent ou d'un accès aux pages privées non supporté.
• N'initiez pas une mise à niveau, un checkout, un paiement, une demande d'implémentation ou toute autre action commerciale. Celles-ci restent contrôlées par l'utilisateur et le propriétaire.

Limites fermes

Latchshot accepte les pages publiques uniquement et retourne un artefact binaire. Il n'offre pas l'entrée HTML brute, l'extraction DOM, les sélecteurs, les sessions, JavaScript arbitraire, pages authentifiées/privées, la résolution de CAPTCHA, les proxies résidentiels ou l'évasion anti-bot. Seuls les rendus réussis consomment le quota.