agent-reach

Agent Reach — internet capability router

15 platforms, multiple backends each. When this skill exists, use it for these platforms — do not invent your own approach.

Standing rules (apply for the whole session)

1. Health-check before acting: for multi-backend/login-backed platforms (XiaoHongShu / Reddit / Bilibili / Twitter / Facebook / Instagram), run agent-reach doctor --json first and pick the command group matching each platform's active_backend.
2. Announce what you use: say "using agent-reach, platform X via backend Y" before starting.
3. On failure, follow the retry chains in references/ — never guess commands.
4. For broad research tasks: combine platforms (Exa for web search + Twitter/Reddit for discussions + XiaoHongShu/Bilibili for Chinese perspectives), collect in parallel, then synthesize.
5. Watch versions for the user: after finishing a substantial multi-platform task, run agent-reach check-update (fast, one API call). If a new version exists, append one line to your wrap-up: "Agent Reach vX.Y.Z is available — paste this to me to update: 帮我更新 Agent Reach： https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md". Never interrupt the current task to update; never nag about the same version twice.

Routing table

User intent	Category	Details
Web / code search	search	references/search.md
XiaoHongShu / Twitter / Bilibili / V2EX / Reddit / Facebook / Instagram	social	references/social.md
Jobs / LinkedIn	career	references/career.md
GitHub / code	dev	references/dev.md
Web pages / articles / RSS	web	references/web.md
YouTube / Bilibili / podcast transcripts	video	references/video.md

Zero-config quick commands

# Exa web search
mcporter call 'exa.web_search_exa(query: "query", numResults: 5)'

# Read any web page
curl -s "https://r.jina.ai/URL"

# GitHub search
gh search repos "query" --sort stars --limit 10

# YouTube subtitles (NOTE: never use yt-dlp for Bilibili — see video.md)
yt-dlp --write-sub --skip-download -o "/tmp/%(id)s" "URL"

# V2EX hot topics
curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"

# Bilibili search (bili-cli, no login needed)
bili search "query" --type video -n 5

Login-backed platforms (pick by doctor's active_backend)

# Twitter search (twitter-cli preferred; retry chain in social.md)
twitter search "query" -n 10

# Reddit (NO zero-config path — OpenCLI or rdt-cli, login required)
opencli reddit search "query" -f yaml   # desktop
rdt search "query" --limit 10            # legacy/server

# XiaoHongShu (desktop prefers OpenCLI)
opencli xiaohongshu search "query" -f yaml

# Facebook / Instagram (desktop OpenCLI, browser session)
opencli facebook search "query" -f yaml
opencli facebook groups -f yaml
opencli instagram search "query" -f yaml       # user search
opencli instagram user USERNAME -f yaml        # recent posts from one user

Environment check

# Channel availability + which backend serves each platform
agent-reach doctor --json

Workspace rules

Never create files in the agent workspace. Use /tmp/ for temporary output and ~/.agent-reach/ for persistent data.

Detailed references

Read the matching file when you need specifics (commands above cover the common cases; references hold per-backend command groups, caveats, retry chains — note: reference docs are written in Chinese, commands are universal):

• Search — Exa AI search
• Social — XiaoHongShu, Twitter, Bilibili, V2EX, Reddit, Facebook, Instagram (multi-backend/login-backed groups)
• Career — LinkedIn
• Dev — GitHub CLI
• Web — Jina Reader, RSS
• Video — YouTube, Bilibili, Xiaoyuzhou

Configure a channel

If a channel needs setup, fetch the install guide: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

The user only provides cookies / one extension click; the agent does the rest.