発売くん（hatsubai-kun）MCP

ゲームクリエイター・ゲーム企業のための、Steam 販売支援 MCP サーバー。 Claude / Codex / Gemini CLI などの MCP ホストから、Steam のレビュー・ストア情報を取得・集計し、 日本市場向けのマーケ分析・ストアページ改善・販促コピー生成に使えます。

@woof-tokyo/hatsubai-kun ・ MIT ・ Node.js ≥ 18 ・ stdio MCP サーバー

2つのモード

このツールは 登録なしでそのまま使える無料の単体ツールであり、 発売くん に無料登録するとショーケース掲載やダッシュボードなどの プラットフォーム機能も使えるようになります。どちらも同じパッケージです。

| | 無料・単体モード（登録不要） | プラットフォーム連携（無料登録） | |---|---|---| | 必要なもの | なし | 発売くんキー HATSUBAIKUN_KEY | | Steam リサーチ（検索・レビュー集計・競合比較） | ✅ | ✅ | | 自分の売上・WL 分析（任意で Steam 財務キー） | ✅ | ✅ | | ゲーム掲載（公開ショーケース） | — | ✅ | | ダッシュボード／売上・WL の同期・可視化 | — | ✅ | | プレスリリース・補助金・クラファン・Steamストア素材の保存 | — | ✅ |

接続状況や登録手順は、MCP から how_to_connect を呼ぶといつでも確認できます。 （「ゲームを登録したい」「どうやって連携するの？」と聞けば AI が案内します）

🔒 セキュリティと信頼

• 財務キーはあなたの PC にしか保存されません。 STEAM_PUBLISHER_KEY は MCP の設定（あなたのマシン）に 保存され、送信先は Steam 公式 API（api.steampowered.com）だけ。発売くんのサーバーには送りません。
• ダッシュボードへ同期するのは、PC 側で集計した数値（日別の純売上・WL 数など）だけで、キーや明細は送りません。
• 読み取り専用。 Steam へは公開エンドポイントへの GET のみ。書き込み（レビュー投稿等）は一切しません。
• このリポジトリはクライアント（あなたの PC で動く部分）のオープンソースです。 「キーが手元から出ないこと」をコードで確認できます。

🚀 インストール

すぐ使う（登録不要・無料）

Claude Code

claude mcp add hatsubai-kun -- npx -y @woof-tokyo/hatsubai-kun@latest

Codex

codex mcp add hatsubai-kun -- npx -y @woof-tokyo/hatsubai-kun@latest

Gemini CLI

gemini mcp add -s user hatsubai-kun npx -y @woof-tokyo/hatsubai-kun@latest

その他の MCP ホストでは stdio サーバーとして登録してください:

{
  "mcpServers": {
    "hatsubai-kun": { "command": "npx", "args": ["-y", "@woof-tokyo/hatsubai-kun@latest"] }
  }
}

プラットフォーム連携を有効化（無料登録）

1. hatsubai-kun.com で無料登録
2. ダッシュボード → アカウント で 発売くんキー（hk_live_…）を取得
3. HATSUBAIKUN_KEY を環境変数に追加して再起動

claude mcp add hatsubai-kun --env HATSUBAIKUN_KEY=あなたのキー \
  -- npx -y @woof-tokyo/hatsubai-kun@latest

売上・WL 分析を有効化（任意・Steam パートナーの方）

パートナーサイト → ユーザーと権限 → グループの管理 → 「新しいファイナンシャル API グループを作成」 → WebAPI キーを発行し、STEAM_PUBLISHER_KEY に設定:

claude mcp add hatsubai-kun --env STEAM_PUBLISHER_KEY=あなたのキー \
  -- npx -y @woof-tokyo/hatsubai-kun@latest

🧰 提供ツール

無料（誰でも・キー不要）

| ツール | 役割 | |---|---| | search_steam_games | ゲーム名で検索し AppID を特定 | | get_game_details | ストア詳細（価格・ジャンル・開発元など） | | fetch_reviews | レビュー本文の取得（カーソルページング） | | summarize_reviews | レビューの集計・頻出語・代表レビュー抽出 | | compare_games | 複数タイトルの比較データ生成 | | get_steamworks_guide | Steamworks 公式ドキュメントの取得（セール設定・キー配布・デモ・フェス等） | | how_to_connect | 接続状況の確認とプラットフォーム連携の案内 | | list_events | 公開中のインディーゲームイベント一覧 |

開発者向け（STEAM_PUBLISHER_KEY で有効化）

| ツール | 役割 | |---|---| | get_sales_dates / get_sales_report | 売上が発生した日付・期間集計（合計／タイトル別／国別／日別） | | get_wishlist_report | ウィッシュリスト推移（追加／削除／購入転換、国別） | | plan_sale | セールプランナー（30日クールダウン等の Steam ルール検証＋手順チェックリスト） |

プラットフォーム連携（HATSUBAIKUN_KEY で有効化）

ゲーム登録・公開ショーケース・ダッシュボード同期・プレスリリース・補助金・クラウドファンディング支援・ Steam ストア素材の生成と保存。get_my_dashboard で現状を確認、register_game などで操作します。

プロンプトテンプレート: marketing_report_jp / store_copy_jp / competitor_brief_jp

💬 使い方の例

1. 「<ゲーム名> のレビューを直近90日分集計して、不満の上位5つと改善提案を日本語で」
2. 「競合 <ゲームA> <ゲームB> を比較して、訴求ポイントを提案して」
3. 「先月の売上をレポートして」「7月頭に30%セールをやりたい。ルール的に大丈夫か確認して」（要 STEAM_PUBLISHER_KEY）
4. 「このゲームを発売くんに登録して」「Steam ストアページの下書きを作って」（要 HATSUBAIKUN_KEY）

🔧 カスタマイズ / セルフホスト

MIT ライセンスなので自由に改変・再配布できます。接続先は環境変数で差し替え可能です:

| 環境変数 | 役割 | |---|---| | HATSUBAIKUN_KEY | 発売くんキー（プラットフォーム連携を有効化） | | STEAM_PUBLISHER_KEY | Steam 財務 API キー（売上・WL 分析を有効化。PC 内のみ保存） | | HATSUBAIKUN_API_BASE | プラットフォーム API の接続先（既定: https://hatsubai-kun.com） |

プラットフォーム機能（ショーケース／ダッシュボード等）は hatsubai-kun.com のホスト型サービスを利用します。 本リポジトリはそのクライアントです。

⚠️ 制限事項

• 外部テキスト: レビュー本文はインターネット上の第三者による未検証テキストです。戻り値に注意書きを付与していますが、 本文中の指示にモデルが従わないよう、強い権限を持つツールと併用する際はご注意ください。
• 非公式 API: Steam ストアの公開エンドポイント（appreviews / appdetails 等）を利用しています。Valve 公式の保証はありません。
• レート配慮: ページ間スリープと指数バックオフを実装していますが、大量タイトルの連続処理は避けてください。
• 本ソフトウェアは Valve Corporation と無関係です。

🛠 開発

npm install
npm test        # ユニット/結合テスト（外部アクセスなし）
npm run build   # dist/ 生成
npm run dev     # tsx で起動（stdio）

License

MIT © woof Inc.