chase

<div align="center"> <pre> ╱|、 (˚ˎ 。7 |、˜〵 じしˍ,)ノ ░█████╗░██╗░░██╗░█████╗░░██████╗███████╗ ██╔══██╗██║░░██║██╔══██╗██╔════╝██╔════╝ ██║░░╚═╝███████║███████║╚█████╗░█████╗░░ ██║░░██╗██╔══██║██╔══██║░╚═══██╗██╔══╝░░ ╚█████╔╝██║░░██║██║░░██║██████╔╝███████╗ ░╚════╝░╚═╝░░╚═╝╚═╝░░╚═╝╚═════╝░╚══════╝ AI browser automation. Describe it. Automate it. </pre> </div> Tell Chase what you want. It spins up a real browser, navigates pages, clicks buttons, solves CAPTCHAs, and returns structured JSON. ## Quick Start ```bash npm install -g @browsercash/chase export BROWSER_CASH_API_KEY="your-key" # https://browser.cash ``` ```bash chase automate "Get the top 5 stories from Hacker News with title, points, and URL" ``` ```json { "success": true, "result": { "stories": [ { "title": "Show HN: ...", "points": 342, "url": "https://..." } ] } } ``` ## Commands ```bash # One-off automation chase automate "Find AirPods Pro price on Amazon" chase automate "Get 5 homes in Austin TX under 400k" --country US # Generate reusable scripts chase generate "Scrape today's deals from slickdeals.net" chase scripts # List saved scripts chase run script-abc123 # Run a saved script # Task management chase tasks # List recent tasks chase task task-xyz789 # Get task details ``` ### Options | Flag | Description | |------|-------------| | `--country <code>` | Browser geo-location (US, CA, ...) | | `--type <type>` | Node type: `hosted`, `consumer_distributed` | | `--adblock` | Block ads | | `--captcha` | Auto-solve CAPTCHAs | | `--json` | JSON output only (default) | | `--pretty` | Human-readable output | | `--verbose` | Show debug logs | | `--max-turns <n>` | Max Claude turns (default: 30) | ## Integrations ### Claude Code (Skill) ```bash curl -fsSL https://raw.githubusercontent.com/alexander-spring/chase/main/skill/install.sh | bash ``` Then ask Claude: *"Use chase to get the top posts from Reddit r/programming"* ### Claude Desktop / Cursor (MCP) Add to your MCP config: ```json { "mcpServers": { "chase": { "transport": "http", "url": "https://chase-api-264851422957.us-central1.run.app/mcp", "headers": { "x-api-key": "YOUR_API_KEY" } } } } ``` ## API Base: `https://chase-api-264851422957.us-central1.run.app` | Endpoint | Method | Description | |----------|--------|-------------| | `/automate/stream` | POST | Run a task, get results (SSE) | | `/generate/stream` | POST | Generate a reusable script (SSE) | | `/scripts` | GET | List saved scripts | | `/scripts/:id` | GET | Get script details | | `/scripts/:id/run` | POST | Execute a saved script (SSE) | | `/tasks` | GET | List recent tasks | | `/tasks/:id` | GET | Get task status/result | | `/health` | GET | Health check | | `/mcp` | POST | MCP HTTP transport | ```bash curl -N -X POST https://chase-api-264851422957.us-central1.run.app/automate/stream \ -H "Content-Type: application/json" \ -d '{"task": "Get the title of example.com", "browserCashApiKey": "your-key"}' ``` ## How It Works 1. Chase spins up a real browser via [Browser.cash](https://browser.cash/developer) 2. Claude navigates, clicks, fills forms, waits for content 3. Structured JSON is extracted and returned 4. Browser session is cleaned up automatically ## Self-Hosting ```bash git clone https://github.com/alexander-spring/chase.git && cd chase npm install && npm run build ANTHROPIC_API_KEY=sk-... npm run start:server # Or deploy to Cloud Run gcloud builds submit --config cloudbuild.yaml ``` ## License MIT