bbudiono · bbudiono · Jul 25, 2026 · Jul 25, 2026
diff --git a/skills/research/agent-reach/SKILL.md b/skills/research/agent-reach/SKILL.md
@@ -0,0 +1,90 @@
+---
+name: agent-reach
+description: "Give your AI agent eyes to see the entire internet. MUST USE when user wants to research, search, or browse anything online — 15 platforms, multi-backend routing. Covers: research/调研, search/搜索, social (小红书/Twitter/B站/V2EX/Reddit/Facebook/Instagram), career (LinkedIn), dev (GitHub), web, video (YouTube/B站/播客), finance (雪球). Source: https://github.com/Panniantong/Agent-Reach (60.8K stars, MIT, Python)"
+version: 1.0.0
+author: Hermes Agent
+platforms: [macos, linux, windows]
+tags: [research, web-search, social-media, twitter, reddit, github, bilibili, xiaohongshu, linkedin, youtube, v2ex, research-tool, internet-router]
+source: https://github.com/Panniantong/Agent-Reach
+---
+
+# Agent Reach — 互联网能力路由器
+
+Give your AI agent eyes to see the entire internet. 15 platforms, multi-backend routing (OpenCLI / per-platform CLIs / APIs). Zero config for 6 channels.
+
+**This skill MUST be used when accessing these platforms — do not invent custom solutions.**
+
+## Install
+
+```bash
+git clone https://github.com/Panniantong/Agent-Reach.git /tmp/agent-reach
+cd /tmp/agent-reach && pip install -e .
+
+# Verify installation
+agent-reach doctor --json
+```
+
+## 常驻规则（Standing Rules）
+
+1. **动手前先体检** — Run `agent-reach doctor --json` first; use each platform's `active_backend` field
+2. **声明你在用什么** — Say "using agent-reach's X platform / Y backend" before starting
+3. **失败按 references 里的重试链处理** — Follow retry chains in references docs, don't guess commands
+4. **全网调研类任务** — Combine multiple platforms (Exa + Twitter/Reddit + 小红书/B站), collect in parallel, then summarize
+5. **替用户盯版本** — After major research tasks, run `agent-reach check-update` and mention if a newer version exists
+
+## Routing Table
+
+| User Intent | Category | Docs |
+|------------|----------|------|
+| 网页搜索/代码搜索 | search | [references/search.md](references/search.md) |
+| 小红书/推特/B站/V2EX/Reddit/Facebook/Instagram | social | [references/social.md](references/social.md) |
+| 招聘/职位/LinkedIn | career | [references/career.md](references/career.md) |
+| GitHub/代码 | dev | [references/dev.md](references/dev.md) |
+| 网页/文章/RSS | web | [references/web.md](references/web.md) |
+| YouTube/B站/播客字幕 | video | [references/video.md](references/video.md) |
+
+## Zero-Config Quick Commands
+
+```bash
+# Exa 网页搜索
+mcporter call 'exa.web_search_exa(query: "query", numResults: 5)'
+
+# 通用网页阅读
+curl -s "https://r.jina.ai/URL"
+
+# GitHub 搜索
+gh search repos "query" --sort stars --limit 10
+
+# YouTube 字幕
+yt-dlp --write-sub --skip-download -o "/tmp/%(id)s" "URL"
+
+# V2EX 热门
+curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"
+
+# B站搜索（bili-cli，无需登录）
+bili search "query" --type video -n 5
+```
+
+## 15 Supported Platforms
+
+**Search**: Exa AI (英文/技术/代码搜索)
+
+**Social**: 小红书 (Xiaohongshu/XHS), Twitter/X, B站 (Bilibili), V2EX, Reddit, Facebook, Instagram
+
+**Career**: LinkedIn/领英
+
+**Dev**: GitHub (代码/仓库/issue/PR/分支)
+
+**Web**: 网页/文章/RSS
+
+**Video**: YouTube, B站, 播客/小宇宙
+
+**Finance**: 雪球/股票/xueqiu
+
+## Pitfalls
+
+1. **小红书 requires login-aware backend** — Run `agent-reach doctor --json` first; do not use browser Cookie login
+2. **Twitter requires explicit env vars** — `TWITTER_AUTH_TOKEN` + `TWITTER_CT0` must be set in subprocess; never log values
+3. **B站不要用 yt-dlp** — Use bili-cli instead (see references/video.md)
+4. **NOT for posting/commenting/liking** — This skill is read-only; use platform-specific skills for write operations
+5. **NOT for content processing/translation** — This skill only fetches content from the internet; use separate skills for analysis
diff --git a/skills/research/agent-reach/references/career.md b/skills/research/agent-reach/references/career.md
@@ -0,0 +1,29 @@
+# 职场招聘
+
+LinkedIn。
+
+## LinkedIn
+
+```bash
+# 获取个人资料
+mcporter call 'linkedin-scraper.get_person_profile(linkedin_url: "https://linkedin.com/in/username")'
+
+# 搜索人才
+mcporter call 'linkedin-scraper.search_people(keyword: "AI engineer", limit: 10)'
+
+# 获取公司资料
+mcporter call 'linkedin-scraper.get_company_profile(linkedin_url: "https://linkedin.com/company/xxx")'
+
+# 搜索职位
+mcporter call 'linkedin-scraper.search_jobs(keyword: "software engineer", limit: 10)'
+```
+
+> **需要登录**: LinkedIn scraper 需要有效的登录态。
+
+### Fallback 方案
+
+如果 MCP 不可用，可以用 Jina Reader：
+
+```bash
+curl -s "https://r.jina.ai/https://linkedin.com/in/username"
+```
diff --git a/skills/research/agent-reach/references/dev.md b/skills/research/agent-reach/references/dev.md
@@ -0,0 +1,62 @@
+# 开发工具
+
+GitHub CLI 
+
+## GitHub (gh CLI)
+
+GitHub 官方命令行工具，用于仓库、Issue、PR、Actions、Release 以及 API 访问。
+
+```bash
+# 认证
+gh auth login
+gh auth status
+
+# 搜索
+gh search repos "query" --sort stars --limit 10
+gh search code "query" --language python
+
+# 仓库
+gh repo view owner/repo
+gh repo clone owner/repo
+gh repo create my-repo --private
+gh repo fork owner/repo
+gh repo fork owner/repo --clone
+gh repo sync owner/repo
+
+# Issues
+gh issue list -R owner/repo --state open
+gh issue view 123 -R owner/repo
+gh issue create -R owner/repo --title "Title" --body "Body"
+
+# Pull Requests
+gh pr list -R owner/repo --state open
+gh pr view 123 -R owner/repo
+gh pr create -R owner/repo --title "Title" --body "Body"
+gh pr checks 123 --repo owner/repo
+
+# Actions / CI
+gh run list --repo owner/repo --limit 10
+gh run view <run-id> --repo owner/repo
+gh run view <run-id> --repo owner/repo --log-failed
+gh workflow list --repo owner/repo
+
+# Releases
+gh release list -R owner/repo
+gh release create v1.0.0
+
+# API
+gh api /user
+gh api repos/owner/repo
+
+# JSON 输出
+gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'
+```
+
+
+## 选择指南
+
+| 工具 | 来源 | 用途 |
+|-----|------|------|
+| gh CLI | agent-reach | Git 操作 |
+| zread | my-mcp-tools | 读仓库内容 |
+| context7 | my-mcp-tools | 查技术文档 |
diff --git a/skills/research/agent-reach/references/search.md b/skills/research/agent-reach/references/search.md
@@ -0,0 +1,33 @@
+# 搜索工具
+
+Exa AI 搜索引擎。
+
+## Exa AI 搜索
+
+高质量 AI 搜索引擎，擅长技术和代码搜索。
+
+```bash
+mcporter call 'exa.web_search_exa(query: "query", numResults: 5)'
+mcporter call 'exa.get_code_context_exa(query: "code question", tokensNum: 3000)'
+```
+
+### 使用场景
+
+| 场景 | 参数 |
+|-----|------|
+| 网页搜索 | `web_search_exa(query: "...", numResults: 5)` |
+| 代码搜索 | `get_code_context_exa(query: "...", tokensNum: 3000)` |
+
+### 特点
+
+- 擅长英文内容和技术文档
+- 支持代码上下文搜索
+- 结果质量高
+
+## 与其他搜索工具对比
+
+| 工具 | 来源 | 适用场景 |
+|-----|------|---------|
+| Exa | agent-reach | 英文/技术/代码搜索 |
+| 智谱搜索 | my-mcp-tools | 中文搜索 |
+| GitHub 搜索 | agent-reach (dev.md) | 仓库/代码搜索 |