xfetch

# xfetch - X/Twitter CLI Data Fetcher

xfetch is a cookie-based X/Twitter scraper CLI. It requires no API keys - just browser cookies for authentication. It's installed globally as `xfetch` (or can be run via `npx @lxgic/xfetch` / `bunx @lxgic/xfetch`).

## Prerequisites

Authentication must be set up first. Check with:

```bash
xfetch auth check
```

If not authenticated, extract cookies from the user's browser:

```bash
xfetch auth extract --browser chrome          # or firefox, safari, arc, brave
xfetch auth extract --browser chrome --profile "Profile 1"  # specific profile
```

Or set tokens directly:

```bash
xfetch auth set --auth-token <token> --ct0 <token>
```

## Command Reference

### Single Tweet

Accepts a tweet URL or numeric ID:

```bash
xfetch tweet https://x.com/user/status/123456789
xfetch tweet 123456789
```

Also works with X Article URLs (`/article/ID`).

### User Profile

```bash
xfetch user @handle        # by handle (@ is optional)
xfetch user 12345678       # by numeric ID
```

### User Tweets

```bash
xfetch tweets @handle                     # latest 20 tweets
xfetch tweets @handle -n 50              # 50 per page
xfetch tweets @handle --replies           # include replies
xfetch tweets @handle --all              # all pages (paginated)
xfetch tweets @handle --max-pages 5      # limit to 5 pages
```

### Thread / Conversation

```bash
xfetch thread <url-or-id>    # full conversation thread
```

### Search

```bash
xfetch search "query"                          # top results
xfetch search "query" --type latest            # latest tweets
xfetch search "query" --type people            # user results
xfetch search "query" --type photos            # photo tweets
xfetch search "query" --type videos            # video tweets
xfetch search "from:handle since:2024-01-01"   # advanced operators
xfetch search "query" -n 100 --all             # all pages
```

Search types: `top` (default), `latest`, `people`, `photos`, `videos`.

### Timelines

```bash...