cloud

Visão geral da cloud skill

Para que serve a cloud skill

A cloud skill é um assistente guiado por documentação para o Browser Use Cloud, a plataforma hospedada e API de automação de navegador. Ela é mais indicada para quem precisa automatizar sites pela cloud, usar a API REST ou SDKs, conectar ferramentas externas de navegador via CDP, ou desenhar fluxos com sessões, perfis, proxies e monitoramento ao vivo.

Quem deve instalar esta cloud skill

Instale esta cloud skill se o seu trabalho real for um destes:

• começar a usar o Browser Use Cloud rapidamente sem precisar ler todos os arquivos de referência
• escolher entre a API REST v2, a agent API v3, uso via SDK ou conexão direta ao navegador
• automatizar tarefas de navegador com Python, TypeScript, cURL ou ferramentas externas
• executar automação de navegador em infraestrutura hospedada para casos de uso de Browser Automation
• trabalhar com sessões, perfis persistentes, proxies residenciais, tratamento de CAPTCHA ou webhooks

Não instale se, na prática, você precisa de ajuda com a configuração da biblioteca Python local open-source browser-use. A própria skill separa explicitamente o uso em cloud do pacote open-source de agente.

O que diferencia esta cloud skill de um prompt genérico

Um prompt genérico consegue descrever automação de navegador em alto nível. Esta cloud skill é mais útil quando você precisa dos caminhos exatos do Browser Use Cloud: qual versão da API consultar, como funciona a autenticação, de onde vem o liveUrl, como sessões em cloud diferem de execuções pontuais, como o acesso via CDP é iniciado e qual padrão de integração faz mais sentido para a sua stack.

O maior valor está na orientação de navegação e aderência ao caso de uso, não em alguma ferramenta oculta. Ela leva você rapidamente ao arquivo de referência certo:

• references/quickstart.md para configuração inicial e preços
• references/api-v2.md para endpoints REST estáveis
• references/api-v3.md para a agent API mais nova baseada em sessões
• references/browser-api.md para Playwright, Puppeteer, Selenium e CDP puro
• references/sessions.md para desenho de sessões e perfis
• references/features.md para proxies, webhooks, workspaces, skills, MCP e visualização ao vivo
• references/patterns.md para execuções paralelas, streaming, geo-scraping e saída estruturada

Casos de uso com melhor encaixe para cloud em Browser Automation

Esta cloud skill é especialmente relevante quando você quer cloud para Browser Automation, e não controle local do navegador. Casos comuns em que ela encaixa bem incluem:

• scraping ou extração que se beneficiam de stealth e proxies
• fluxos autenticados que precisam de perfis persistentes de navegador
• sessões remotas de navegador que você pode acompanhar via liveUrl
• automação direta com Playwright, Puppeteer ou Selenium via CDP hospedado
• integrações com sistemas de agentes, interfaces de chat, ferramentas no-code ou backends acionados por webhook

Principais bloqueios de adoção para checar primeiro

A maior parte das decisões de instalação se resume a algumas perguntas práticas:

• Você precisa de automação hospedada em cloud ou de controle local open-source?
• Você quer endpoints REST estáveis da v2 ou o modelo mais novo de sessão/mensagem da v3?
• Você precisa de tarefas simples com run(), ou de gerenciamento explícito de sessão/perfil?
• Vai usar SDKs, cURL ou frameworks externos de navegador via CDP?
• Precisa de roteamento geográfico, persistência de autenticação ou callbacks por webhook?

Se essas perguntas ainda não estiverem resolvidas, esta skill ajuda, porque o repositório é organizado por trilhas de decisão, e não como um tutorial linear único.

Como usar a cloud skill

Instale a cloud skill

Use o instalador padrão de skills apontando para o repositório e selecione a skill cloud:

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

Depois de instalar, acione-a quando a sua solicitação for especificamente sobre Browser Use Cloud, e não sobre o pacote local open-source.

Comece pelo arquivo certo para o seu objetivo

Leia por decisão, não pela ordem dos arquivos:

• Novo na plataforma: references/quickstart.md
• Precisa de cobertura estável da API e exemplos com cURL: references/api-v2.md
• Precisa do modelo mais novo de agent/session: references/api-v3.md
• Precisa de acesso a navegador hospedado a partir de frameworks de navegador já existentes: references/browser-api.md
• Precisa de estado persistente, autenticação ou estratégia de perfis: references/sessions.md
• Precisa de recursos avançados como proxies ou webhooks: references/features.md
• Precisa de padrões de implementação: references/patterns.md

Isso importa porque a skill não esconde a complexidade do produto; ela ajuda você a escolher o caminho de leitura mais curto que ainda seja útil.

Entenda os quatro principais caminhos de uso em cloud

Antes de escrever o prompt, decida qual destes caminhos você quer:

1. execução de tarefas com run() via SDK
2. endpoints de tarefa/sessão/browser da API REST v2
3. agent API v3 com sessões, mensagens e workspaces
4. conexão direta ao navegador via CDP para Playwright, Puppeteer ou Selenium

Muitos prompts fracos falham porque pedem “uso do Browser Use Cloud” sem dizer qual caminho pretendem seguir.

Configure a autenticação corretamente

O Browser Use Cloud usa o header X-Browser-Use-API-Key, e os SDKs normalmente leem BROWSER_USE_API_KEY do ambiente.

export BROWSER_USE_API_KEY=your-key

Detalhes úteis destacados nas referências:

• Base da API para v2: https://api.browser-use.com/api/v2
• Base da API para v3: https://api.browser-use.com/api/v3
• Criação de API key: https://cloud.browser-use.com/new-api-key

Se o seu prompt não mencionar como você quer lidar com autenticação, a resposta pode acabar abstrata demais.

Escolha entre SDK, REST ou CDP antes de pedir exemplos

Use exemplos com SDK quando você quiser a experiência de desenvolvimento mais simples.
Use REST quando precisar de controle no nível de endpoint.
Use CDP quando você já tiver código de automação de navegador e só precisar de um navegador hospedado como destino.

Essa distinção muda materialmente a resposta:

• respostas com SDK focam em run(), sessões, perfis e saída estruturada
• respostas com REST focam em endpoints, polling, schemas e headers
• respostas com CDP focam em URLs WebSocket e integração com ferramentas de navegador

Transforme um objetivo vago em um bom prompt de uso da cloud skill

Prompt fraco:

Help me use Browser Use Cloud.

Prompt melhor:

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.

Por que isso é melhor:

• informa a linguagem
• informa o tipo de fluxo
• menciona persistência de sessão
• inclui exigências de proxy
• pede monitoramento ao vivo
• pede direcionamento para arquivos, não só código

Detalhes de entrada que melhoram a qualidade da resposta

Para obter melhores respostas da cloud skill, inclua:

• linguagem: Python, TypeScript, cURL
• modo de API: v2, v3 ou não sei
• estilo de execução: tarefa única, sessão em múltiplas etapas ou controle direto do navegador
• necessidade de estado: stateless vs perfil persistente
• necessidades de infraestrutura: país do proxy, proxy customizado, timeout, tamanho de tela
• necessidades de monitoramento: liveUrl, streaming, webhooks
• formato de saída: texto livre vs schema estruturado
• destino de integração: Playwright, Puppeteer, Selenium, chat UI, subagent, ferramenta no-code

Sem isso, a resposta normalmente será correta, mas ampla demais para implementar rápido.

Use a cloud skill para desenhar sessões e perfis

Um dos principais valores práticos da cloud skill é ajudar você a evitar um desenho ruim de sessões.

Pelas referências:

• run() normalmente cria uma sessão automaticamente
• sessões manuais são melhores para fluxos com múltiplas etapas
• perfis persistem cookies e local storage entre sessões
• sessões concorrentes usando o mesmo perfil partem de um snapshot e não enxergam as mudanças de estado umas das outras

Esse último ponto passa fácil despercebido em uma leitura rápida e faz diferença em trabalhos paralelos com autenticação.

Use a cloud skill com frameworks de Browser Automation

Se você já usa Playwright, Puppeteer ou Selenium, o melhor caminho pode ser acesso direto ao navegador em cloud, em vez de tarefas de agente.

O repositório mostra um ponto de entrada via CDP como:

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

Isso é importante porque o navegador pode iniciar automaticamente ao conectar e encerrar automaticamente ao desconectar, o que é um modelo operacional diferente de criar e encerrar tarefas manualmente.

Use a cloud skill para recursos avançados de cloud

Esta skill também é útil quando sua decisão depende mais de recursos da plataforma do que de sintaxe:

• stealth por padrão
• proxies residenciais em muitos países
• proxies customizados
• tratamento de CAPTCHA
• webhooks com verificação de assinatura
• visualização ao vivo e links de compartilhamento
• workspaces
• suporte a skills e marketplace
• referências da plataforma relacionadas a MCP

Esse é o tipo de detalhe que determina se o Browser Use Cloud atende ou não necessidades de produção.

Fluxo inicial recomendado após instalar

Uma sequência prática para quem está começando:

1. Leia references/quickstart.md
2. Execute uma primeira tarefa trivial via SDK ou cURL
3. Decida se o seu fluxo real precisa de sessões manuais
4. Adicione perfis só se precisar de login persistente ou estado persistente
5. Adicione configurações de proxy e geografia apenas quando necessário
6. Adicione saída estruturada ou webhooks depois que o caminho básico já estiver funcionando
7. Passe para references/patterns.md quando precisar de concorrência ou streaming

Essa ordem reduz confusão e evita excesso de desenho antes da primeira execução bem-sucedida.

FAQ da cloud skill

Esta cloud skill é só documentação ou muda o comportamento?

Ela é principalmente uma skill de roteamento por referências. O valor está em ajudar um agente ou usuário a escolher a trilha correta da documentação do Browser Use Cloud e responder com menos suposições erradas. Ela não substitui o SDK nem a API da plataforma.

A cloud skill é boa para iniciantes?

Sim, se você for iniciante especificamente em Browser Use Cloud. O melhor ponto de partida é references/quickstart.md. Ainda assim, você deve saber se quer execução simples de tarefas, gerenciamento de sessões ou controle de navegador no nível do framework.

Quando eu não devo usar esta cloud skill?

Não use esta cloud skill para perguntas sobre os internals da biblioteca local open-source browser-use, configuração de agentes ou setup de pacote não-cloud. A skill deixa explícito que, para isso, você deve usar a skill open-source.

Devo usar v2 ou v3?

Use v2 se você quiser a API REST estável com ampla cobertura de endpoints.
Use v3 se quiser o modelo mais novo da BU Agent API com sessões, mensagens, arquivos e workspaces, e aceitar que ela está marcada como experimental nas referências.

Esta cloud skill pode ajudar com frameworks comuns de navegador?

Sim. O repositório inclui references/browser-api.md especificamente para Playwright, Puppeteer, Selenium e conexão direta via CDP com navegadores hospedados.

Cloud para Browser Automation é melhor do que um prompt normal?

Para tarefas de Browser Use Cloud, em geral sim. Um prompt normal pode deixar passar fatos específicos da plataforma, como headers de autenticação, versões de endpoint, liveUrl, comportamento de perfis, assinaturas de webhook ou o modelo de conexão CDP com auto-start.

A cloud skill cobre preços e restrições operacionais?

Sim, a referência quickstart inclui material de preços e FAQ, e outras referências cobrem timeout, tratamento de sessões, ressalvas de concorrência e restrições específicas de recursos.

Como melhorar a cloud skill

Peça uma decisão, não só uma explicação

A forma mais rápida de melhorar a resposta da cloud skill é pedir que ela escolha entre opções:

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

Isso gera orientação de implementação em vez de um resumo amplo.

Forneça uma tarefa e um ambiente concretos

Melhor:

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.

Isso melhora o resultado porque deixa claras a linguagem, a cadência, as exigências de estado e a forma de sinalizar conclusão.

Diga à skill o que precisa persistir entre execuções

Um erro comum é especificar mal o estado. Se login, cookies, local storage ou credenciais salvas importam, diga isso explicitamente e peça orientação baseada em perfis a partir de references/sessions.md.

Se estado não importa, diga isso também. Aí a skill pode recomendar execuções pontuais mais simples.

Especifique se você precisa de observação ou callbacks

Muitos usuários se importam com um destes itens, mas esquecem de pedir:

• acompanhar a execução ao vivo com liveUrl
• receber atualizações por streaming
• receber callbacks por webhook quando as tarefas terminarem

Cada um leva a padrões de implementação diferentes e a arquivos diferentes para leitura.

Peça primeiro o caminho mínimo viável

Um bom padrão de melhoria é:

1. pedir o menor exemplo funcional
2. executá-lo
3. depois perguntar como adicionar perfis, proxies ou webhooks

Esta skill funciona melhor quando ajuda a sequenciar a adoção, e não quando recebe a tarefa de desenhar toda a arquitetura de produção de uma vez.

Fique atento à confusão entre versões de API

Uma das maneiras mais fáceis de obter uma resposta fraca é misturar conceitos da v2 e da v3 no mesmo pedido. Se você quer comparação, peça comparação. Se quer implementação, nomeie uma versão.

Bom 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.

Peça trilhas de leitura no nível de arquivo

O repositório tem material de referência suficiente para que trilhas de leitura direcionadas economizem tempo. Faça perguntas como:

• “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?”

Isso torna o guia de cloud mais acionável do que um resumo genérico.

Melhore as respostas com critérios explícitos de sucesso

Em vez de:

Show me cloud usage.

Use:

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.

Critérios de sucesso forçam a resposta a seguir um caminho prático de adoção.

Itere após a primeira resposta apontando lacunas, não recomeçando

Depois da primeira resposta, melhore-a nomeando o que ainda está faltando:

• faltou tratamento de autenticação
• faltou exemplo de polling
• faltou limpeza de sessão
• faltou configuração de proxy
• faltou schema de saída estruturada
• faltou verificação de webhook
• faltaram detalhes de conexão com Playwright

Isso gera uma segunda rodada de orientação melhor do que começar do zero.

Melhor forma de obter orientação de alto valor com a cloud skill

A cloud skill tem melhor desempenho quando o seu prompt inclui:

• sua stack
• seu objetivo de browser automation
• se o estado precisa persistir
• se você prefere controle de navegador hospedado ou execução por agente
• se precisa de monitoramento, streaming ou webhooks
• se roteamento geográfico ou restrições de stealth importam

Essa combinação dá contexto suficiente para a skill encaminhar você ao material certo de Browser Use Cloud e gerar orientação que você consegue implementar imediatamente.