# Private Tools Hub

個人開発ツール群のモノレポ。Steamセール情報、YouTubeランダム再生、マンガビューア/管理の4プロジェクトを集約。

## プロジェクト一覧

| プロジェクト | 説明 | 技術スタック | 本番URL | データ規模 |
|---|---|---|---|---|
| [steam](steam.md) | Steamセール情報ダッシュボード | Next.js 16, React 19, TypeScript, Tailwind 4 | [steam-deals-chi.vercel.app](https://steam-deals-chi.vercel.app) | ライブAPI (最大500件, 5分キャッシュ) |
| [youtube](youtube.md) | YouTubeチャンネルランダムプレイヤー | Python 3, HTML/JS, YouTube Data API v3 | [ss919008.stars.ne.jp/rodoku/](http://ss919008.stars.ne.jp/rodoku/) | ~7,700動画 (3チャンネル) |
| [pico](pico.md) | ピッコマ/LINEマンガ ランキングビューア | Python (scraper), Static HTML/JS | [ss919008.stars.ne.jp/pico/](http://ss919008.stars.ne.jp/pico/) | 148,430作品 (111MB CSV) |
| [raw](raw.md) | 漫画Raw 4サイト総合管理 | Node.js/Express, PHP, Python (scraper) | [ss919008.stars.ne.jp/raw/](http://ss919008.stars.ne.jp/raw/) | ~60,000作品 (33MB JSON) |

**ホスティング**: steam は Vercel、その他は Star Server (`ss919008.stars.ne.jp`)
**ポータル**: [ss919008.stars.ne.jp](http://ss919008.stars.ne.jp/) (ルート)

## クイックスタート

### 前提条件

- Node.js 18+（steam, raw で必要）
- Python 3（youtube, pico, raw のスクレイパーで必要）
- pip パッケージ: `requests`, `beautifulsoup4`, `aiohttp`, `pandas` 等（プロジェクトごとに異なる）

### 各プロジェクトの起動

```bash
# Steam セール情報
cd steam && npm install && npm run dev
# → http://localhost:3000

# YouTube ランダムプレイヤー
cd rodoku && python server.py --local
# → http://localhost:18936（ブラウザ自動起動）

# ピッコマ/LINEマンガ ビューア
# ブラウザで pico/index.html を直接開く（サーバー不要）

# 漫画マネージャー
cd raw && npm install && npm start
# → http://localhost:3000
```

## ディレクトリ構造

```
private/
├── index.html          # 総合管理ポータルページ
├── docs/               # ドキュメント
│   ├── README.md       # このファイル
│   ├── architecture.md # 全体アーキテクチャ
│   ├── steam.md        # Steam プロジェクト詳細
│   ├── youtube.md      # YouTube プロジェクト詳細
│   ├── pico.md         # Pico プロジェクト詳細
│   └── raw.md          # Raw プロジェクト詳細
├── steam/              # Steamセール情報（Next.js）
├── rodoku/            # YouTubeランダムプレイヤー（Python）
├── pico/               # ピッコマ/LINEマンガビューア（Static HTML）
├── raw/                # 漫画Raw管理（Node.js/PHP）
├── .claude/            # Claude Code 設定
├── CLAUDE.md           # Claude Code 指示ファイル
└── .gitignore
```

## ドキュメントリンク

- [全体アーキテクチャ](architecture.md) — 技術比較・共通パターン・設計思想
- [Steam セール情報](steam.md) — Next.js 16 + React 19 によるSteamセールダッシュボード
- [YouTube ランダムプレイヤー](youtube.md) — Python + YouTube Data API v3 によるランダム再生ツール
- [ピッコマ/LINEマンガ ビューア](pico.md) — Python スクレイパー + 静的HTMLビューア
- [漫画マネージャー](raw.md) — Node.js/Express + PHP による4サイト漫画管理