Back to Details

agent-reach

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Agent Reach

Agent Reach

Read and search the internet across 9+ platforms via unified CLI.
通过统一的CLI在9+个平台上读取和搜索互联网内容。

Setup

安装配置

First check if agent-reach is installed:
bash
agent-reach doctor
If command not found, install it:
bash
pip install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto
install
auto-detects your environment and installs all dependencies (Node.js, mcporter, bird CLI, gh CLI). Read the output and run 
agent-reach doctor
to see what's active.
For channels that need user input, ask the user. See the full setup guide: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
首先检查agent-reach是否已安装：
bash
agent-reach doctor
若未找到该命令，请进行安装：
bash
pip install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto
install
命令会自动检测你的环境并安装所有依赖项（Node.js、mcporter、bird CLI、gh CLI）。查看输出结果后，运行
agent-reach doctor
查看已激活的组件。
对于需要用户输入信息的渠道，请向用户获取相关内容。查看完整安装指南： https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

Commands

命令说明

Read any URL

读取任意URL

bash
agent-reach read <url>
agent-reach read <url> --json    # structured output
Handles: tweets, Reddit posts, articles, YouTube (transcripts), GitHub repos, etc.
bash
agent-reach read <url>
agent-reach read <url> --json    # 结构化输出
支持处理：推文、Reddit帖子、文章、YouTube（字幕）、GitHub仓库等。

Search

搜索

bash
agent-reach search "query"             # web search (Exa)
agent-reach search-twitter "query"     # Twitter/X
agent-reach search-reddit "query"      # Reddit (--sub <subreddit>)
agent-reach search-github "query"      # GitHub (--lang <language>)
agent-reach search-youtube "query"     # YouTube
agent-reach search-bilibili "query"    # Bilibili (B站)
agent-reach search-xhs "query"        # XiaoHongShu (小红书)
All search commands support 
-n <count>
for number of results.
bash
agent-reach search "query"             # 网页搜索（基于Exa）
agent-reach search-twitter "query"     # Twitter/X搜索
agent-reach search-reddit "query"      # Reddit搜索（--sub <子版块>）
agent-reach search-github "query"      # GitHub搜索（--lang <编程语言>）
agent-reach search-youtube "query"     # YouTube搜索
agent-reach search-bilibili "query"    # Bilibili（B站）搜索
agent-reach search-xhs "query"        # XiaoHongShu（小红书）搜索
所有搜索命令均支持
-n <数量>
参数指定结果条数。

Management

管理

bash
agent-reach doctor        # channel status overview
agent-reach watch         # quick health + update check (for scheduled tasks)
agent-reach check-update  # check for new versions
bash
agent-reach doctor        # 渠道状态概览
agent-reach watch         # 快速健康检查与更新检测（适用于定时任务）
agent-reach check-update  # 检查新版本

Configure channels

配置渠道

bash
agent-reach configure twitter-cookies "auth_token=xxx; ct0=yyy"
agent-reach configure proxy http://user:pass@ip:port
agent-reach configure --from-browser chrome    # auto-extract cookies
bash
agent-reach configure twitter-cookies "auth_token=xxx; ct0=yyy"
agent-reach configure proxy http://user:pass@ip:port
agent-reach configure --from-browser chrome    # 自动提取Cookie

Channel Status Tiers

渠道状态等级

  • Tier 0 (zero config): Web, YouTube, RSS, Twitter (read-only via Jina)
  • Tier 1 (free setup): Exa web search (mcporter required)
  • Tier 2 (user config): Twitter search (cookie), Reddit full (proxy), GitHub (token), Bilibili (proxy), XiaoHongShu (MCP)
Run 
agent-reach doctor
to see which channels are active.
  • Tier 0（零配置）： 网页、YouTube、RSS、Twitter（通过Jina只读访问）
  • Tier 1（免费配置）： Exa网页搜索（需mcporter）
  • Tier 2（用户自定义配置）： Twitter搜索（需Cookie）、完整Reddit访问（需代理）、GitHub（需令牌）、B站（需代理）、小红书（需MCP）
运行
agent-reach doctor
查看已激活的渠道。

Tips

小贴士

  • Always try 
    agent-reach read <url>
    first for any URL — it auto-detects the platform
  • For Twitter cookies, recommend the user install Cookie-Editor Chrome extension
  • Reddit and Bilibili block server IPs — suggest a residential proxy (~$1/month) if on a server
  • If a channel breaks, run 
    agent-reach doctor
    to diagnose
  • 对于任意URL，优先尝试
    agent-reach read <url>
    命令——它会自动检测平台类型
  • 关于Twitter Cookie，建议用户安装Chrome扩展Cookie-Editor
  • Reddit和B站会屏蔽服务器IP——若在服务器上使用，建议使用住宅代理（约1美元/月）
  • 若某渠道无法使用，运行
    agent-reach doctor
    进行诊断