agent-reach

Agent Reach — 路由器

17 个平台工具集。根据用户意图路由到匹配的类别参考。

上游：Panniantong/Agent-Reach

自进化技能：此技能会在使用过程中不断改进。如果说明有误、参数发生变化，或需要变通方案，请立即修复此文件，不要拖延。仅针对真实且可复现的问题进行更新。

预检（自动更新）

每次使用前运行此操作。 它会确保 Agent Reach 已安装并更新至最新版本。

#!/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."

如果版本检查失败（无网络、GitHub 请求频率受限），则会静默继续使用已安装的版本。更新尽力而为，绝不会阻塞操作。

路由表

用户意图	类别	参考
网页搜索 / 代码搜索	search	references/search.md
小红书/抖音/微博/推特/B站/V2EX/Reddit	social	references/social.md
工作 / LinkedIn	career	references/career.md
GitHub / 代码	dev	references/dev.md
网页 / 文章 / 公众号 / RSS	web	references/web.md
YouTube / Bilibili / 播客	video	references/video.md

零配置快捷命令

# 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"

环境检查

# Check available channels
agent-reach doctor

# List all MCP services
mcporter_list_servers()

配置

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

频道专属设置详情请参阅 references/setup-channels.md。

工作区规则

切勿在 Agent 工作区中创建文件。 临时输出请使用 /tmp/，持久化数据请使用 ~/.agent-reach/。

故障排除

• 频道无法正常工作？ 运行 agent-reach doctor
• 手动更新： pipx upgrade agent-reach && agent-reach install --env=auto
• 完全重新安装： pipx reinstall agent-reach && agent-reach install --env=auto

执行后复盘

此技能完成后，关闭前请检查：

1. 命令是否成功？ — 如果没有，请修复导致失败的说明或错误表。
2. 参数或输出是否发生变化？ — 如果底层工具的接口发生变化，请更新用法示例和参数表，使其保持一致。
3. 是否需要变通方案？ — 如果你不得不临时调整（更换标志、增加步骤），请更新此 SKILL.md，避免下次调用时再次需要同样的变通方案。

仅在问题真实且可复现时更新，不要基于猜测更新。