| 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)
curl -s "https://www.reddit.com/search.json?q=QUERY&limit=10" -H "User-Agent: ppt-agent/1.0"
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)
yt-dlp --dump-json "URL"
yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --skip-download -o "/tmp/%(id)s" "URL"
yt-dlp --dump-json "ytsearch5:query"
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
xreach tweet URL_OR_ID --json
xreach tweets @username -n 20 --json
xreach thread URL_OR_ID --json
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 Jina Reader for single tweet URLs |
yt-dlp missing | Jina Reader: curl -s "https://r.jina.ai/<video_url>" |
gh missing | Jina Reader: curl -s "https://r.jina.ai/<github_url>" |
| mcporter server not registered (weibo, douyin, etc.) | Jina Reader for URLs, Exa site: search, or skip platform |
curl missing | WebSearch tool + WebFetch tool |
| All tools missing | WebSearch tool only — still functional for research |
The minimum viable setup is zero tools installed — the agent always has WebSearch as the ultimate fallback.
Troubleshooting
- Reddit 403: Server IP blocked. Use Exa search or
WebSearch tool.
- Bilibili 412: IP rate-limited. Try
--cookies-from-browser chrome or use Jina Reader.
- Twitter fetch failed: Use
--proxy flag, or fall back to Exa site:x.com search.
- mcporter not found: Most Tier 2 platforms won't work. Fall back to Jina Reader for individual URLs,
WebSearch for search queries.
License
This skill's command reference and platform architecture are derived from Agent Reach by Agent Eyes, licensed under the MIT License.
