Browser Automation
Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications. Skill: Browser Automation Owner: peytoncasper Summary: Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications. Tags: latest:1.0.1 Version history: v1.0.1 | 2026-02-05T16:00:43.177Z | user Initial public release v1.0.0 | 2026-02-05
Rank
62
Safety
84
Downloads
43k
Updated
May 19, 2026
Version
1.0.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 42.7K downloads reported by the source. Last updated 5/19/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Adoption signal
- 42.7K downloadsadoption · observed May 19, 2026
- Vendor
- Clawhubvendor · observed May 17, 2026
- Protocol compatibility
- OpenClawcompatibility · observed May 17, 2026
- Adoption signal
- 42.3K downloadsadoption · observed May 17, 2026
- Latest release
- 1.0.1release · observed Feb 5, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install publishers:peytoncasper:browser-automation- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-peytoncasper-browser-automation-2/snapshot"
Documentation
CLAWHUB
50,747 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: browser
description: Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications.
allowed-tools: Bash
---
# Browser Automation
Automate browser interactions using Stagehand CLI with Claude.
### First: Environment Selection (Local vs Remote)
The skill automatically selects between local and remote browser environments:
- **If Browserbase API keys exist** (BROWSERBASE_API_KEY and BROWSERBASE_PROJECT_ID in .env file): Uses remote Browserbase environment
- **If no Browserbase API keys**: Falls back to local Chrome browser
- **No user prompting**: The selection happens automatically based on available configuration
## Setup (First Time Only)
Check `setup.json` in this directory. If `setupComplete: false`:
```bash
npm install # Install dependencies
npm link # Create global 'browser' command
```
## Commands
All commands work identically in both modes:
```bash
browser navigate <url> # Go to URL
browser act "<action>" # Natural language action
browser extract "<instruction>" ['{}'] # Extract data (optional schema)
browser observe "<query>" # Discover elements
browser screenshot # Take screenshot
browser close # Close browser
```
## Quick Example
```bash
browser navigate https://example.com
browser act "click the Sign In button"
browser extract "get the page title"
browser close
```
## Mode Comparison
| Feature | Local | Browserbase |
|---------|-------|-------------|
| Speed | Faster | Slightly slower |
| Setup | Chrome required | API key required |
| Stealth mode | No | Yes |
| Proxy/CAPTCHA | No | Yes |
| Best for | Development | Production/scraping |
## Best Practices
1. **Always navigate first** before interacting
2. **View screenshots** after each command to verify
3. **Be specific** in action descriptions
4. **Close browser** when done
## Troubleshooting
- **Chrome not found**: Install Chrome or use Browserbase mode
- **Action fails**: Use `browser observe` to discover available elements
- **Browserbase fails**: Verify API key and project ID are set
For detailed examples, see [EXAMPLES.md](EXAMPLES.md).
For API reference, see [REFERENCE.md](REFERENCE.md)._meta.json
{
"ownerId": "kn7ccvk3zbxj1yzzsxne9tfayn801hks",
"slug": "browser-automation",
"version": "1.0.1",
"publishedAt": 1770307243177
}EXAMPLES.md
# Browser Automation Examples
This document provides detailed examples of common browser automation tasks using the CLI tool.
## Example 1: Extract Product Information from E-commerce
**User request**: "Go to example.com/product/123 and extract the product details"
**Workflow**:
1. **Navigate** to the product page:
```bash
browser navigate https://example.com/product/123
```
2. **Extract** product data with schema:
```bash
browser extract "Extract the product information" '{"productName": "string", "price": "number", "currency": "string", "inStock": "boolean", "rating": "number", "reviewCount": "number"}'
```
3. **Close** the browser:
```bash
browser close
```
**Expected result**: JSON object with product details that can be analyzed or stored.
---
## Example 2: Fill Out and Submit a Contact Form
**User request**: "Fill out the contact form on example.com with my information"
**Workflow**:
1. **Navigate** to contact page:
```bash
browser navigate https://example.com/contact
```
2. **Act**: Fill in name field:
```bash
browser act "Fill in the name field with 'John Doe'"
```
3. **Act**: Fill in email field:
```bash
browser act "Fill in the email field with '[email protected]'"
```
4. **Act**: Fill in message field:
```bash
browser act "Fill in the message field with 'I would like to inquire about your services'"
```
5. **Act**: Submit the form:
```bash
browser act "Click the Submit button"
```
6. **Screenshot** to capture confirmation:
```bash
browser screenshot
```
7. **Close** the browser:
```bash
browser close
```
---
## Example 3: Research and Summarize News Articles
**User request**: "Check the latest tech news on techcrunch.com and summarize the top stories"
**Workflow**:
1. **Navigate** to news site:
```bash
browser navigate https://techcrunch.com
```
2. **Extract** article headlines and summaries:
```bash
browser extract "Extract the top 5 article headlines and their summaries" '{"headlines": "string", "summary": "string", "author": "string", "publishedDate": "string"}'
```
3. **Close** the browser:
```bash
browser close
```
4. Analyze and summarize the extracted data using Claude's text analysis capabilities.
---
## Example 4: Login and Navigate Authenticated Area
**User request**: "Log into example.com and navigate to my dashboard"
**Workflow**:
1. **Navigate** to login page:
```bash
browser navigate https://example.com/login
```
2. **Act**: Fill in username:
```bash
browser act "Fill in the username field with 'myusername'"
```
3. **Act**: Fill in password:
```bash
browser act "Fill in the password field with 'mypassword'"
```
4. **Act**: Click login button:
```bash
browser act "Click the Login button"
```
5. **Act**: Wait for page load:
```bash
browser act "Wait for the page to fully load"
```
6. **Navigate** to dashboard:
```bash
bREFERENCE.md
# Browser Automation CLI Reference
This document provides detailed technical reference for the CLI browser automation tool.
## Architecture Overview
The browser automation system consists of:
- **Stagehand**: TypeScript library wrapping Playwright for AI-driven browser control. Uses AI model to find and interact with the right elements, so be specific
- **Chrome CDP**: Chrome DevTools Protocol connection on port 9222
- **CLI Tool**: Command-line interface in `src/cli.ts` for browser automation
- **Local Chrome**: Chrome browser launched with remote debugging enabled
### File Locations
- **Chrome Profile**: `.chrome-profile/` - Persistent browser profile directory
- **Screenshots**: `./agent/browser_screenshots/` - Screenshot output directory
- **Downloads**: `./agent/downloads/` - File download directory
## CLI Command Reference
### navigate
Navigate to a URL in the browser.
**Usage**:
```bash
browser navigate <url>
```
**Parameters**:
- `url` (string, required): The URL to navigate to. Must include protocol (http:// or https://)
**Returns**:
JSON output:
```json
{
"success": true,
"message": "Successfully navigated to <url>",
"screenshot": "/path/to/screenshot.png"
}
```
**Implementation Details**:
- Uses Playwright's `page.goto()` under the hood
- Waits for network idle and DOM content loaded
- Automatically takes a screenshot after navigation
- Supports HTTPS upgrade for HTTP URLs
**Example**:
```bash
browser navigate https://example.com
```
**Error Handling**:
- Invalid URLs return error with `success: false`
- Network timeouts return timeout error
- SSL certificate errors may fail navigation
---
### act
Perform an action on the page using natural language.
**Usage**:
```bash
browser act "<action>"
```
**Parameters**:
- `action` (string, required): Natural language description of the action to perform
**Returns**:
JSON output:
```json
{
"success": true,
"message": "Successfully performed action: <action>",
"screenshot": "/path/to/screenshot.png"
}
```
Note: Without specificity it might succeed on the wrong element!
**Implementation Details**:
- Uses Stagehand's `page.act()` which leverages Claude Haiku 4.5
- AI model interprets natural language and executes corresponding browser actions
- Supports: clicking, typing, selecting, scrolling, waiting, hovering, and more
- Automatically handles element location and interaction
- Automatically takes a screenshot after the action
**Natural Language Examples**:
```bash
browser act "Click the login button"
browser act "Fill in email field with [email protected]"
browser act "Scroll to the bottom of the page"
browser act "Select 'California' from the state dropdown"
browser act "Hover over the menu icon"
browser act "Wait for 3 seconds"
browser act "Press the Enter key"
browser act "Double-click the file icon"
```
**Best Practices**:
- Be **specific** about which element to interact with
- Include visual descriptors ("button next to the form", "top menu", "form at botsetup.json
{
"setupComplete": false,
"prerequisites": {
"chrome": {
"required": true,
"installed": false,
"description": "Google Chrome browser"
},
"dependencies": {
"required": true,
"installed": false,
"description": "Node.js dependencies (npm install completed)"
},
"apiKey": {
"required": true,
"configured": false,
"description": "ANTHROPIC_API_KEY exported (i.e $ANTHROPIC_API_KEY) or in .env file"
},
"browserCommand": {
"required": true,
"installed": false,
"description": "Browser CLI command globally linked (npm link)"
}
},
"setupInstructions": [
"1. Run: npm install (this will automatically build TypeScript)",
"2. Run: npm link (this creates the global 'browser' command)",
"3. (RECOMMENDED) Export ANTHROPIC_API_KEY: export ANTHROPIC_API_KEY='your-api-key-here' (check if already exported)",
" OR alternatively create .env file: cp .env.example .env and edit it to add your API key",
"4. Ensure Google Chrome is installed on your system",
"5. Test installation: browser navigate https://example.com",
"6. Update this setup.json file: set all 'installed'/'configured' to true and 'setupComplete' to true"
],
"verifySetup": "Run 'browser navigate https://example.com' from any directory to verify installation"
}activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "42.7K downloads",
"href": "https://clawhub.ai/peytoncasper/browser-automation",
"sourceUrl": "https://clawhub.ai/peytoncasper/browser-automation",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-05-19T07:01:21.605Z",
"isPublic": true
},
{
"factKey": "vendor",
"label": "Vendor",
"value": "Clawhub",
"category": "vendor",
"href": "https://clawhub.ai/peytoncasper/browser-automation",
"sourceUrl": "https://clawhub.ai/peytoncasper/browser-automation",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-05-17T07:00:55.951Z",
"isPublic": true,
"metadata": {}
},
{
"factKey": "protocols",
"label": "Protocol compatibility",
"value": "OpenClaw",
"category": "compatibility",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-peytoncasper-browser-automation-2/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-peytoncasper-browser-automation-2/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-05-17T07:00:55.951Z",
"isPublic": true,
"metadata": {}
},
{
"factKey": "traction",
"label": "Adoption signal",
"value": "42.3K downloads",
"category": "adoption",
"href": "https://clawhub.ai/peytoncasper/browser-automation",
"sourceUrl": "https://clawhub.ai/peytoncasper/browser-automation",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-05-17T07:00:55.951Z",
"isPublic": true,
"metadata": {}
},
{
"factKey": "latest_release",
"label": "Latest release",
"value": "1.0.1",
"category": "release",
"href": "https://clawhub.ai/peytoncasper/browser-automation",
"sourceUrl": "https://clawhub.ai/peytoncasper/browser-automation",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-05T16:00:43.177Z",
"isPublic": true,
"metadata": {}
},
{
"factKey": "handshake_status",
"label": "Handshake status",
"value": "UNKNOWN",
"category": "security",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-peytoncasper-browser-automation-2/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-peytoncasper-browser-automation-2/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true,
"metadata": {}
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.1",
"description": "Initial public release",
"href": "https://clawhub.ai/peytoncasper/browser-automation",
"sourceUrl": "https://clawhub.ai/peytoncasper/browser-automation",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-05T16:00:43.177Z",
"isPublic": true,
"metadata": {}
}
]
}Record generated Oct 9, 2026.
