Communitygithub.com

vercel-labs/agentcore

Execute o agent-browser em navegadores em nuvem do AWS Bedrock AgentCore. Use quando o usuário quiser usar o AgentCore, executar automação de navegador na AWS, usar um navegador em nuvem com credenciais AWS ou precisar de uma sessão de navegador gerenciada pela infraestrutura AWS. Os gatilhos incluem "use agentcore", "run on AWS", "cloud browser with AWS", "bedrock browser", "agentcore session" ou qualquer tarefa que exija automação de navegador hospedada na AWS.

O que é agentcore?

Esta skill integra o agent-browser com o AWS Bedrock AgentCore, permitindo executar automação de navegador em sessões de navegador em nuvem gerenciadas pela AWS. Todos os comandos padrão do agent-browser funcionam de forma idêntica; a única diferença é que o navegador roda na infraestrutura da AWS em vez de localmente. Ela é útil para desenvolvedores que precisam de sessões de navegador escaláveis, persistentes e seguras, com suporte a perfis persistentes (cookies, localStorage) para manter logins entre execuções. A skill suporta autenticação automática via variáveis de ambiente AWS ou fallback para AWS CLI (incluindo SSO e perfis nomeados), e oferece opções como região configurável, visualização ao vivo via console AWS e seleção de provedor via variável de ambiente AGENT_BROWSER_PROVIDER. Plataformas suportadas: AWS Bedrock AgentCore.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/vercel-labs/agent-browser/tree/main/skill-data/agentcore

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

AWS Bedrock AgentCore

Execute o agent-browser em sessões de navegador em nuvem hospedadas pelo AWS Bedrock AgentCore. Todos os comandos padrão do agent-browser funcionam de forma idêntica; a única diferença é onde o navegador é executado.

Configuração

As credenciais são resolvidas automaticamente:

  1. Variáveis de ambiente (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, opcionalmente AWS_SESSION_TOKEN)
  2. Fallback para AWS CLI (aws configure export-credentials), que suporta SSO, funções IAM e perfis nomeados

Nenhuma configuração adicional é necessária se o usuário já tiver credenciais AWS funcionais.

Fluxo de Trabalho Principal

# Abrir uma página em um navegador em nuvem AgentCore
agent-browser -p agentcore open https://exemplo.com

# Todo o resto é igual ao Chrome local
agent-browser snapshot -i
agent-browser click @e1
agent-browser screenshot pagina.png
agent-browser close

Variáveis de Ambiente

VariávelDescriçãoPadrão
AGENTCORE_REGIONRegião AWSus-east-1
AGENTCORE_BROWSER_IDIdentificador do navegadoraws.browser.v1
AGENTCORE_PROFILE_IDPerfil de navegador persistente (cookies, localStorage)(nenhum)
AGENTCORE_SESSION_TIMEOUTTempo limite da sessão em segundos3600
AWS_PROFILEPerfil AWS CLI para resolução de credenciaisdefault

Perfis Persistentes

Use AGENTCORE_PROFILE_ID para persistir o estado do navegador entre sessões. Isso é útil para manter sessões de login:

# Primeira execução: faça login
AGENTCORE_PROFILE_ID=meu-app agent-browser -p agentcore open https://app.exemplo.com/login
agent-browser snapshot -i
agent-browser fill @e1 "[email protected]"
agent-browser fill @e2 "senha"
agent-browser click @e3
agent-browser close

# Execuções futuras: já autenticado
AGENTCORE_PROFILE_ID=meu-app agent-browser -p agentcore open https://app.exemplo.com/dashboard

Visualização ao Vivo

Quando uma sessão inicia, o AgentCore imprime uma URL de Visualização ao Vivo no stderr. Abra-a em um navegador para assistir à sessão em tempo real pelo Console AWS:

Sessão: abc123-def456
Visualização ao Vivo: https://us-east-1.console.aws.amazon.com/bedrock-agentcore/browser/aws.browser.v1/session/abc123-def456#

Seleção de Região

# Padrão: us-east-1
agent-browser -p agentcore open https://exemplo.com

# Região explícita
AGENTCORE_REGION=eu-west-1 agent-browser -p agentcore open https://exemplo.com

Padrões de Credenciais

# Credenciais explícitas (CI/CD, scripts)
export AWS_ACCESS_KEY_ID=AKIA...
export AWS_SECRET_ACCESS_KEY=...
agent-browser -p agentcore open https://exemplo.com

# SSO (interativo)
aws sso login --profile meu-perfil
AWS_PROFILE=meu-perfil agent-browser -p agentcore open https://exemplo.com

# Função IAM / cadeia de credenciais padrão
agent-browser -p agentcore open https://exemplo.com

Usando com AGENT_BROWSER_PROVIDER

Defina o provedor via variável de ambiente para evitar passar -p agentcore em cada comando:

export AGENT_BROWSER_PROVIDER=agentcore
export AGENTCORE_REGION=us-east-2

agent-browser open https://exemplo.com
agent-browser snapshot -i
agent-browser click @e1
agent-browser close

Problemas Comuns

"Falha ao executar AWS CLI" significa que a AWS CLI não está instalada ou não está no PATH. Instale-a ou defina AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY diretamente.

"AWS CLI falhou: ... Execute 'aws sso login'" significa que as credenciais SSO expiraram. Execute aws sso login para renová-las.

Tempo limite da sessão: O padrão é 3600 segundos (1 hora). Para tarefas mais longas, aumente com AGENTCORE_SESSION_TIMEOUT=7200.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to

vercel-labs/derive-client

Reverse-engineer a website's internal API by recording browser traffic into a HAR file, then generate a standalone client or CLI that calls the endpoints directly, with no browser needed after the first recording. Use when asked to "derive a client", "build a CLI for <site>", "reverse engineer this site's API", "record network requests", "turn this site into an API", or when the same site will be automated repeatedly and direct HTTP calls would beat driving the browser every time.

vercel-labs/dogfood

Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to "dogfood", "QA", "exploratory test", "find issues", "bug hunt", "test this app/site/platform", or review the quality of a web application. Produces a structured report with full reproduction evidence -- step-by-step screenshots, repro videos, and detailed repro steps for every issue -- so findings can be handed directly to the responsible teams.

vercel-labs/electron

Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome DevTools Protocol. Use when the user needs to interact with an Electron app, automate a desktop app, connect to a running app, control a native app, or test an Electron application. Triggers include "automate Slack app", "control VS Code", "interact with Discord app", "test this Electron app", "connect to desktop app", or any task requiring automation of a native Electron application.

vercel-labs/protected-vercel-deployments

Access and test Vercel deployments protected by Vercel Authentication, SSO, or Deployment Protection with agent-browser. Use when a preview or production URL redirects to a Vercel login page, returns a protection 401 or 403, or needs short-lived Trusted Sources OIDC authentication instead of a static bypass secret or public exception.

vercel-labs/slack

Interact with Slack workspaces using browser automation. Use when the user needs to check unread channels, navigate Slack, send messages, extract data, find information, search conversations, or automate any Slack task. Triggers include "check my Slack", "what channels have unreads", "send a message to", "search Slack for", "extract from Slack", "find who said", or any task requiring programmatic Slack interaction.

vercel-labs/vercel-sandbox

Run agent-browser + Chrome inside Vercel Sandbox microVMs for browser automation from any Vercel-deployed app. Use when the user needs browser automation in a Vercel app (Next.js, SvelteKit, Nuxt, Remix, Astro, etc.), wants to run headless Chrome without binary size limits, needs persistent browser sessions across commands, or wants ephemeral isolated browser environments. Triggers include "Vercel Sandbox browser", "microVM Chrome", "agent-browser in sandbox", "browser automation on Vercel", or any task requiring Chrome in a Vercel Sandbox.

vercel-labs/webmcp-gen

Build and validate experimental WebMCP tools for an existing web page. Use when an agent needs to expose a site's real workflows as page tools, create webmcp.init.js, define deterministic checks, or compare WebMCP with accessibility-tree automation.

Habilidades Relacionadas