scout-mcp: Instructions file for Claude Code

scout-mcp — マルチソース情報偵察 MCP サーバー

これは何？

Claude Code からツール呼び出しで使える 情報偵察（スカウト）MCP サーバー。 X(Twitter), GitHub, Hacker News, Product Hunt, npm, PyPI, x402 Bazaar を横断検索し、 技術トレンド・競合・マーケット情報を構造化 JSON で返す。

x402 HTTP API としても公開中: https://scout.hugen.tokyo（USDC on Base）

設計思想

1. デュアルモード — MCP (stdio) + HTTP (Express + x402) の2モードで同じツール群を共有
2. 最小依存 — @modelcontextprotocol/sdk, zod, dotenv, express, @x402/*
3. 個別ツール + 合成レポート — 21 ツールが独立動作し、scout_report が並列合成する
4. x402 マイクロペイメント — $0.001/req (無料ソース) 〜 $0.05/req (X含む)
5. 1 ソース失敗 ≠ 全滅 — Promise.allSettled で部分的成功を許容

プロジェクト構造

scout-mcp/
├── package.json
├── tsconfig.json
├── .env                   # API キー + x402 設定（git 管理外）
├── .env.example           # テンプレート
├── .gitignore
├── CLAUDE.md              # ← このファイル
├── self_pay.py            # Bazaar セルフペイスクリプト
├── src/
│   ├── index.ts           # MCP サーバーエントリ (StdioServerTransport)
│   ├── server.ts          # HTTP サーバー (Express + x402 ミドルウェア)
│   ├── cli.ts             # テスト CLI (node build/cli.js <tool> '<json>')
│   ├── config.ts          # 環境変数・定数・デフォルト値
│   ├── fetch-utils.ts     # safeFetch (timeout/abort/error handling)
│   ├── types.ts           # ToolResult, ScoutError, ok(), fail()
│   └── tools/
│       ├── x-search.ts             # X 検索 (xAI Grok API)
│       ├── hackernews-search.ts    # HN 検索 (Algolia API)
│       ├── npm-search.ts           # npm Registry 検索
│       ├── github-search.ts        # GitHub リポ検索
│       ├── github-repo-info.ts     # GitHub リポ詳細
│       ├── pypi-search.ts          # PyPI パッケージ検索
│       ├── producthunt-search.ts   # Product Hunt 検索 (GraphQL)
│       ├── bazaar-search.ts        # x402 Bazaar 検索 (CDP Discovery)
│       ├── devto-search.ts         # Dev.to 記事検索 (Forem API)
│       ├── hashnode-search.ts      # Hashnode 記事検索 (GraphQL)
│       ├── lobsters-search.ts      # Lobste.rs 検索 (JSON API)
│       ├── stackexchange-search.ts # StackExchange 検索 (API v2.3)
│       ├── arxiv-search.ts         # ArXiv 論文検索 (Atom API)
│       ├── reddit-search.ts        # Reddit 検索 (.json feeds, MCP限定)
│       ├── youtube-search.ts       # YouTube 検索 (Data API v3)
│       ├── zenn-search.ts          # Zenn 記事検索 (非公式API, MCP限定)
│       ├── qiita-search.ts         # Qiita 記事検索 (API v2, MCP限定)
│       ├── semantic-scholar-search.ts # Semantic Scholar 論文検索
│       ├── lemmy-search.ts         # Lemmy 検索 (Fediverse, MCP限定)
│       ├── gitlab-search.ts        # GitLab プロジェクト検索
│       └── scout-report.ts         # 複合レポート (並列実行)
└── build/                 # tsc 出力（git 管理外）