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 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 .