# tail-fin-cli

Unified CLI entry point for [tail-fin](https://github.com/motosan-dev/tail-fin) — multi-site browser automation.

## Install

```sh
# All adapters (default)
cargo install --path .

# Only specific adapters
cargo install --path . --no-default-features --features twitter,reddit
```

Available features: `twitter`, `reddit`, `bloomberg`, `coupang`, `pcc`, `instagram`, `xhs`, `youtube`, `grok`, `sa`, `s591`, `gen`, `nansen`

## Usage

```sh
# Sites that auto-launch a stealth browser
tail-fin coupang search "耳機" --limit 5
tail-fin pcc search "電腦"

# Sites that need your login session
tail-fin --connect 127.0.0.1:9222 twitter timeline
tail-fin --connect 127.0.0.1:9222 reddit hot --limit 10

# RSS (no browser needed)
tail-fin bloomberg markets --limit 5
```

## Global Flags

| Flag | Description |
|------|-------------|
| `--connect <host:port>` | Chrome remote debugging address |
| `--cookies [path]` | Use saved cookies |
| `--headed` | Run browser in visible mode |

All commands output JSON to stdout, errors to stderr.

## License

[MIT](../../LICENSE)
