Agent Browser
Use a controlled browser to verify behavior, capture evidence, or extract information from web pages that a static fetch cannot reach (SPAs, login-gated pages, dynamic content). This skill is about supervised verification, not unattended scraping.
When to use
- You need a screenshot of a deployed page or a local dev server to confirm a UI change.
- You need to read JavaScript-rendered content that
curl/wget will not see.
- A user reports a UI bug and you need to reproduce it interactively to capture console errors, network requests, or layout state.
- You need to walk through a short flow (load page, click, observe) to verify acceptance criteria.
When not to use
- The page is reachable as static HTML. Use
curl/HTTP fetch — it is cheaper, faster, and more reliable.
- The task is unattended large-scale scraping. That belongs to a dedicated scraper with rate limits, robots.txt handling, and a real user agent policy — not this skill.
- The site is behind authentication you do not own credentials for, or whose terms of service prohibit automation.
- The site involves sensitive accounts (banking, healthcare, government) where automation risks lockout or compliance issues.
Before launching the browser
- Confirm the URL and what state should be true after navigation.
- Decide what evidence is needed: full-page screenshot, viewport screenshot, console log, network trace, HTML snapshot, extracted text.
- Decide the viewport size that matters for the task (mobile vs desktop). Default to a desktop size unless the task is mobile-specific.
- For local dev servers, confirm the server is running and the port is what you expect.
Driving the browser
A typical verification session:
- Launch with a real-looking user agent when the target is the public internet; an unrealistic UA flags automation traffic.
- Set a sane viewport (e.g., 1366×768 desktop, 390×844 iPhone-ish).
- Navigate and wait for the right signal. Prefer waiting for a specific selector or network-idle over arbitrary sleeps.
- Capture evidence immediately after the wait condition succeeds, before any interaction perturbs the state.
- Interact deliberately. One click at a time, with a wait between actions; re-screenshot after each meaningful state change.
- Read the console and network panels for unexpected errors, 4xx/5xx responses, or slow requests.
- Close the browser cleanly when done. Long-running browser sessions leak memory and hold ports.
What evidence to record
For a verification task, deliver:
- A full-page or viewport screenshot of each meaningful state.
- The console log, filtered to warnings/errors.
- Any non-2xx network response with the URL, status, and a short response body excerpt.
- A short narration: "Navigated to X, observed Y, clicked Z, observed W."
For a UI bug repro, also record:
- The exact reproduction steps the user can follow.
- Viewport size and (where relevant) device pixel ratio.
- Whether the bug reproduces on first load vs after interaction.
Login-gated pages
- Prefer programmatic auth (API token, magic link) over UI login.
- If UI login is the only path, the user must provide credentials explicitly for this run. Never reuse credentials outside the session.
- Do not store credentials in the session log, screenshot, or returned output.
Performance and politeness
- Throttle to one navigation per few seconds when touching shared infra.
- Respect
robots.txt for public sites you are inspecting at any volume.
- Cancel navigations if a page exceeds a reasonable timeout (e.g., 30s); the page is broken or rate-limiting you.
- Do not retry forever on failure. Retry once with a longer timeout, then escalate.
Common failure modes
- Selector not found. Page changed, or you are waiting before render. Take a screenshot to see actual state; adjust the selector.
- Click does nothing. The element is offscreen, covered by a modal, or in a shadow DOM. Scroll into view or pierce the shadow root.
- Headless detection. Some sites detect headless Chrome and serve a different page. Use a non-headless mode or a fingerprint-realistic configuration only when authorized.
- Cross-origin iframe blocking. Iframes you do not own cannot be inspected; the page must offer the data outside the iframe or the task is infeasible.
Anti-patterns
- Long unsupervised browser sessions that drift from the original task.
- Scraping behind authentication you do not own.
- Captioning a screenshot with "looks good" without saying what state was loaded and what selectors confirmed it.
- Treating a passing screenshot as proof of correctness across viewports you did not actually test.
1---
2name: agent-browser
3description: Drive a real browser to inspect or interact with a web page or app — navigate, take screenshots, read console and network, fill simple forms — for verification tasks, not unattended automation.
4key: paperclipai/optional/browser/agent-browser
5recommendedForRoles:
6 - qa
7 - engineer
8 - researcher
9tags:
10 - browser
11 - puppeteer
12 - playwright
13 - verification
14metadata:
15 source: https://skillmd.com/skills/paperclipai/agent-browser
16---
17
18# Agent Browser
19
20Use a controlled browser to verify behavior, capture evidence, or extract information from web pages that a static fetch cannot reach (SPAs, login-gated pages, dynamic content). This skill is about supervised verification, not unattended scraping.
21
22## When to use
23
24- You need a screenshot of a deployed page or a local dev server to confirm a UI change.
25- You need to read JavaScript-rendered content that `curl`/`wget` will not see.
26- A user reports a UI bug and you need to reproduce it interactively to capture console errors, network requests, or layout state.
27- You need to walk through a short flow (load page, click, observe) to verify acceptance criteria.
28
29## When not to use
30
31- The page is reachable as static HTML. Use `curl`/HTTP fetch — it is cheaper, faster, and more reliable.
32- The task is unattended large-scale scraping. That belongs to a dedicated scraper with rate limits, robots.txt handling, and a real user agent policy — not this skill.
33- The site is behind authentication you do not own credentials for, or whose terms of service prohibit automation.
34- The site involves sensitive accounts (banking, healthcare, government) where automation risks lockout or compliance issues.
35
36## Before launching the browser
37
38- Confirm the URL and what state should be true after navigation.
39- Decide what evidence is needed: full-page screenshot, viewport screenshot, console log, network trace, HTML snapshot, extracted text.
40- Decide the viewport size that matters for the task (mobile vs desktop). Default to a desktop size unless the task is mobile-specific.
41- For local dev servers, confirm the server is running and the port is what you expect.
42
43## Driving the browser
44
45A typical verification session:
46
471. **Launch with a real-looking user agent** when the target is the public internet; an unrealistic UA flags automation traffic.
482. **Set a sane viewport** (e.g., 1366×768 desktop, 390×844 iPhone-ish).
493. **Navigate and wait for the right signal.** Prefer waiting for a specific selector or network-idle over arbitrary sleeps.
504. **Capture evidence immediately** after the wait condition succeeds, before any interaction perturbs the state.
515. **Interact deliberately.** One click at a time, with a wait between actions; re-screenshot after each meaningful state change.
526. **Read the console and network panels** for unexpected errors, 4xx/5xx responses, or slow requests.
537. **Close the browser cleanly** when done. Long-running browser sessions leak memory and hold ports.
54
55## What evidence to record
56
57For a verification task, deliver:
58
59- A full-page or viewport screenshot of each meaningful state.
60- The console log, filtered to warnings/errors.
61- Any non-2xx network response with the URL, status, and a short response body excerpt.
62- A short narration: "Navigated to X, observed Y, clicked Z, observed W."
63
64For a UI bug repro, also record:
65
66- The exact reproduction steps the user can follow.
67- Viewport size and (where relevant) device pixel ratio.
68- Whether the bug reproduces on first load vs after interaction.
69
70## Login-gated pages
71
72- Prefer programmatic auth (API token, magic link) over UI login.
73- If UI login is the only path, the user must provide credentials explicitly for this run. Never reuse credentials outside the session.
74- Do not store credentials in the session log, screenshot, or returned output.
75
76## Performance and politeness
77
78- Throttle to one navigation per few seconds when touching shared infra.
79- Respect `robots.txt` for public sites you are inspecting at any volume.
80- Cancel navigations if a page exceeds a reasonable timeout (e.g., 30s); the page is broken or rate-limiting you.
81- Do not retry forever on failure. Retry once with a longer timeout, then escalate.
82
83## Common failure modes
84
85- **Selector not found.** Page changed, or you are waiting before render. Take a screenshot to see actual state; adjust the selector.
86- **Click does nothing.** The element is offscreen, covered by a modal, or in a shadow DOM. Scroll into view or pierce the shadow root.
87- **Headless detection.** Some sites detect headless Chrome and serve a different page. Use a non-headless mode or a fingerprint-realistic configuration only when authorized.
88- **Cross-origin iframe blocking.** Iframes you do not own cannot be inspected; the page must offer the data outside the iframe or the task is infeasible.
89
90## Anti-patterns
91
92- Long unsupervised browser sessions that drift from the original task.
93- Scraping behind authentication you do not own.
94- Captioning a screenshot with "looks good" without saying what state was loaded and what selectors confirmed it.
95- Treating a passing screenshot as proof of correctness across viewports you did not actually test.