/ck:agent-browser — Browser automation cho agent

Kit: CK Engineer v2.20.1-beta.14 · Skill version: 2.0.1 · Category: dev-tools · Updated: 2026-10-05 Skill bọc CLI agent-browser (upstream vercel-labs/agent-browser): điều khiển Chrome/Chromium qua CDP, snapshot accessibility tree với element ref gọn dạng @eN. Dùng cho browser testing, screenshot, điền form, scraping, exploratory QA, bug hunt, cloud browser, Electron app, Slack automation — khi không cần cookie Chrome thật của user.

Native Rust CLI, không phụ thuộc Playwright/Puppeteer
Dùng được với nhiều agent: Claude Code, Codex, Cursor, Continue, Windsurf
Có sessions, authentication vault, state persistence, video recording

SKILL.md chỉ là discovery stub. Trước khi chạy lệnh, load hướng dẫn từ chính CLI đã cài: agent-browser skills get core (thêm --full để có command reference đầy đủ). Hướng dẫn luôn khớp version đang cài.

Khi nào dùng

Automation không phụ thuộc login state thật: session tự động, điều hướng ad-hoc, screenshot, form, scraping, multi-tab
Self-verifying build loop — agent tự kiểm trạng thái trang sau thay đổi
Electron app, Slack, exploratory QA / bug hunt
CI/CD hoặc môi trường không có browser local → Browserbase cloud

Cần cookie / account / tenant trong Chrome hằng ngày → dùng /ck:chrome-profile.

Cài đặt / nâng cấp

npm install -g agent-browser       # cài (hoặc nâng cấp) bản mới nhất
agent-browser install              # tải Chromium (1 lần)
agent-browser install --with-deps  # Linux: kèm system deps
agent-browser upgrade              # tự nâng cấp binary
agent-browser --version

Cú pháp

# Gọi skill
/ck:agent-browser https://example.com

# Load hướng dẫn từ CLI
agent-browser skills get core
agent-browser skills get core --full
agent-browser skills list

# Skill chuyên biệt
agent-browser skills get electron        # Electron app (VS Code, Slack, Discord, Figma, ...)
agent-browser skills get slack           # Slack workspace
agent-browser skills get dogfood         # Exploratory testing / QA / bug hunt
agent-browser skills get vercel-sandbox  # chạy trong Vercel Sandbox microVM
agent-browser skills get agentcore       # AWS Bedrock AgentCore cloud browser

# Pattern cơ bản
agent-browser --session test1 open https://example.com
agent-browser snapshot -i
agent-browser click @e1
agent-browser screenshot -o screenshot.png
agent-browser close

Các lệnh khác: xem agent-browser skills get core --full.

Chọn tool browser nào

Tình huống	Dùng
Cần Chrome profile thật, cookie, tenant, Google account	`/ck:chrome-profile`
Testing, screenshot, form, scraping, exploratory QA	`/ck:agent-browser`
Bộ test e2e lặp lại cho CI	`/ck:web-testing` hoặc Playwright/Vitest/Cypress của dự án
Soi CDP mức thấp	Bridge `chrome-devtools-mcp` đã cấu hình
Browserbase / cloud browser, Electron	`/ck:agent-browser`
Còn lại	`/ck:web-testing`

Browserbase cloud

export BROWSERBASE_API_KEY="..."
export BROWSERBASE_PROJECT_ID="..."
agent-browser -p browserbase open https://example.com

# Hoặc đặt provider mặc định
export AGENT_BROWSER_PROVIDER="browserbase"
agent-browser open https://example.com

# Session song song: đặt tên session
agent-browser -p browserbase --session user1 open https://example.com
agent-browser -p browserbase --session user2 open https://example.com

Mỗi open tạo 1 session Browserbase, close kết thúc session
Browserbase tính phí theo session-minute → close sớm; dev dùng browser local, cloud cho CI/CD
Bỏ provider flag (và AGENT_BROWSER_PROVIDER) → quay về Chromium local
Recording, network log, console, screenshot của session xem trên Browserbase dashboard

Observability dashboard

Dashboard chạy độc lập với browser session trên port 4848, có thể mở qua URL proxy như https://dashboard.agent-browser.localhost. Tab session, status, stream được proxy nội bộ — không cần expose port từng session.

Recipe cho team ECH

Recipe 1 — Smoke check 1 trang staging

agent-browser skills get core
agent-browser --session ech-smoke open <staging-url>
agent-browser snapshot -i
agent-browser screenshot -o ech-smoke.png
agent-browser close

Recipe 2 — Exploratory QA / bug hunt

agent-browser skills get dogfood
# → làm theo workflow dogfood mà CLI trả về

Recipe 3 — Browser test trong GitHub Actions

- name: Install agent-browser
  run: npm install -g agent-browser
- name: Run browser tests
  env:
    BROWSERBASE_API_KEY: ${{ secrets.BROWSERBASE_API_KEY }}
    BROWSERBASE_PROJECT_ID: ${{ secrets.BROWSERBASE_PROJECT_ID }}
    AGENT_BROWSER_PROVIDER: browserbase
  run: |
    agent-browser open https://example.com
    agent-browser snapshot -i
    agent-browser screenshot -o screenshot.png
    agent-browser close

Gotchas

⚠️ Element not found → chạy lại agent-browser snapshot -i sau khi trang thay đổi để lấy ref mới
⚠️ Session stale → agent-browser close
⚠️ Lệnh/cờ không có → npm install -g agent-browser rồi agent-browser skills get core --full
⚠️ Chromium thiếu → agent-browser install; Linux thiếu deps → agent-browser install --with-deps
⚠️ Lệnh treo trên Browserbase → kiểm session trước đã close đúng chưa
🔒 Browserbase API key để trong env / CI secrets, không hardcode

/ck:chrome-profile — automation trên Chrome profile thật
/ck:web-testing — test suite lặp lại cho CI
chrome-devtools-mcp — soi CDP mức thấp

Reference

SKILL.md: ~/.claude/skills/agent-browser/SKILL.md
References: ~/.claude/skills/agent-browser/references/{agent-browser-vs-chrome-devtools,browserbase-cloud-setup}.md
Upstream: https://github.com/vercel-labs/agent-browser
Browserbase docs: https://docs.browserbase.com/

​/ck:agent-browser — Browser automation cho agent

​Khi nào dùng

​Cài đặt / nâng cấp

​Cú pháp

​Chọn tool browser nào

​Browserbase cloud

​Observability dashboard

​Recipe cho team ECH

​Recipe 1 — Smoke check 1 trang staging

​Recipe 2 — Exploratory QA / bug hunt

​Recipe 3 — Browser test trong GitHub Actions

​Gotchas

​Related

​Reference

/ck:agent-browser — Browser automation cho agent

Khi nào dùng

Cài đặt / nâng cấp

Cú pháp

Chọn tool browser nào

Browserbase cloud

Observability dashboard

Recipe cho team ECH

Recipe 1 — Smoke check 1 trang staging

Recipe 2 — Exploratory QA / bug hunt

Recipe 3 — Browser test trong GitHub Actions

Gotchas

Related

Reference