cloud

Vue d’ensemble de la skill cloud

À quoi sert la skill cloud

La skill cloud est un assistant guidé par la documentation pour Browser Use Cloud, la plateforme hébergée et l’API d’automatisation de navigateur. Elle convient surtout à celles et ceux qui doivent automatiser des sites web via le service cloud, utiliser l’API REST ou les SDK, connecter des outils de navigateur externes via CDP, ou concevoir des workflows autour des sessions, profils, proxies et du monitoring en direct.

Qui devrait installer cette skill cloud

Installez cette skill cloud si votre besoin réel correspond à l’un des cas suivants :

• démarrer rapidement avec Browser Use Cloud sans devoir lire tous les fichiers de référence
• choisir entre l’API REST v2, l’API agent v3, l’usage des SDK ou une connexion directe au navigateur
• automatiser des tâches navigateur depuis Python, TypeScript, cURL ou des outils externes
• exécuter de l’automatisation de navigateur sur une infrastructure hébergée pour des cas d’usage de Browser Automation
• travailler avec des sessions, des profils persistants, des proxies résidentiels, la gestion des CAPTCHA ou des webhooks

Ne l’installez pas si vous cherchez en réalité de l’aide sur la configuration de la bibliothèque Python open source locale browser-use. La skill distingue explicitement l’usage cloud du package agent open source.

Ce qui distingue cette skill cloud d’un prompt générique

Un prompt générique peut décrire l’automatisation de navigateur à un niveau élevé. Cette skill cloud devient bien plus utile quand vous avez besoin des chemins exacts dans Browser Use Cloud : quelle version d’API consulter, comment fonctionne l’authentification, d’où vient liveUrl, en quoi les sessions cloud diffèrent des exécutions ponctuelles, comment l’accès CDP se lance, et quel schéma d’intégration correspond à votre stack.

Sa plus grande valeur tient à l’orientation et à l’aide au choix, pas à un outillage caché. Elle vous dirige rapidement vers le bon fichier de référence :

• references/quickstart.md pour la première configuration et les tarifs
• references/api-v2.md pour les endpoints REST stables
• references/api-v3.md pour la nouvelle API agent basée sur les sessions
• references/browser-api.md pour Playwright, Puppeteer, Selenium et CDP brut
• references/sessions.md pour la conception des sessions et profils
• references/features.md pour les proxies, webhooks, workspaces, skills, MCP et la vue en direct
• references/patterns.md pour les exécutions parallèles, le streaming, le geo-scraping et la sortie structurée

Cas d’usage où la skill cloud est la plus pertinente pour Browser Automation

Cette skill cloud est particulièrement pertinente si vous cherchez du cloud pour Browser Automation plutôt qu’un contrôle local du navigateur. Cas d’usage fréquents :

• scraping ou extraction qui bénéficient de mécanismes de furtivité et de proxies
• workflows authentifiés qui nécessitent des profils de navigateur persistants
• sessions navigateur distantes observables via liveUrl
• automatisation directe depuis Playwright, Puppeteer ou Selenium via un CDP hébergé
• intégrations avec des systèmes d’agents, interfaces de chat, outils no-code ou backends pilotés par webhook

Principaux freins à vérifier avant d’adopter la skill cloud

La plupart des décisions d’installation se résument à quelques questions très concrètes :

• Avez-vous besoin d’une automatisation cloud hébergée ou d’un contrôle local open source ?
• Voulez-vous les endpoints REST stables de la v2 ou le nouveau modèle sessions/messages de la v3 ?
• Avez-vous besoin de tâches simples via run(), ou d’une gestion explicite des sessions et profils ?
• Utilisez-vous des SDK, cURL ou des frameworks navigateur externes via CDP ?
• Avez-vous besoin de routage géographique, de persistance d’authentification ou de callbacks webhook ?

Si ces points ne sont pas encore tranchés, cette skill cloud est utile, car le dépôt est structuré par parcours de décision plutôt que comme un tutoriel linéaire unique.

Comment utiliser la skill cloud

Installer la skill cloud

Utilisez l’installateur standard de skills sur le dépôt en ciblant la skill cloud :

npx skills add https://github.com/browser-use/browser-use --skill cloud

Une fois installée, invoquez-la lorsque votre demande porte précisément sur Browser Use Cloud, et non sur le package open source local.

Commencez par le bon fichier selon votre objectif avec la skill cloud

Lisez selon votre décision, pas selon l’ordre des fichiers :

• Nouveau sur la plateforme : references/quickstart.md
• Besoin d’une API stable avec exemples cURL : references/api-v2.md
• Besoin du nouveau modèle agent/session : references/api-v3.md
• Besoin d’un accès navigateur hébergé depuis des frameworks existants : references/browser-api.md
• Besoin d’un état persistant, d’authentification ou d’une stratégie de profils : references/sessions.md
• Besoin de fonctions avancées comme les proxies ou les webhooks : references/features.md
• Besoin de patterns d’implémentation : references/patterns.md

C’est important, car la skill ne masque pas la complexité du produit ; elle vous aide à choisir le parcours de lecture le plus court et le plus utile.

Comprendre les quatre principaux modes d’usage cloud

Avant de rédiger votre prompt, déterminez lequel de ces modes vous visez :

1. exécution de tâches run() via SDK
2. endpoints de tâches/sessions/navigateur de l’API REST v2
3. API agent v3 avec sessions, messages et workspaces
4. connexion directe au navigateur via CDP pour Playwright, Puppeteer ou Selenium

Beaucoup de prompts peu efficaces échouent parce qu’ils demandent un “usage de Browser Use Cloud” sans préciser le mode visé.

Configurer correctement l’authentification

Browser Use Cloud utilise l’en-tête X-Browser-Use-API-Key, et les SDK lisent souvent BROWSER_USE_API_KEY depuis l’environnement.

export BROWSER_USE_API_KEY=your-key

Détails utiles mis en avant dans les références :

• base API pour la v2 : https://api.browser-use.com/api/v2
• base API pour la v3 : https://api.browser-use.com/api/v3
• création de clé API : https://cloud.browser-use.com/new-api-key

Si votre prompt ne précise pas comment vous voulez gérer l’authentification, la réponse risque de rester trop abstraite.

Choisir entre SDK, REST ou CDP avant de demander des exemples

Utilisez des exemples SDK si vous cherchez l’expérience développeur la plus simple.
Utilisez REST si vous avez besoin d’un contrôle fin au niveau des endpoints.
Utilisez CDP si vous avez déjà du code d’automatisation de navigateur et qu’il vous faut simplement une cible navigateur hébergée.

Cette distinction change concrètement la réponse :

• les réponses orientées SDK se concentrent sur run(), les sessions, les profils et la sortie structurée
• les réponses orientées REST se concentrent sur les endpoints, le polling, les schémas et les en-têtes
• les réponses orientées CDP se concentrent sur les URL WebSocket et l’intégration avec les outils navigateur

Transformer un objectif vague en prompt cloud solide

Prompt faible :

Help me use Browser Use Cloud.

Meilleur prompt :

I want cloud usage guidance for Python. I need a hosted browser workflow that logs into a site, persists cookies across runs, uses a US proxy, and lets me monitor progress live. Show whether I should use run() with auto-created sessions or manual sessions with a profile, and point me to the exact repo files to read first.

Pourquoi c’est meilleur :

• précise le langage
• précise le type de workflow
• mentionne la persistance de session
• inclut les besoins en proxy
• demande le monitoring en direct
• demande un aiguillage vers les fichiers, pas seulement du code

Informations à fournir pour améliorer la qualité des réponses

Pour obtenir de meilleures réponses de la skill cloud, indiquez :

• langage : Python, TypeScript, cURL
• mode API : v2, v3, ou indécis
• style d’exécution : tâche ponctuelle, session multi-étapes, ou contrôle direct du navigateur
• besoins d’état : sans état vs profil persistant
• besoins d’infra : pays du proxy, proxy personnalisé, timeout, taille d’écran
• besoins de monitoring : liveUrl, streaming, webhooks
• format de sortie : texte libre vs schéma structuré
• cible d’intégration : Playwright, Puppeteer, Selenium, chat UI, subagent, outil no-code

Sans ces précisions, la réponse sera généralement juste, mais trop large pour être implémentée rapidement.

Utiliser la skill cloud pour concevoir sessions et profils

Une valeur très concrète de la skill cloud, c’est de vous aider à éviter de mauvais choix de conception autour des sessions.

D’après les références :

• run() crée généralement une session automatiquement
• les sessions manuelles sont plus adaptées aux workflows multi-étapes
• les profils conservent les cookies et le stockage local entre les sessions
• des sessions concurrentes utilisant le même profil partent d’un snapshot et ne voient pas les changements d’état des autres

Ce dernier point est facile à rater lors d’une lecture rapide, et il compte énormément pour les traitements parallèles avec authentification.

Utiliser la skill cloud avec les frameworks de Browser Automation

Si vous utilisez déjà Playwright, Puppeteer ou Selenium, le meilleur chemin n’est pas forcément les tâches agent : un accès direct au navigateur cloud peut être plus adapté.

Le dépôt montre un point d’entrée CDP de ce type :

wss://connect.browser-use.com?apiKey=YOUR_KEY&proxyCountryCode=us&timeout=30

C’est un point important, car le navigateur peut démarrer automatiquement à la connexion et s’arrêter automatiquement à la déconnexion, ce qui correspond à un modèle d’exploitation différent d’une création et suppression manuelles de tâches.

Utiliser la skill cloud pour les fonctionnalités cloud avancées

Cette skill cloud est également utile lorsque votre décision dépend davantage des fonctionnalités de la plateforme que de la syntaxe :

• paramètres de furtivité par défaut
• proxies résidentiels dans de nombreux pays
• proxies personnalisés
• gestion des CAPTCHA
• webhooks avec vérification de signature
• visualisation en direct et liens de partage
• workspaces
• prise en charge des skills et de la marketplace
• références de plateforme liées à MCP

C’est typiquement ce genre de détails qui permet de savoir si Browser Use Cloud convient à des besoins de production.

Workflow recommandé après installation

Séquence pratique pour les nouveaux utilisateurs :

1. lire references/quickstart.md
2. exécuter une première tâche triviale via SDK ou cURL
3. décider si votre workflow réel nécessite des sessions manuelles
4. n’ajouter des profils que si vous avez besoin d’une connexion persistante ou d’un état durable
5. n’ajouter les paramètres de proxy et de géographie qu’en cas de besoin
6. n’ajouter la sortie structurée ou les webhooks qu’une fois le parcours de base validé
7. passer à references/patterns.md pour la concurrence ou le streaming

Cet ordre limite la confusion et évite de surconcevoir avant même le premier run réussi.

FAQ sur la skill cloud

Cette skill cloud n’est-elle que documentaire, ou modifie-t-elle le comportement ?

Il s’agit avant tout d’une skill d’aiguillage documentaire. Sa valeur est d’aider un agent ou un utilisateur à choisir la bonne documentation Browser Use Cloud et à répondre avec moins de mauvaises hypothèses. Elle ne remplace ni le SDK ni l’API de la plateforme.

La skill cloud convient-elle aux débutants ?

Oui, si vous débutez spécifiquement avec Browser Use Cloud. Le meilleur point de départ est references/quickstart.md. En revanche, vous devez tout de même savoir si vous voulez une exécution de tâches simple, une gestion de sessions, ou un contrôle du navigateur au niveau framework.

Quand ne faut-il pas utiliser cette skill cloud ?

N’utilisez pas cette skill cloud pour des questions sur les internals de la bibliothèque locale open source browser-use, la configuration d’agent, ou l’installation du package hors cloud. La skill indique explicitement qu’il faut utiliser la skill open source pour cela.

Faut-il choisir la v2 ou la v3 ?

Choisissez la v2 si vous voulez une API REST stable avec une large couverture d’endpoints.
Choisissez la v3 si vous voulez le nouveau modèle BU Agent API avec sessions, messages, fichiers et workspaces, et si vous acceptez qu’elle soit marquée comme expérimentale dans les références.

Cette skill cloud peut-elle aider avec les frameworks navigateur classiques ?

Oui. Le dépôt inclut references/browser-api.md spécifiquement pour Playwright, Puppeteer, Selenium et la connexion CDP directe à des navigateurs hébergés.

La skill cloud est-elle meilleure qu’un prompt classique pour du Browser Automation ?

Pour les tâches Browser Use Cloud, le plus souvent oui. Un prompt classique peut passer à côté d’éléments spécifiques à la plateforme comme les en-têtes d’authentification, les versions d’endpoint, liveUrl, le comportement des profils, les signatures de webhook ou le modèle CDP avec démarrage automatique à la connexion.

La skill cloud couvre-t-elle les tarifs et les contraintes opérationnelles ?

Oui, la référence quickstart inclut les tarifs et une FAQ, et les autres références couvrent les timeout, la gestion des sessions, les limites liées à la concurrence et les contraintes propres à certaines fonctionnalités.

Comment améliorer l’usage de la skill cloud

Demandez une décision, pas seulement une explication

Le moyen le plus rapide d’obtenir de meilleures réponses avec la skill cloud est de lui demander de trancher entre plusieurs options :

• “Should I use v2, v3, or CDP?”
• “Should this be auto-session or manual session?”
• “Should I use a profile or keep it stateless?”

Cela produit des recommandations d’implémentation, plutôt qu’un résumé général.

Donnez une tâche et un environnement concrets

Mieux :

I need cloud install and usage help for a TypeScript backend. The workflow logs into a dashboard weekly, downloads a file, and posts completion to my server. I need persistent auth, webhook notifications, and a recommendation between SDK and REST.

Cette formulation améliore le résultat, car elle explicite le langage, la fréquence, les besoins d’état et le mode de signalement de fin de traitement.

Dites clairement ce qui doit persister entre les exécutions

Un écueil fréquent consiste à sous-préciser l’état. Si la connexion, les cookies, le stockage local ou des identifiants enregistrés comptent, dites-le explicitement et demandez des recommandations basées sur les profils à partir de references/sessions.md.

Si l’état n’a pas d’importance, dites-le aussi. La skill cloud pourra alors recommander des exécutions ponctuelles plus simples.

Précisez si vous avez besoin d’observation ou de callbacks

Beaucoup d’utilisateurs ont besoin de l’un de ces points, mais oublient de le demander :

• suivre l’exécution en direct avec liveUrl
• recevoir des mises à jour de progression en streaming
• recevoir des callbacks webhook lorsque les tâches se terminent

Ces besoins orientent vers des patterns d’implémentation différents et vers des fichiers de référence différents.

Demandez d’abord le chemin minimal viable

Un bon schéma d’amélioration consiste à :

1. demander l’exemple fonctionnel le plus minimal
2. l’exécuter
3. puis demander comment ajouter des profils, des proxies ou des webhooks

Cette skill cloud est la plus utile quand elle aide à séquencer l’adoption, pas quand on lui demande de concevoir toute l’architecture de production en une seule passe.

Attention aux confusions entre versions d’API

L’une des manières les plus simples d’obtenir une réponse faible est de mélanger les concepts v2 et v3 dans une même demande. Si vous voulez une comparaison, demandez une comparaison. Si vous voulez de l’implémentation, nommez une seule version.

Bon prompt :

Compare Browser Use Cloud v2 vs v3 for a multi-step agent workflow, then recommend one and give only that version's starter example.

Demandez des parcours de lecture au niveau fichier

Le dépôt contient suffisamment de références pour que des parcours de lecture ciblés fassent gagner du temps. Posez des questions comme :

• “Which file should I read first for webhook verification?”
• “Which reference covers CDP and Playwright setup?”
• “Which document explains concurrent sessions with the same profile?”

La skill cloud devient alors plus actionnable qu’un simple résumé générique.

Améliorez les réponses avec des critères de réussite explicites

Au lieu de :

Show me cloud usage.

Utilisez :

Show me a cloud usage path that gets from API key to first successful task in under 10 minutes, then list the next file to read if I need structured output.

Des critères de réussite clairs poussent la réponse vers un parcours d’adoption réellement praticable.

Itérez après la première réponse en comblant les manques, sans repartir de zéro

Après une première réponse, améliorez-la en indiquant précisément ce qui manque encore :

• gestion de l’authentification absente
• exemple de polling absent
• nettoyage de session absent
• configuration du proxy absente
• schéma de sortie structurée absent
• vérification de webhook absente
• détails de connexion Playwright absents

Cette méthode produit de meilleures itérations qu’une nouvelle demande depuis zéro.

Meilleure façon d’obtenir une aide cloud à forte valeur

La skill cloud donne les meilleurs résultats lorsque votre prompt inclut :

• votre stack
• votre objectif d’automatisation de navigateur
• si l’état doit persister
• si vous préférez un contrôle de navigateur hébergé ou une exécution par agent
• si vous avez besoin de monitoring, de streaming ou de webhooks
• si le routage géographique ou les contraintes de furtivité comptent pour vous

Avec cet ensemble d’informations, la skill cloud a suffisamment de contexte pour vous orienter vers la bonne documentation Browser Use Cloud et produire des conseils directement exploitables.