Pre-release

This release is a pre-release and may not be stable for production use.

By-Reach

By-Reach routes AI-agent research to approved source executors and provides installation and diagnostic commands for those routes.

The webpage rule

After a task has entered By-Reach routing, every website or URL read uses byCLI:

bycli web read --url "https://example.com" --stdout

This applies equally to static pages, SPAs, articles, raw files, and pages that do not require sign-in. There is no generic-web fallback. If byCLI cannot read the target, stop and report the failure.

By-Reach does not automate sign-in, read browser cookies, or inject credentials. byCLI session use must be explicitly established and authorized by the user.

Source routes

Target First executor One fallback, only after failure or invalid content
Generic webpage bycli web read none
Twitter/X twitter-cli bycli twitter search
Reddit rdt-cli bycli reddit search
Bilibili bili-cli bycli bilibili search
YouTube yt-dlp bycli youtube search
V2EX packaged V2EX API route bycli v2ex hot
Xueqiu packaged Xueqiu API route bycli xueqiu search
Facebook, Instagram, LinkedIn, XiaoHongShu byCLI none
GitHub gh none
RSS feedparser none
Exa search mcporter → exa.web_search_exa none
Xiaoyuzhou By-Reach transcription none

Run a source-specific primary once. An empty, challenge, malformed, or error-shaped result counts as failure; then run the listed byCLI fallback once. Never replace either route with a generic webpage mechanism.

Install

pipx install by-reach
by-reach install --env=auto          # read-only diagnosis
by-reach install --env=auto --system # only after the user authorizes changes
by-reach doctor --json

--system installs the required byCLI core and registers the By-Reach Skill. The default command changes nothing. See the installation guide for the complete safety boundary and optional channel setup.

Use

by-reach read "https://example.com"
by-reach doctor --json
by-reach skill --install

Persistent configuration is stored in ~/.by-reach/. Public environment variables use the BY_REACH_ prefix. The packaged Skill is named by-reach.

For a direct twitter command, explicitly set credentials in that command's environment; saved configuration only helps by-reach doctor identify missing setup:

export TWITTER_AUTH_TOKEN="..."
export TWITTER_CT0="..."
twitter search "query" -n 10

Development

pip install -e '.[dev]'
ruff check by_reach tests
mypy by_reach
pytest -q

See CONTRIBUTING.md and SECURITY.md. This project is a public fork of Panniantong/Agent-Reach; its MIT license and complete upstream Git history are retained.

Project links

Data verified by PyPI on Aug 14, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for 2304sovh from gravatar.com 2304sovh

Credits

Author: sovovs

GitHub Statistics

Data verified by PyPI on Aug 14, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.10

Provides Extra

all browser cookies dev mcp

Tags

agent-infrastructure ai-agent ai-search automation bilibili claude-code cli cursor free-api llm-tools mcp no-api-key openai reddit-scraper search twitter-scraper web-reader web-scraper xiaohongshu youtube-transcript

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

by_reach-2.0.0b1.tar.gz (574.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

by_reach-2.0.0b1-py3-none-any.whl (106.4 kB view details)

Uploaded Python 3

File details

Details for the file by_reach-2.0.0b1.tar.gz.

File metadata

  • Download URL: by_reach-2.0.0b1.tar.gz
  • Upload date:
  • Size: 574.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for by_reach-2.0.0b1.tar.gz
Algorithm Hash digest
SHA256 aaf1d5d3c95b2f91c21a8b3a2443ad8942ea6f0aac900efb473aa1fc2af235d6
MD5 79dfa069e3c7cab935a5ae4bd94efb2d
BLAKE2b-256 8d76b9c772f1aa20b238ae9d991edade5586eaea3be5b20d8bf8fcc808db1aa5

See more details on using hashes here.

Provenance

The following attestation bundles were made for by_reach-2.0.0b1.tar.gz:

Publisher: publish.yml on sovovs/By-Reach

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file by_reach-2.0.0b1-py3-none-any.whl.

File metadata

  • Download URL: by_reach-2.0.0b1-py3-none-any.whl
  • Upload date:
  • Size: 106.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for by_reach-2.0.0b1-py3-none-any.whl
Algorithm Hash digest
SHA256 6325ede6aa81bace796f25c6a2bb7c0d1a948e5fc27715bc77a31b7fe562a152
MD5 c76d5a891571b9c4f1ee947cc7210bc8
BLAKE2b-256 a47106e8cd2f759e0b76094113c6b69ba61ad0a39519cc4c29ff73afea7cbff8

See more details on using hashes here.

Provenance

The following attestation bundles were made for by_reach-2.0.0b1-py3-none-any.whl:

Publisher: publish.yml on sovovs/By-Reach

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page