agent-reach
Give your AI agent eyes to see the entire internet. 17 platforms via CLI, MCP, curl, and Python scripts. Zero config for 8 channels. Route by intent: search / social (小红书/抖音/微博/推特/B站/V2EX/Reddit) / career (LinkedIn) / dev (GitHub) / web (网页/文章/公众号/RSS) / video (YouTube/B站/播客). Use when user asks to search, read, or interact on any supported platform, shares a URL from a supported site, or asks to search the web. Triggers: "search twitter", "youtube transcript", "search reddit", "read this link", "bilibili", "web search", "research this", "search weibo", "wechat article", "xiaohongshu", "douyin", "podcast transcript", "V2EX", "RSS feed", "xueqiu", "stock".
- Installs
- 193
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/terrylica/cc-skills --skill agent-reach- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads agent-reach automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Agent Reach — Router
17 platform toolset. Route by user intent to the matching category reference.
Upstream: Panniantong/Agent-Reach
Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.
Preflight (Auto-Update)
Run this before every use. It ensures Agent Reach is installed and up-to-date.
#!/usr/bin/env bash
set -euo pipefail
PASS=true
# 1. Check if agent-reach CLI exists
if ! command -v agent-reach &>/dev/null; then
echo " MISSING agent-reach CLI"
echo " Installing via pipx..."
if command -v pipx &>/dev/null; then
pipx install https://github.com/Panniantong/agent-reach/archive/main.zip --python python3.14 2>&1
agent-reach install --env=auto 2>&1
echo " OK agent-reach installed"
else
echo " FAIL pipx not found. Install: brew install pipx"
PASS=false
fi
else
INSTALLED=$(agent-reach --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' || echo "0.0.0")
echo " OK agent-reach v${INSTALLED}"
# 2. Check for updates (non-blocking: 5s timeout, failures are non-fatal)
LATEST=$(curl -sf --max-time 5 https://api.github.com/repos/Panniantong/Agent-Reach/releases/latest 2>/dev/null \
| python3 -c "import sys,json; print(json.load(sys.stdin).get('tag_name','').lstrip('v'))" 2>/dev/null || echo "")
if [[ -n "$LATEST" && "$LATEST" != "$INSTALLED" ]]; then
echo " UPDATE v${INSTALLED} → v${LATEST}"
echo " Upgrading..."
pipx upgrade agent-reach 2>&1 | tail -1
# Re-run install to update tools and SKILL.md
agent-reach install --env=auto 2>&1 | grep -E '^\s*(✅|--|✗|\[)' | head -20
echo " OK Updated to v${LATEST}"
fi
fi
# 3. Quick health check (which channels are active?)
if command -v agent-reach &>/dev/null; then
DOCTOR_OUTPUT=$(agent-reach doctor 2>&1)
ACTIVE=$(echo "$DOCTOR_OUTPUT" | grep -c '✅' || true)
TOTAL=$(echo "$DOCTOR_OUTPUT" | grep -cE '(✅|--)' || true)
echo " OK ${ACTIVE}/${TOTAL} channels active"
fi
if ! $PASS; then
echo "FAIL: Agent Reach not available."
exit 1
fi
echo "Preflight passed."
If the version check fails (no network, GitHub rate-limited), it silently continues with the installed version. Updates are best-effort, never blocking.
Routing Table
| User Intent | Category | Reference |
|---|---|---|
| Web search / code search | search | references/search.md |
| 小红书/抖音/微博/推特/B站/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 / podcasts | 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
# Twitter search
twitter search "query" --limit 10
# YouTube / Bilibili subtitles
yt-dlp --write-sub --skip-download -o "/tmp/%(id)s" "URL"
# Reddit search + read
rdt search "query" --limit 10
rdt read POST_ID
# V2EX hot topics
curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"
Environment Check
# Check available channels
agent-reach doctor
# List all MCP services
mcporter_list_servers()
Configuration
agent-reach configure proxy http://user:pass@ip:port # Reddit/Bilibili proxy
agent-reach configure twitter-cookies "auth_token=xxx; ct0=yyy"
agent-reach configure groq-key gsk_xxxxx # Xiaoyuzhou podcasts
agent-reach configure xhs-cookies "key1=val1; key2=val2" # XiaoHongShu
agent-reach configure --from-browser chrome # Auto-extract all cookies
For channel-specific setup details, see references/setup-channels.md.
Workspace Rules
Never create files in the agent workspace. Use /tmp/ for temporary output and ~/.agent-reach/ for persistent data.
Troubleshooting
- Channel not working? Run
agent-reach doctor - Update manually:
pipx upgrade agent-reach && agent-reach install --env=auto - Full reinstall:
pipx reinstall agent-reach && agent-reach install --env=auto
Post-Execution Reflection
After this skill completes, check before closing:
- Did the command succeed? — If not, fix the instruction or error table that caused the failure.
- Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
- Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.
Only update if the issue is real and reproducible — not speculative.
FAQ
What does the agent-reach skill do?
Give your AI agent eyes to see the entire internet. 17 platforms via CLI, MCP, curl, and Python scripts. Zero config for 8 channels. Route by intent: search / social (小红书/抖音/微博/推特/B站/V2EX/Reddit) / career (LinkedIn) / dev (GitHub) / web (网页/文章/公众号/RSS) / video (YouTube/B站/播客). Use when user asks to search, read, or interact on any supported platform, shares a URL from a supported site, or asks to search the web. Triggers: "search twitter", "youtube transcript", "search reddit", "read this link", "bilibili", "web search", "research this", "search weibo", "wechat article", "xiaohongshu", "douyin", "podcast transcript", "V2EX", "RSS feed", "xueqiu", "stock".
How do I install agent-reach?
Run npx skills add https://github.com/terrylica/cc-skills --skill agent-reach in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/agent-reach/ (personal) or .claude/skills/agent-reach/ (project).
Which AI agents can use agent-reach?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is agent-reach safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains agent-reach?
It is published by terrylica in terrylica/cc-skills. It has 193 recorded installs.
More from terrylica/cc-skills
mise-tasks
terrylica/cc-skills
Orchestrate multi-step project workflows using mise task definitions with dependency management and argument handling. Use whenever the user.
pandoc-pdf-generation
terrylica/cc-skills
PDF generation from markdown via Pandoc/XeLaTeX. TRIGGERS - markdown for PDF, print document, pandoc
mql5-indicator-patterns
terrylica/cc-skills
MQL5 indicator development patterns. TRIGGERS - MQL5 indicator, OnCalculate, indicator buffers, MetaTrader 5.
python-logging-best-practices
terrylica/cc-skills
Python logging with loguru, structlog, and orjson. TRIGGERS - loguru, structlog, structured logging
Popular marketing & seo skills
reddit-automation
flowkit-labs/skills
Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.
twitter-automation
101-skills/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
twitter-automation
magentosh/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
twitter-automation
qu-skills/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
product-launch-video
heygen-com/hyperframes
Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.
twitter-automation
skills-shell/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet