Pnant
fc24fb699b
The one-liner entry docs were untouched by the backend upgrade — new users following "帮我安装 Agent Reach" would still get the old world. Now: - docs/install.md: xiaohongshu section rewritten (desktop OpenCLI with the one manual extension click / server xiaohongshu-mcp with QR + 150MB first-run warning / legacy xhs-cli kept as fallback); Reddit section says plainly there is no zero-config path; optional-channel menu gains OpenCLI; upstream table matches the new routing with a doctor --json pointer - docs/update.md: full rewrite — upgrade-only-what-exists tool refresh (incl. npm update for OpenCLI/mcporter, pinned git source for rdt-cli), one-time OpenCLI offer for desktops, skill sync now rides doctor's auto-sync instead of an inline python blob, WeChat-era content removed - check-update / watch: "update available" now leads with the one-liner (帮我更新 Agent Reach：<update.md>) which updates package + tools + skill; bare pip stays as the package-only alternative - fix: version compare was `!=` — a local build AHEAD of the latest release (installed from main during a release window) was told to "update" into a downgrade; now semantic tuple compare with fallback (+4 tests) - skill (zh+en): description gains a NOT-for boundary (fetch-only, no write ops, defer to dedicated skills); new standing rule — after substantial tasks run check-update and append a one-liner update hint to the wrap-up, never interrupting or nagging - SKILL_en.md restructured to the same three-layer skeleton as the Chinese version (124-line body, shared references/) instead of a 263-line everything-inline page Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
4.8 KiB
4.8 KiB
name, description, metadata
| name | description | metadata | ||||
|---|---|---|---|---|---|---|
| agent-reach | MUST USE when user wants to research/search/look up/find anything on the internet — e.g. "research this topic", "do a deep dive on X", "search the web for X", "see what people say about X", "look this up". Also MUST USE when user mentions any platform or shares any URL/link: Twitter/X, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu, Xiaoyuzhou Podcast, LinkedIn/jobs/recruiting, V2EX, Xueqiu (stocks), RSS. 13 platforms, multi-backend routing (OpenCLI / per-platform CLIs / APIs). Zero config for 6 channels. Run `agent-reach doctor --json` to see which backend serves each platform right now. NOT for: writing reports/analysis/translation (this skill only FETCHES internet content); posting/commenting/liking (write operations); platforms that already have a dedicated skill installed (prefer that skill). |
|
Agent Reach — internet capability router
13 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)
- Health-check before acting: for multi-backend platforms (XiaoHongShu /
Reddit / Bilibili / Twitter), run
agent-reach doctor --jsonfirst and pick the command group matching each platform'sactive_backend. - Announce what you use: say "using agent-reach, platform X via backend Y" before starting.
- On failure, follow the retry chains in references/ — never guess commands.
- For broad research tasks: combine platforms (Exa for web search + Twitter/Reddit for discussions + XiaoHongShu/Bilibili for Chinese perspectives), collect in parallel, then synthesize.
- 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 | 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
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 (multi-backend 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.