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 のレート制限など）は、インストール済みのバージョンを使って処理を続行します。更新はベストエフォートで行われ、処理をブロックすることはありません。

ルーティングテーブル

ユーザーの意図	カテゴリ	リファレンス
Web 検索／コード検索	search	references/search.md
小红书／抖音／微博／推特／B站／V2EX／Reddit	social	references/social.md
求人／LinkedIn	career	references/career.md
GitHub／コード	dev	references/dev.md
Web ページ／記事／公众号／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 を参照してください。

ワークスペースのルール

エージェントのワークスペースにファイルを作成しないでください。 一時的な出力には /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 を更新してください。

実際に再現できる問題がある場合にのみ更新し、憶測で更新しないでください。