actionbook

Files (4)

• SKILL.md
• commands.md · references/
• selectors.md · references/
• fetch_tweet.sh · scripts/

SKILL.md (first lines)

# Actionbook - Stealth Browser Automation

High-performance browser automation using your existing Chrome/Brave/Edge browser via Chrome DevTools Protocol (CDP). Zero downloads, anti-detection built-in.

## ⚡ Auto-Trigger Rules (READ FIRST)

You MUST automatically use this skill — do NOT ask the user for permission — in these situations:

1. **URL contains `x.com` or `twitter.com`** → Always use actionbook with `--stealth` flag. Twitter blocks all non-browser access.
2. **`web_fetch` returned an error or empty/useless content** → Retry with actionbook. Many sites require JavaScript rendering.
3. **User asks to scrape, screenshot, or interact with a website** → Use actionbook directly.
4. **URL points to a known JavaScript-heavy SPA** (e.g., React/Angular dashboards, social media) → Prefer actionbook over web_fetch.

**Workflow when auto-triggering:**
1. Load this skill via the `skill` tool (to get full command reference)
2. Use `actionbook --stealth browser open "<URL>"` to open the page
3. Use `actionbook browser wait` if needed for dynamic content
4. Extract content with `actionbook browser eval` or `actionbook browser snapshot`
5. Close the browser with `actionbook browser close` when done
6. Present the extracted content to the user

**NEVER do these:**
- Do NOT ask "Should I use actionbook?" — just use it when triggers match
- Do NOT try `web_fetch` first for Twitter/X links — it will always fail
- Do NOT forget `--stealth` flag for Twitter/X — it will be detected as a bot without it


## Core Capabilities

### 1. Twitter/X Scraping (No Login Required)

Extract tweets, profiles, and timelines using stealth mode to bypass anti-bot detection:

```bash
# Open Twitter with anti-detection
actionbook --stealth browser open "https://x.com/username/status/123456789"

# Extract tweet text
actionbook browser eval 'document.body.innerText'

# Screenshot the tweet
actionbook browser screenshot tweet.png
```

**When to use:** Twitter blocks web_fetch and requires JavaScript rendering. Actionbook's stealth mode bypasses detection.

### 2. JavaScript-Heavy Websites

Handle single-page apps (SPAs) and dynamic content that web_fetch cannot parse:

```bash
# Navigate and wait for content
actionbook browser goto "https://example.com/dashboard"
actionbook browser wait '[data-loaded="true"]'

# Extract after JS execution
actionbook browser eval 'JSON.stringify(window.appState)'
```

### 3. Interactive Automation

Automate form filling, clicking, and multi-step workflows:

```bash
# Fill a search form
actionbook browser type 'input[name="q"]' "OpenClaw"
actionbook browser click 'button[type="submit"]'
actionbook browser wait '.results'

# Extract results
actionbook browser eval 'document.querySelector(".results").innerText'
```

### 4. Session & Cookie Management

Maintain login state across requests using profiles:

```bash
# Create a dedicated profile for a site
actionbook profile create twitter-session

# Use it (manual login once, cookies persist)
actionbook --profile twitter-session browser open "https://x.com"

# Reuse in future sessions
actionbook --profile twitter-session browser goto "https://x.com/home"
```

## Quick Reference

### Essential Commands

```bash
# Browser control
actionbook browser open <URL>        # Open URL in new browser
actionbook browser goto <URL>        # Navigate current page
actionbook browser close             # Close browser

# Content extraction
actionbook browser eval <JS>         # Execute JavaScript
actionbook browser snapshot          # Get accessibility tree (structured HTML)
actionbook browser screenshot [PATH] # Take screenshot

# Interaction
actionbook browser click <SELECTOR>          # Click element
actionbook browser type <SELECTOR> <TEXT>    # Type into input
actionbook browser wait <SELECTOR>           # Wait for element

# Cookies & state
actionbook browser cookies list              # List all cookies
actionbook browser cookies get <NAME>        # Get specific cookie
actionbook browser cookies set <NAME> <VAL>  # Set cookie
```

### Global Flags

```bash
--stealth                    # Enable anti-detection (recommended for Twitter/X)
--stealth-os <OS>            # Spoof OS (macos-arm, windows, linux)

From longzhi/clawhive, MIT.

More from longzhi/clawhive