Skip to main content
skill CX Codex

agent-reach · terrylica — Claude Code skill: search across 17 platforms

The agent-reach skill equips your agent with web search and reading capabilities across 17 platforms: social networks (Twitter, Reddit, Weibo, Xiaohongshu, Douyin, Bilibili, V2EX), job boards (LinkedIn), GitHub, YouTube, podcasts.

MIT 195 installs ★ 3 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add terrylica/cc-skills --skill agent-reach -a claude-code
Open on GitHub

What agent-reach does

agent-reach routes agent requests to 17 platforms based on user intent: web search, social media, jobs, code, articles, and video. It bundles platform-specific commands: exa.web_search_exa() for web queries, curl via Jina Reader for page content, yt-dlp for YouTube and Bilibili transcripts, rdt for Reddit operations, twitter CLI for tweet lookup. Eight channels work out-of-the-box; others need API keys or browser cookies (Twitter, Xiaohongshu, proxy for Reddit and Bilibili).

On each invocation, the skill verifies the agent-reach CLI is installed via pipx and auto-upgrades to the latest version (5-second network timeout; falls back to installed version if offline). After installation, run agent-reach install --env=auto to activate tools. Use agent-reach doctor to see which channels are active. If a channel fails, check dependencies: Bilibili and Reddit require HTTP proxy; Twitter and Xiaohongshu need browser cookies, which can be extracted automatically via agent-reach configure --from-browser chrome.

What it helps with

  • fetch and extract article text from the web without opening a browser
  • gather trending posts from Twitter, Reddit, or Xiaohongshu matching a query
  • retrieve captions and transcripts from YouTube or Bilibili video
  • search for job openings on LinkedIn or GitHub by role and location
  • monitor trending topics on V2EX, Weibo, or custom RSS feeds

Example prompts for the agent

  • Find the top articles on machine learning and summarize key insights from each
  • Get the transcript of the latest YouTube video from a channel and extract takeaways
  • Show trending posts on Xiaohongshu about web design from this week

How to install agent-reach

1Skills CLI (Vercel)

npx skills add terrylica/cc-skills --skill agent-reach -a claude-code

2Manually: put the files in place

~/.claude/skills/agent-reach/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/agent-reach/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about agent-reach

How do I install agent-reach in Claude Code?

Run npx skills add terrylica/cc-skills --skill agent-reach -a claude-code, then open ~/.claude/skills/agent-reach/SKILL.md. Next, execute agent-reach install --env=auto and verify channels with agent-reach doctor.

What does agent-reach do?

Routes agent queries to 17 platforms: web search, social networks (Twitter, Reddit, Weibo, TikTok, Bilibili, V2EX), LinkedIn, GitHub, YouTube, podcasts, articles, and RSS. Eight channels require no setup; others need API keys or browser cookies.

Which channels work without configuration?

Exa (search), Jina (web page reading), GitHub (gh CLI), YouTube (yt-dlp), V2EX (public API), and a few others. Twitter, Xiaohongshu, Reddit and Bilibili need cookies or proxy — configure via agent-reach configure or auto-extract with agent-reach configure --from-browser chrome.

Source text

SKILL.md · MIT
---
name: agent-reach
description: >
  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".
allowed-tools: Read, Write, Edit, Bash, Glob, Grep
---

# Agent Reach — Router

17 platform toolset. Route by user intent to the matching category reference.

**Upstream**: [Panniantong/Agent-Reach](https://github.com/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.

```bash
#!/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](references/search.md) |
| 小红书/抖音/微博/推特/B站/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 / podcasts         | 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

# 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

```bash
# Check available channels
agent-reach doctor

# List all MCP services
mcporter_list_servers()
```

## Configuration

```bash
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](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:

1. **Did the command succeed?** — If not, fix the instruction or error table that caused the failure.
2. **Did parameters or output change?** — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. **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.

© terrylica · MIT · terrylica/cc-skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

agent-reach by other authors comes first.

agent-reach EdisonChenAI agent-reach connects your coding agent to the open web: search and read posts on Twitter/X, Reddit, YouTube, GitHub, Bilibili, 小红书, 抖音, LinkedIn, 微信公众号 articles and RSS, or any page. CX Codex +1 788installs apify-ultimate-scraper apify apify-ultimate-scraper connects your coding agent to Apify actors to extract web data from social networks, maps, and search engines into structured JSON or CSV files. CX Codex +1 16,900installs linkedin membrane Skill to interact with LinkedIn via Membrane: create and manage posts, comments, and reactions; fetch profiles and organizations without worrying about authentication. Requires a Membrane account (free tier available) and network access. CX Codex +1 211installs Social Profile Lookup — Twitter, GitHub, LinkedIn axel-belfort Social Profile Lookup — Twitter, GitHub, LinkedIn is an MCP server for Claude Code that fetches profile data from Twitter, GitHub, LinkedIn and YouTube by handle or URL. CX Codex +1 6,933installs google-search-agent-teneo TeneoProtocolAI google-search-agent-teneo — a skill for Claude Code, Codex, Cursor and other platforms that runs Google Search Agent through Teneo Protocol. Activated when you need command syntax, arguments or pricing before executing a search query. CX Codex +1 521installs firecrawl firecrawl firecrawl is a Claude Code skill that uses the Firecrawl CLI for live-web tasks. It finds pages, extracts content, and tracks changes across websites. CX Codex +1 104,500installs firecrawl-build-interact firecrawl firecrawl-build-interact — a coding-agent skill that gets Firecrawl /interact into product code when a page has to be clicked, filled in or paged through before you can read it. CX Codex +1 62,600installs

From the same set79

The whole set →
latex-tables Teaches the agent to build LaTeX tables with tabularray: fixed column widths, alignment, rule lines. Useful when a tblr has to be written from scratch or an old table rewritten. CX Codex +1 242installs latex-build latex-build is a Claude Code skill that builds LaTeX documents with latexmk, watches files for changes, and helps diagnose compilation errors. CX Codex +1 236installs ascii-diagram-validator The ascii-diagram-validator skill finds structural alignment problems in Markdown box diagrams and reports where they occur. Run it after editing architecture docs or README files. CX Codex +1 217installs calendar-event-manager calendar-event-manager builds macOS Calendar events with layered sound alarms and matching Reminders, so a meeting does not slip past you. CX Codex +1 214installs code-hardcode-audit code-hardcode-audit scans codebases for raw credentials, magic numbers, and duplicated blocks. It coordinates nine static analysis utilities through uv. CX Codex +1 166installs documentation-standards documentation-standards defines Markdown guidelines tailored for LLM parsing and clean Pandoc PDF export. It stops broken section numbering and unstructured doc sprawl. CX Codex +1 161installs imessage-query imessage-query pulls conversations out of ~/Library/Messages/chat.db with SQLite, searches across chats, and recovers text from binary attributedBody blobs. CX Codex +1 159installs clickhouse-architect clickhouse-architect designs ClickHouse v24.4+ table schemas, selects compression codecs, and configures sorting keys for cloud and self-hosted clusters. CX Codex +1 157installs

Project sponsors

Companies that keep this analytics open