browser-tools

Category: Tools & Productivity | Uploader: goncalossilva | Downloads: 0 | Version: v1.0（Latest）

Interactive browser automation via Chrome DevTools Protocol. Use when you need to interact with web pages, test frontends, or when user interaction with a visible browser is required.

Changelog: Source: GitHub https://github.com/goncalossilva/.agents

Directory Structure

Current level: tree/main/skills/browser-tools/

📄 .gitignore 134 B
📄 browser-content.js 2.8 KB
📄 browser-cookies.js 1.0 KB
📄 browser-dismiss-cookies.js 12.6 KB
📄 browser-eval.js 675 B
📄 browser-logs-tail.js 2.3 KB
📄 browser-nav.js 820 B
📄 browser-net-summary.js 3.0 KB
📄 browser-pick.js 4.7 KB
📄 browser-screenshot.js 488 B
📄 browser-start.js 6.8 KB
📄 browser-watch.js 7.5 KB
📄 package-lock.json 82.8 KB
📄 package.json 487 B
📄 SKILL.md 4.6 KB
📄 utils.js 1.3 KB

SKILL.md

---
name: browser-tools
description: Interactive browser automation via Chrome DevTools Protocol. Use when you need to interact with web pages, test frontends, or when user interaction with a visible browser is required.
---

# Browser Tools

Chrome DevTools Protocol tools for agent-assisted web automation. These tools connect to a Chromium-based browser (Chromium/Chrome) running on `:9222` with remote debugging enabled.

## Setup

Run once before first use:

```bash
cd "$HOME/.agents/skills/browser-tools"
npm install
```

## Start Chromium / Chrome

```bash
"$HOME/.agents/skills/browser-tools/browser-start.js"              # Fresh profile
"$HOME/.agents/skills/browser-tools/browser-start.js" --profile    # Copy your profile (cookies, logins)
"$HOME/.agents/skills/browser-tools/browser-start.js" --watch      # Start background JSONL logging
"$HOME/.agents/skills/browser-tools/browser-start.js" --browser chromium
"$HOME/.agents/skills/browser-tools/browser-start.js" --browser chrome
```

Launch a browser with remote debugging on `:9222`. Use `--profile` to preserve your authentication state.

If the auto-detection picks the wrong browser, set:

- `BROWSER_TOOLS_BROWSER=chromium` (or `chrome`)
- `BROWSER_TOOLS_EXECUTABLE=/absolute/path/to/browser`
- `BROWSER_TOOLS_PROFILE_SRC=/absolute/path/to/profile/dir` (optional)

## Navigate

```bash
"$HOME/.agents/skills/browser-tools/browser-nav.js" https://example.com
"$HOME/.agents/skills/browser-tools/browser-nav.js" https://example.com --new
```

Navigate to URLs. Use `--new` flag to open in a new tab instead of reusing current tab.

## Evaluate JavaScript

```bash
"$HOME/.agents/skills/browser-tools/browser-eval.js" 'document.title'
"$HOME/.agents/skills/browser-tools/browser-eval.js" 'document.querySelectorAll("a").length'
```

Execute JavaScript in the active tab. Code runs in async context. Use this to extract data, inspect page state, or perform DOM operations programmatically.

For multi-line code or statements, wrap in an IIFE:

```bash
"$HOME/.agents/skills/browser-tools/browser-eval.js" '(() => { const x = 1; return x + 1; })()'
```

## Screenshot

```bash
"$HOME/.agents/skills/browser-tools/browser-screenshot.js"
```

Capture current viewport and return temporary file path. Use this to visually inspect page state or verify UI changes.

## Pick Elements

```bash
"$HOME/.agents/skills/browser-tools/browser-pick.js" "Click the submit button"
```

Use this when the user wants to select specific DOM elements on the page. This launches an interactive picker: click elements to select them, Cmd/Ctrl+Click for multi-select, Enter to finish.

## Dismiss cookie banners

```bash
"$HOME/.agents/skills/browser-tools/browser-dismiss-cookies.js"          # Accept cookies
"$HOME/.agents/skills/browser-tools/browser-dismiss-cookies.js" --reject # Reject (where possible)
```

Run after navigation if cookie dialogs interfere with interaction.

## Cookies

```bash
"$HOME/.agents/skills/browser-tools/browser-cookies.js"
"$HOME/.agents/skills/browser-tools/browser-cookies.js" --format=netscape > cookies.txt
```

Display all cookies for the current tab including domain, path, httpOnly, and secure flags.

The `--format=netscape` option outputs cookies in Netscape format for use with curl/wget (`curl -b cookies.txt`).

## Extract Page Content

```bash
"$HOME/.agents/skills/browser-tools/browser-content.js" https://example.com
```

Navigate to a URL and extract readable content as markdown. Uses Mozilla Readability for article extraction and Turndown for HTML-to-markdown conversion.

## Background logging (console + errors + network)

Start the watcher:

```bash
"$HOME/.agents/skills/browser-tools/browser-watch.js"
```

Or launch the browser with logging enabled:

```bash
"$HOME/.agents/skills/browser-tools/browser-start.js" --watch
```

Logs are written as JSONL to a temp directory by default:

- Default: `/tmp/agent-browser-tools/logs/YYYY-MM-DD/<targetId>.jsonl`
- Override: `BROWSER_TOOLS_LOG_ROOT=/some/dir`

Tail the most recent log:

```bash
"$HOME/.agents/skills/browser-tools/browser-logs-tail.js"           # dump and exit
"$HOME/.agents/skills/browser-tools/browser-logs-tail.js" --follow  # follow
```

Summarize network responses (status codes, failures):

```bash
"$HOME/.agents/skills/browser-tools/browser-net-summary.js"
"$HOME/.agents/skills/browser-tools/browser-net-summary.js" --file /path/to/log.jsonl
```

## When to Use

- Testing frontend code in a real browser
- Interacting with pages that require JavaScript
- When user needs to visually see or interact with a page
- Debugging authentication or session issues
- Scraping dynamic content that requires JS execution

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

browser-tools

Directory Structure

SKILL.md

Report

Notice