|
|
@@ -0,0 +1,104 @@
|
|
|
+# Stagehand Browser Automation Plugin
|
|
|
+
|
|
|
+Browser automation skill for Claude Code using [Stagehand](https://github.com/browserbase/stagehand). This plugin enables Claude to automate web browser interactions, extract data, and navigate websites using natural language.
|
|
|
+
|
|
|
+## Installation
|
|
|
+
|
|
|
+Install the plugin from the Claude Code marketplace:
|
|
|
+
|
|
|
+```bash
|
|
|
+/plugin install stagehand@claude-plugin-directory
|
|
|
+```
|
|
|
+
|
|
|
+## Prerequisites
|
|
|
+
|
|
|
+This plugin requires the browser automation CLI tools to be installed separately. The CLI tools are available from the GitHub marketplace.
|
|
|
+
|
|
|
+### Step 1: Add the GitHub Marketplace
|
|
|
+
|
|
|
+```bash
|
|
|
+/plugin marketplace add browserbase/agent-browse
|
|
|
+```
|
|
|
+
|
|
|
+### Step 2: Install the Browser Automation CLI Plugin
|
|
|
+
|
|
|
+```bash
|
|
|
+/plugin install browser-automation@browser-tools
|
|
|
+```
|
|
|
+
|
|
|
+### Step 3: Set Up the CLI Tools
|
|
|
+
|
|
|
+After installing the browser-automation plugin, you need to set up the CLI tools:
|
|
|
+
|
|
|
+1. Navigate to the plugin directory (typically `~/.claude/plugins/browser-automation/`)
|
|
|
+2. Install dependencies and build:
|
|
|
+ ```bash
|
|
|
+ npm install
|
|
|
+ ```
|
|
|
+3. Link the browser command globally:
|
|
|
+ ```bash
|
|
|
+ npm link
|
|
|
+ ```
|
|
|
+4. Configure your Anthropic API key:
|
|
|
+ ```bash
|
|
|
+ export ANTHROPIC_API_KEY="your-api-key-here"
|
|
|
+ ```
|
|
|
+ Or use Claude Code's subscription token (recommended if you have Claude Pro/Max):
|
|
|
+ ```bash
|
|
|
+ claude setup-token
|
|
|
+ ```
|
|
|
+
|
|
|
+### Step 4: Verify Installation
|
|
|
+
|
|
|
+Test that the browser command is available:
|
|
|
+
|
|
|
+```bash
|
|
|
+browser navigate https://example.com
|
|
|
+```
|
|
|
+
|
|
|
+## Usage
|
|
|
+
|
|
|
+Once installed and configured, you can use natural language to automate browser tasks:
|
|
|
+
|
|
|
+- *"Go to Hacker News, get the top post comments, and summarize them"*
|
|
|
+- *"QA test http://localhost:3000 and fix any bugs you encounter"*
|
|
|
+- *"Extract product information from example.com/products"*
|
|
|
+
|
|
|
+Claude will automatically use the browser automation skill when you ask for web-related tasks.
|
|
|
+
|
|
|
+## Features
|
|
|
+
|
|
|
+- **Natural Language Control**: Describe browser actions in plain English
|
|
|
+- **Data Extraction**: Extract structured data from web pages
|
|
|
+- **Screenshot Capture**: Take screenshots for visual verification
|
|
|
+- **Persistent Sessions**: Browser state persists between commands
|
|
|
+- **Chrome Profile Integration**: Uses your Chrome profile for cookies and sessions
|
|
|
+
|
|
|
+## Troubleshooting
|
|
|
+
|
|
|
+### Chrome not found
|
|
|
+
|
|
|
+Install Chrome for your platform:
|
|
|
+- **macOS** or **Windows**: https://www.google.com/chrome/
|
|
|
+- **Linux**: `sudo apt install google-chrome-stable`
|
|
|
+
|
|
|
+### Browser command not found
|
|
|
+
|
|
|
+Make sure you've run `npm link` in the browser-automation plugin directory after installing it.
|
|
|
+
|
|
|
+### API Key Issues
|
|
|
+
|
|
|
+- If you have Claude Pro/Max, use `claude setup-token` (recommended)
|
|
|
+- Otherwise, export `ANTHROPIC_API_KEY` in your terminal
|
|
|
+- Or create a `.env` file in the plugin directory with your API key
|
|
|
+
|
|
|
+## Resources
|
|
|
+
|
|
|
+- [Stagehand Documentation](https://github.com/browserbase/stagehand)
|
|
|
+- [GitHub Marketplace](https://github.com/browserbase/agent-browse)
|
|
|
+- [Claude Code Skills Documentation](https://code.claude.com/docs/en/plugins)
|
|
|
+
|
|
|
+## Support
|
|
|
+
|
|
|
+For issues or questions, please visit the [GitHub repository](https://github.com/browserbase/agent-browse).
|
|
|
+
|