Initial commit with translated description

This commit is contained in:
2026-03-29 13:15:43 +08:00
commit 8067ab9461
5 changed files with 957 additions and 0 deletions

73
SKILL.md Normal file
View File

@@ -0,0 +1,73 @@
---
name: browser
description: "使用自然语言自动化网页浏览器交互。"
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).