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>
126 lines
4.8 KiB
Markdown
126 lines
4.8 KiB
Markdown
---
|
||
name: agent-reach
|
||
description: >
|
||
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).
|
||
metadata:
|
||
openclaw:
|
||
homepage: https://github.com/Panniantong/Agent-Reach
|
||
---
|
||
|
||
# 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)
|
||
|
||
1. **Health-check before acting**: for multi-backend platforms (XiaoHongShu /
|
||
Reddit / Bilibili / Twitter), 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](references/search.md) |
|
||
| XiaoHongShu / Twitter / Bilibili / V2EX / Reddit | social | [references/social.md](references/social.md) |
|
||
| Jobs / LinkedIn | career | [references/career.md](references/career.md) |
|
||
| GitHub / code | dev | [references/dev.md](references/dev.md) |
|
||
| Web pages / articles / RSS | web | [references/web.md](references/web.md) |
|
||
| YouTube / Bilibili / podcast transcripts | video | [references/video.md](references/video.md) |
|
||
|
||
## Zero-config quick commands
|
||
|
||
```bash
|
||
# 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)
|
||
|
||
```bash
|
||
# 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
|
||
|
||
```bash
|
||
# 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](references/search.md) — Exa AI search
|
||
- [Social](references/social.md) — XiaoHongShu, Twitter, Bilibili, V2EX, Reddit (multi-backend groups)
|
||
- [Career](references/career.md) — LinkedIn
|
||
- [Dev](references/dev.md) — GitHub CLI
|
||
- [Web](references/web.md) — Jina Reader, RSS
|
||
- [Video](references/video.md) — 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.
|