# By-Reach

By-Reach is an AI-agent routing and diagnostic package. Install with
`pipx install by-reach`; its Python import is `by_reach`, CLI is `by-reach`,
and persistent state is `~/.by-reach/`.

## Mandatory generic webpage route

For any website, webpage, article, static page, SPA, raw URL, or URL whose
content must be read, run exactly:

```bash
bycli web read --url "URL" --stdout
```

Do not obtain content through any other generic webpage mechanism before or
after this command. If byCLI fails, stop and report the failure.

## Source routes

- Twitter: `twitter-cli`, then one `bycli twitter search` fallback.
- Reddit: `rdt-cli`, then one `bycli reddit search` fallback.
- Bilibili: `bili-cli`, then one `bycli bilibili search` fallback.
- YouTube: `yt-dlp`, then one `bycli youtube search` fallback.
- V2EX/Xueqiu: packaged API route, then their declared byCLI fallback once.
- Facebook, Instagram, LinkedIn, XiaoHongShu: byCLI only.
- GitHub: `gh`; RSS: `feedparser`; Exa: `mcporter` + `exa.web_search_exa`.

Do not automate sign-in or read/inject browser cookies. A direct Twitter CLI
command requires `TWITTER_AUTH_TOKEN` and `TWITTER_CT0` in its process
environment.

Documentation: https://github.com/sovovs/By-Reach/tree/main/docs
