browsex

# browsex

Manipulate X(formerly Twitter) using the OpenClaw browser tool. Browser-based alternative to bird CLI.

## Prerequisites

### Environment requirements
- OpenClaw with browser tool enabled
- `openclaw` browser profile
- X/Twitter account logged in *(only required for posting, liking, retweeting, replying, following)*

Read-only browsing (viewing profiles, individual tweets, search) works without login.
X may show login popups on unauthenticated sessions -- dismiss them or ignore.

### For headless servers

Xvfb virtual display required (see spool skill's Prerequisites)

### Login (only needed for write actions)

```
browser action=start profile=openclaw
browser action=open profile=openclaw targetUrl="https://x.com/login"
# Ask user to log in manually
```

---

## Usage

### Read-only (no login required)

These actions work without an X/Twitter account. X may show login modals after
a few pages -- look for close/dismiss buttons in the snapshot and click them.

### 1. View a specific tweet

```
browser action=open profile=openclaw targetUrl="https://x.com/username/status/1234567890"
browser action=snapshot profile=openclaw compact=true
```

### 2. View profile

```
browser action=open profile=openclaw targetUrl="https://x.com/username"
browser action=snapshot profile=openclaw compact=true
```

### 3. Search

```
browser action=open profile=openclaw targetUrl="https://x.com/search?q=search_term&src=typed_query"
browser action=snapshot profile=openclaw compact=true
```

### Login required

These actions require an authenticated session. Complete the login step in Prerequisites first.

### 4. Read timeline

```
browser action=open profile=openclaw targetUrl="https://x.com/home"
browser action=snapshot profile=openclaw compact=true
```

For each article, you can see author, content, and like/retweet/reply counts.

### 5. Post a tweet

**Step 1: Find the textbox on home**
```
browser action=open profile=openclaw targetUrl="https://x.com/home"
browser action=snaps...