/agent-reach

name: agent-reach
description: >
  Self-contained multi-platform internet search and read skill.
  Zero external dependencies — calls upstream tools (curl+Jina, gh, yt-dlp,
  xreach, mcporter) directly and degrades gracefully when tools are missing.
  Covers: web pages, GitHub, YouTube, Bilibili, Reddit, Twitter/X, XiaoHongShu,
  Douyin, Weibo, WeChat, V2EX, LinkedIn, RSS, Exa web search.
  Use when agent needs to search the web, read a URL, or gather research material.
  Triggers: "search", "read this URL", "搜索", "查一下", "上网搜", "帮我查",
  "search twitter", "youtube transcript", "search reddit", "web search",
  "B站", "bilibili", "小红书", "微博", "V2EX", "research".
allowed-tools:
  - Bash
  - Read

Multi-Platform Search & Read

Self-contained skill for searching and reading across 14+ platforms. No external installer needed — uses upstream CLI tools directly and degrades gracefully when specific tools are absent.

Probe (run first)

Detect which tools are available before choosing commands:

bash skills/agent-reach/scripts/probe.sh

Output is JSON with two sections:

• `tools`: which CLI tools are on PATH (curl, gh, yt-dlp, xreach, mcporter, python3, feedparser)
• `services`: which services are reachable — `jina` (Jina Reader), `mcporter_servers` (comma-separated list of registered MCP servers, e.g. `"exa,xiaohongshu"`)

**Only use mcporter commands for servers listed in `mcporter_servers`.** For example, if `weibo` is not in the list, the `mcporter call 'weibo.*'` commands below will fail — skip them and use the fallback instead.

If probe itself fails, assume only `curl` and `WebSearch` tool are available.

Tier 0 — Always Available (curl only)

These work on any machine with `curl`. No setup needed.

Read any web page (Jina Reader)

curl -s "https://r.jina.ai/<URL>"

Handles: articles, blog posts, documentation, most public web pages. This is the universal fallback for reading any URL.

Reddit (public JSON API)

# Search
curl -s "https://www.reddit.com/search.json?q=QUERY&limit=10" -H "User-Agent: ppt-agent/1.0"
# Subreddit hot posts
curl -s "https://www.reddit.com/r/SUBREDDIT/hot.json?limit=10" -H "User-Agent: ppt-agent/1.0"

> Server IPs may get 403. Fall back to Exa search (Tier 2) or WebSearch tool.

V2EX (public JSON API)

curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: ppt-agent/1.0"
curl -s "https://www.v2ex.com/api/topics/show.json?id=TOPIC_ID" -H "User-Agent: ppt-agent/1.0"

Tier 1 — Common CLI Tools

Available on most developer machines. Check probe output before using.

GitHub (`gh` CLI)

gh search repos "query" --sort stars --limit 10
gh repo view owner/repo
gh search code "query" --language python
gh issue list -R owner/repo --state open

> Fallback: `curl -s "https://r.jina.ai/https://github.com/owner/repo"`

YouTube / Bilibili (`yt-dlp`)

# YouTube — metadata
yt-dlp --dump-json "URL"
# YouTube — subtitles
yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --skip-download -o "/tmp/%(id)s" "URL"
# YouTube — search
yt-dlp --dump-json "ytsearch5:query"

# Bilibili — same tool
yt-dlp --dump-json "https://www.bilibili.com/video/BVxxx"
yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --convert-subs vtt --skip-download -o "/tmp/%(id)s" "URL"

> Bilibili on servers may get 412. Use `--cookies-from-browser chrome` if available. > Fallback: `curl -s "https://r.jina.ai/<video_url>"`

RSS (`python3` + `feedparser`)

python3 -c "
import feedparser
for e in feedparser.parse('FEED_URL').entries[:5]:
    print(f'{e.title} — {e.link}')
"

> If feedparser not installed: `pip install feedparser`

Tier 2 — Specialized Tools

These unlock platform-specific search. Check probe output — only use if available.

Exa Web Search (`mcporter`, requires `exa` in mcporter_servers)

mcporter call 'exa.web_search_exa(query: "query", numResults: 5)'

> Best general-purpose web search. Fallback: `WebSearch` tool.

Twitter/X (`xreach`)

xreach search "query" -n 10 --json          # search
xreach tweet URL_OR_ID --json                # read single tweet
xreach tweets @username -n 20 --json         # user timeline
xreach thread URL_OR_ID --json               # full thread

> Needs cookies configured. Proxy: `xreach search "query" --proxy "http://host:port"` > Fallback: `mcporter call 'exa.web_search_exa(query: "site:x.com query")'` or Jina Reader for single tweets.

小红书 / XiaoHongShu (`mcporter`, requires `xiaohongshu` in mcporter_servers)

mcporter call 'xiaohongshu.search_feeds(keyword: "query")'
mcporter call 'xiaohongshu.get_feed_detail(feed_id: "xxx", xsec_token: "yyy")'

> Requires Docker + login. Fallback: Jina Reader for individual note URLs.

抖音 / Douyin (`mcporter`, requires `douyin` in mcporter_servers)

mcporter call 'douyin.parse_douyin_video_info(share_link: "https://v.douyin.com/xxx/")'

> No login needed. Fallback: Jina Reader.

微博 / Weibo (`mcporter`, requires `weibo` in mcporter_servers)

mcporter call 'weibo.get_trendings(limit: 10)'
mcporter call 'weibo.search_weibo(keyword: "query", count: 10)'

> No auth required. Fallback: Exa `site:weibo.com` search or Jina Reader.

LinkedIn (`mcporter`, requires `linkedin` in mcporter_servers)

mcporter call 'linkedin.get_person_profile(linkedin_url: "https://linkedin.com/in/username")'

> Fallback: `curl -s "https://r.jina.ai/https://linkedin.com/in/username"`

微信公众号 / WeChat Articles

WeChat articles block Jina/curl. Needs specialized tools (miku_ai for search, Camoufox for reading). Fallback: Exa `site:mp.weixin.qq.com` or `WebSearch`.

Degradation Strategy

When a tool is missing, degrade — never block:

| Situation | Fallback | |-----------|----------| | `mcporter` missing or `exa` not in servers | `WebSearch` tool for web search | | `xreach` missing | Exa `site:x.com` search, or