# 機能一覧

各機能の概要・URL・主な操作をまとめたドキュメントです。

---

## 目次

1. [記事管理](#記事管理)
2. [5ch スレッドインポート](#5ch-スレッドインポート)
3. [note 下書き生成](#note-下書き生成)
4. [Twitter 予約投稿・検索](#twitter-予約投稿検索)
5. [YouTube チャンネル分析](#youtube-チャンネル分析)
6. [YouTube PDCA 管理](#youtube-pdca-管理)
7. [画像コンバーター](#画像コンバーター)
8. [お城マップ](#お城マップ)
9. [物件一覧](#物件一覧)
10. [お買い得物件リサーチ](#お買い得物件リサーチ)
11. [不動産価格トレンド](#不動産価格トレンド)
12. [Amazon × 楽天 価格比較](#amazon--楽天-価格比較)
13. [Google マップ場所検索](#google-マップ場所検索)
14. [Hyperliquid 取引ダッシュボード](#hyperliquid-取引ダッシュボード)
15. [Hyperliquid 自動売買ボット](#hyperliquid-自動売買ボット)
16. [ずんだもん音声生成](#ずんだもん音声生成)
17. [SUUMO 物件 AI 評価](#suumo-物件-ai-評価)
18. [サイト AI チャット](#サイト-ai-チャット)
19. [サイト改善自動化](#サイト改善自動化)
20. [Stable Diffusion 画像生成](#stable-diffusion-画像生成)
21. [CivitAI モデル検索](#civitai-モデル検索)
22. [AI ウェブスクレイパー](#ai-ウェブスクレイパー)
23. [楽天ラッキーくじ自動巡回](#楽天ラッキーくじ自動巡回)
24. [Zaim 家計簿連携](#zaim-家計簿連携)
25. [クレジットカード明細管理](#クレジットカード明細管理)
26. [MUFG 銀行口座連携](#mufg-銀行口座連携)
27. [電気工事士試験対策](#電気工事士試験対策)
28. [スマートホーム管理](#スマートホーム管理)
29. [Alexa ずんだもんボイス](#alexa-ずんだもんボイス)
30. [日本百選マップ](#日本百選マップ)
30. [キャリーオーバー巡回チェッカー](#キャリーオーバー巡回チェッカー)
31. [日米リードラグ戦略](#日米リードラグ戦略)
32. [仮想通貨リードラグ戦略](#仮想通貨リードラグ戦略)
33. [仕様QA](#仕様qa)
34. [住宅ローンシミュレーション](#住宅ローンシミュレーション)
35. [住宅ローン会社おすすめ検索](#住宅ローン会社おすすめ検索)
36. [住宅ローン審査自動入力](#住宅ローン審査自動入力)
37. [パチスロ収支管理](#パチスロ収支管理)
38. [ポケモンカード相場・抽選情報](#ポケモンカード相場抽選情報)
39. [日本株 株主優待チャート分析](#日本株-株主優待チャート分析)
40. [確定申告 売上管理](#確定申告-売上管理)
41. [駅ガイド](#駅ガイド)
42. [WEB マンガ検索 Comicy](#web-マンガ検索-comicy)
43. [Kindle セール情報](#kindle-セール情報)
44. [Amazon × 楽天 キャンペーン情報](#amazon--楽天-キャンペーン情報)
45. [購入履歴管理](#購入履歴管理)
46. [家計簿](#家計簿)
47. [マネーフォワード ME 連携](#マネーフォワード-me-連携)
48. [CSV 分割ツール](#csv-分割ツール)
49. [SUUMO 自動巡回 Discord 通知](#suumo-自動巡回-discord-通知)
50. [Amazon アソシエイト](#amazon-アソシエイト)
51. [ドンチアンバックテスト](#ドンチアンバックテスト)
52. [案件スクレイパー](#案件スクレイパー)
53. [株主優待一覧](#株主優待一覧)
54. [投資シミュレーター](#投資シミュレーター)
55. [Twitter 投稿アカウント管理](#twitter-投稿アカウント管理)
56. [コミック投稿自動化](#コミック投稿自動化)
57. [ソーシャルログイン](#ソーシャルログイン)
58. [システム設定（ヘルスチェック）](#システム設定ヘルスチェック)
59. [サイト認証ゲート](#サイト認証ゲート)
60. [楽天ROOM アフィリエイト自動投稿](#楽天room-アフィリエイト自動投稿)
61. [a8.net アフィリエイト案件管理](#a8net-アフィリエイト案件管理)
62. [Hyperliquid ペアトレード](#hyperliquid-ペアトレード)
63. [Shorts 動画自動生成](#shorts-動画自動生成)
64. [暮らしサービス](#暮らしサービス)
65. [競馬タスクステータス](#競馬タスクステータス)
66. [Hyperliquid コンテナ管理](#hyperliquid-コンテナ管理)
67. [地域セール情報](#地域セール情報)
68. [武蔵新城 地域ポータル](#武蔵新城-地域ポータル)
69. [LIFF 価格比較（LINE内検索）](#liff-価格比較line内検索)
70. [動画自動カット](#動画自動カット)
71. [Bot Watchdog（自動復旧）](#bot-watchdog自動復旧)
72. [競艇AI予想・自動購入](#競艇ai予想自動購入)

---

## 記事管理

**URL:** `/user_posts`

ブログ記事の作成・編集・削除を管理する CMS 機能。Claude AI による文章整形・テンプレート適用・内容補足も可能。

| 操作 | 説明 |
|------|------|
| 一覧 | ステータス（下書き/公開）・カテゴリでフィルタリング、20件ページネーション |
| 作成・編集 | タイトル・本文・カテゴリ・公開ステータス・アイキャッチ画像を設定 |
| AI 整形 | 本文を AI が読みやすく整形 |
| AI テンプレート | 記事構成テンプレートを AI が自動適用 |
| AI 補足 | 内容を AI が肉付け・補足 |
| 公開記事 | `/posts/{slug}` で認証不要で閲覧可能（カテゴリフィルタ付き） |

**必要な設定:** `ANTHROPIC_API_KEY`

---

## 5ch スレッドインポート

**URL:** `/fivech/import`

5ch.net のスレッド URL を入力して記事としてインポートする機能。レス番を選択して取り込む範囲を絞れる。

| 操作 | 説明 |
|------|------|
| プレビュー | URL からスレッドを取得・一覧表示 |
| インポート | 選択したレスを結合して記事として保存 |

---

## note 下書き生成

**URL:** `/note`

note.com 向けの記事下書きを AI で自動生成する機能。トピックを指定して下書きを生成・保存し、note.com のリンクから直接投稿できる。

| 操作 | 説明 |
|------|------|
| 一覧 | 保存済み下書きとトピック候補を表示 |
| 生成 | トピックを指定して AI が記事を生成 |
| 詳細 | 生成内容の確認・note.com へのリンク |

スケジュール自動生成も対応（`NOTE_SCHEDULE_ENABLED=true` で有効）。

**必要な設定:** `ANTHROPIC_API_KEY`

---

## Twitter 予約投稿・検索

**URL:** `/twitter`（予約投稿）、`/twitter/search`（検索）

Twitter への投稿予約と、ツイート検索・保存を行う機能。

| 機能 | 説明 |
|------|------|
| 予約投稿 | 280 文字以内のツイートを日時指定で登録（未来日時のみ） |
| 予約削除 | 未投稿の予約ツイートを削除 |
| ツイート検索 | Twitter API でキーワード検索・最近の検索履歴表示 |
| 保存済みツイート | 検索結果から保存したツイートをフルテキスト検索で絞り込み |

**必要な設定:** `TWITTER_API_KEY` / `TWITTER_API_SECRET` / `TWITTER_ACCESS_TOKEN` / `TWITTER_ACCESS_TOKEN_SECRET`

---

## YouTube チャンネル分析

**URL:** `/youtube/analysis`

YouTube チャンネルを検索し、Claude AI が成長戦略を分析する機能。お気に入り登録・分析履歴の管理ができる。

| 操作 | 説明 |
|------|------|
| チャンネル検索 | キーワードでチャンネルを検索、登録者数・動画数を表示 |
| お気に入り | チャンネルのお気に入り追加・解除 |
| AI 分析 | お気に入りチャンネルを AI が分析（競合比較・伸び代・戦略提案） |
| 分析保存 | AI 分析結果を PDCA 管理へ保存 |

**必要な設定:** `YOUTUBE_API_KEY` / `ANTHROPIC_API_KEY`

---

## YouTube PDCA 管理

**URL:** `/youtube/pdca`

AI 分析をもとにチャンネル改善の PDCA サイクルを管理する機能。AI アドバイザーとのチャットで改善施策を継続的に深掘りできる。

| 操作 | 説明 |
|------|------|
| 一覧 | 保存済み分析をステータス（Plan/Do/Check/Act）で管理 |
| 詳細・チャット | 分析内容を確認し、AI と継続的にチャット |
| ステータス更新 | 実施メモを記録しながら PDCA フェーズを進める |
| アクション再生成 | 分析から具体的なアクションアイテム 3〜5 件を AI が抽出 |
| データエクスポート | 分析・チャット履歴を JSON、お気に入りを CSV でエクスポート |
| CSV インポート | お気に入りチャンネルを CSV で一括インポート |

**必要な設定:** `ANTHROPIC_API_KEY`

---

## 画像コンバーター

**URL:** `/image-converter`

画像のリサイズ・フォーマット変換・品質調整を行うツール。

| 設定 | 説明 |
|------|------|
| サイズ | 幅・高さをピクセルで指定（アスペクト比維持オプションあり） |
| フォーマット | JPEG / PNG / WebP / GIF |
| 品質 | JPEG・WebP の圧縮品質（1〜100%） |

変換結果はそのままダウンロード可能。

---

## お城マップ

**URL:** `/castle`

日本の有名なお城 24 箇所以上を Google マップ上に表示するインタラクティブマップ。各城のマーカーをクリックすると名称・所在地・築城年・概説を確認できる。

**必要な設定:** `GOOGLE_MAPS_API_KEY`

---

## 物件一覧

**URL:** `/real-estate/estate`

不動産物件のブラウジング機能。都道府県・ステータスでフィルタリングして 30 件ずつ表示。フィルタ条件は Cookie で保持。

| 操作 | 説明 |
|------|------|
| 一覧 | 都道府県・ステータス絞り込み、30 件ページネーション |
| 詳細 | 物件の詳細情報を確認 |

---

## お買い得物件リサーチ

**URL:** `/real-estate/bargain-search`

国土交通省の不動産取引情報を取得し、相場比較でお買い得物件を発見する機能。

| 操作 | 説明 |
|------|------|
| 市場分析 | 都道府県・物件種別・年度範囲を指定して坪単価の相場を分析 |
| 物件比較 | 個別物件を市場統計と比較してパーセンタイル算出 |
| SUUMO スクレイピング | SUUMO 検索結果を取得し、相場データでお得スコアをランキング |

**必要な設定:** `MLIT_REINFOLIB_API_KEY`

---

## 不動産価格トレンド

**URL:** `/real-estate/real-estate-price`

国土交通省 API を使い、地域・物件種別ごとの取引価格の時系列トレンドを可視化する機能。

| 操作 | 説明 |
|------|------|
| トレンド分析 | 都道府県・市区町村・物件種別を選択して 5〜15 年分の価格推移を表示 |
| 市区町村取得 | 都道府県選択時に市区町村リストを非同期取得 |

**必要な設定:** `MLIT_REINFOLIB_API_KEY`

---

## Amazon × 楽天 価格比較

**URL:** `/price-compare`

商品名で検索して Amazon と楽天市場の価格を一括比較する機能。両プラットフォームを同時検索し、最安値・平均値・差額を一目で確認できる。

| 機能 | 説明 |
|------|------|
| 同時検索 | キーワード・カテゴリを指定して Amazon と楽天を並列検索 |
| 比較サマリー | 最安値・平均値を並べて価格差（円・%）を表示 |
| 統合グリッド | 全商品を価格昇順で表示（最安値バッジ付き） |
| タブ切替 | 全件 / Amazon のみ / 楽天 のみ で絞り込み |
| 価格バー | 商品カードに相対価格バーを表示 |
| キャッシュ | 同一キーワードの結果を 10 分間キャッシュ |
| アフィリエイトリンク | メルカリ・Yahoo!ショッピング・楽天の商品リンクにもしもアフィリエイト等のパラメータを自動付与 |

**必要な設定（Amazon）:** `AMAZON_CREATORS_CREDENTIAL_ID` / `AMAZON_CREATORS_CREDENTIAL_SECRET` / `AMAZON_PAAPI_PARTNER_TAG`
（Amazon アソシエイトへの登録・審査が必要）

**必要な設定（楽天）:** `RAKUTEN_APP_ID`
（[楽天 Web Service](https://webservice.rakuten.co.jp/) に無料登録で取得可能）

### iOS / Android アプリ版（Expo / React Native）

Web版と同じ価格比較エンジンを叩く iOS / Android ネイティブアプリを `mobile/` 配下に同梱。

| 項目 | 内容 |
|------|------|
| ソース | `mobile/`（Expo SDK 52 / React Native 0.76.9 / TypeScript / React Navigation / zustand） |
| API | `GET /api/mobile/price-compare/search`（既存Web版と同じレスポンス形式） |
| 認証 | `Authorization: Bearer <token>`（ログイン時）+ `X-Guest-Token`（常時） |
| 認証エンドポイント | `POST /api/mobile/auth/login`、`POST /api/mobile/auth/logout`、`GET /api/mobile/auth/me`、`GET /api/mobile/auth/guest-token` |
| MVP画面 | 検索（人気キーワード/最近の履歴）、結果一覧（9サイトタブ切替・価格ソート・外部ブラウザ起動）、アカウント（ログイン／ログアウト） |
| ビルド手順 | `mobile/README.md` 参照（**Mac / Xcode 不要**、`npx expo start` で Expo Go による実機確認可、配布は EAS Build でクラウドビルド） |

ゲスト識別は既存の `price_compare_guest` Cookie と互換で、`ManagesPriceCompareOwner` Trait が `X-Guest-Token` ヘッダーを優先的に読むように修正済み。

---

## Google マップ場所検索

**URL:** `/map-search`

Google Maps API を使ったロケーション検索ツール。

**必要な設定:** `GOOGLE_MAPS_API_KEY`

---

## Hyperliquid 取引ダッシュボード

**URL:** `/finance/hyperliquid`

分散型無期限先物取引所 [Hyperliquid](https://hyperliquid.xyz) のウォレット・注文管理ダッシュボード。

| 機能 | 説明 |
|------|------|
| 価格表示 | BTC / ETH / SOL 等主要 10 銘柄のリアルタイム価格 |
| アカウント情報 | 証拠金残高・使用率・オープンポジション・未決注文 |
| 注文 | 指値・成行注文をウォレット秘密鍵署名で送信 |
| 注文キャンセル | 未決注文を ID 指定でキャンセル |

**必要な設定:** `HYPERLIQUID_WALLET_ADDRESS` / `HYPERLIQUID_PRIVATE_KEY`

> ⚠️ 秘密鍵を扱います。本番環境では十分なアクセス制御を設けてください。

---

## Hyperliquid 自動売買ボット

**URL:** `/finance/hyperliquid/bot`

Hyperliquid 上で動作する自動売買ボットの起動・停止・ログ監視を行う管理画面。

| 機能 | 説明 |
|------|------|
| ボット起動 | 戦略（MA クロス / RSI / AI / ドンチアンブレイクアウト / EMA10）・銘柄・ロットサイズを指定して Python ボットをバックグラウンド起動 |
| ボット停止 | 実行中ボットのプロセスを停止 |
| ステータス確認 | 稼働状態とプロセス情報をポーリング |
| ポジションカード | 現在のポジション（銘柄・方向・サイズ・エントリー・含み損益%・損切ライン・SARトレイル）を専用カードで表示 |
| トレード DB 永続化 | Python Bot のトレード結果を `hyperliquid_bot_trades` テーブルに永続保存（status.json クリア後も保持） |
| ログ表示 | 最新 N 行のログをリアルタイム確認 |
| ログ消去 | ログ・取引履歴をクリア |

**必要な設定:** `HYPERLIQUID_WALLET_ADDRESS` / `HYPERLIQUID_PRIVATE_KEY`

> ⚠️ 自動売買には金銭リスクが伴います。十分なテストの上でご利用ください。

---

## ずんだもん音声生成

**URL:** `/zundamon-voice`

[VOICEVOX](https://voicevox.hiroshiba.jp/) を使ったテキスト読み上げ（TTS）音声生成・動画書き出し機能。

| 機能 | 説明 |
|------|------|
| 音声生成 | テキストを入力してスピーカー（ずんだもん等）を選択し WAV ファイルを生成 |
| 一括生成 | 複数行のセリフを一括合成して ZIP でダウンロード |
| スクリプト生成 | テーマを入力すると AI が読み上げ用スクリプトを自動生成 |
| 動画書き出し | 生成した WAV ファイルと背景画像から MP4 動画を作成 |
| 履歴管理 | 生成済み音声ファイルの一覧表示・削除 |

**必要な設定:** `VOICEVOX_URL`（デフォルト: `http://localhost:50021`）/ `ANTHROPIC_API_KEY`（スクリプト生成用）

---

## SUUMO 物件 AI 評価

**URL:** `/real-estate/suumo-property`

SUUMO の物件 URL からスクレイピングして物件情報を取得し、国土交通省の市場データと照合して AI が価格評価を行う機能。物件ごとの AI チャット相談にも対応。

| 操作 | 説明 |
|------|------|
| 物件登録 | SUUMO URL を入力してスクレイピング・DB 保存（重複チェック付き） |
| 自動巡回 | SUUMO 検索結果 URL から複数ページを自動巡回し、各物件の詳細を一括取得・DB 保存 |
| AI 評価 | 国交省取引データとの市場比較に基づく AI 評価（S〜D ランク） |
| 再取得 | 物件情報を SUUMO から再スクレイピングして更新 |
| AI チャット | 物件に関する質問を AI アドバイザーに相談 |
| 削除 | 物件データの削除 |

**必要な設定:** `ANTHROPIC_API_KEY` / `MLIT_REINFOLIB_API_KEY`

---

## サイト AI チャット

**URL:** `/site-chat/send`（API）

サイト全体のデータベース情報を活用して回答する AI チャットアシスタント。物件・YouTube・Twitter・記事などの登録データを文脈に含めて回答する。サイト改善提案機能も内蔵。

| 機能 | 説明 |
|------|------|
| コンテキスト応答 | ユーザーの質問に関連する DB 情報を自動収集して回答 |
| セッション管理 | セッション ID ベースで会話履歴を保持（直近 20 件） |
| 改善提案 | サイト改善要望に対して `[IMPROVEMENT_PROPOSAL]` マーカーで提案 |
| 履歴取得 | セッションの会話履歴を API で取得 |

**必要な設定:** `ANTHROPIC_API_KEY`

---

## サイト改善自動化

**URL:** `/site-improvement`

AI チャットからの改善提案を受けて、自動的にコード修正タスクを作成・実行する機能。

| 操作 | 説明 |
|------|------|
| タスク作成 | 改善内容の説明からタスクを作成 |
| 非同期実行 | ジョブキューで改善タスクをバックグラウンド実行 |
| 進捗確認 | タスクのステータス（pending/running/complete）を確認 |

**必要な設定:** `ANTHROPIC_API_KEY`

---

## Stable Diffusion 画像生成

**URL:** `/stable-diffusion`

AI による画像生成ツール。テキストからの画像生成（txt2img）と画像からの変換（img2img）に対応。ゼロからのセットアップガイドも内蔵。

| 機能 | 説明 |
|------|------|
| テキスト→画像 | プロンプト・ネガティブプロンプト・モデル・アスペクト比を指定して画像生成 |
| 画像→画像 | 入力画像をベースに変換強度を調整して新しい画像を生成（履歴画像ID指定・アスペクト比変更対応） |
| 生成履歴 | 生成済み画像の一覧表示・メタデータ確認・前後ナビゲーション |
| お気に入り | 画像にお気に入りフラグを設定。お気に入りは常に先頭に表示。お気に入り以外の一括削除 |
| LoRA 選択パネル | ローカルの LoRA ファイル一覧から選択・プロンプトに挿入。CivitAI メタデータ詳細表示・トリガーワード挿入 |
| 構図テンプレート | 顔・身体・手・足のカテゴリ別 Danbooru タグをワンクリックでトグル挿入 |
| プロンプト翻訳 | 入力プロンプトの各単語を日本語訳で表示・個別削除 |
| モデルリフレッシュ | SD WebUI のモデルリストを再読込（CivitAI DL後に使用） |
| セットアップガイド | Python 3.10・Forge・Checkpoint・.env 設定を Step 1〜6 で案内する折りたたみガイド |

**必要な設定:** Stable Diffusion WebUI（AUTOMATIC1111 / Forge）のローカル起動

---

## CivitAI モデル検索

**URL:** `/civitai`

CivitAI の AI アートモデルを検索・閲覧するブラウザ。モデルの詳細情報やサンプル画像、トリガーワードを確認できる。お気に入り登録で頻用モデルへの素早いアクセスも可能。

| 操作 | 説明 |
|------|------|
| モデル検索 | キーワード・モデル種別・ソート条件を指定して検索 |
| 詳細表示 | モデルのサンプル画像・トリガーワード・ダウンロード URL・統計情報 |
| お気に入り | モデルをお気に入り登録し、トグルボタンで一覧表示を切り替え |

---

## AI ウェブスクレイパー

**URL:** `/web-scraper`

URL からウェブページのテキストコンテンツを取得し、AI で分析する汎用スクレイピングツール。

| 機能 | 説明 |
|------|------|
| シングル分析 | 1 つの URL をスクレイピングして AI で分析 |
| 一括分析 | 最大 5 URL を同時取得して横断分析 |
| プリセット | よく使う分析テンプレート（要約・競合分析等）を選択 |
| カスタムプロンプト | 自由な分析指示で AI に解析させる |
| 結果保存 | 分析結果を DB に保存・履歴管理 |

**必要な設定:** `ANTHROPIC_API_KEY`

---

## 楽天ラッキーくじ自動巡回

**URL:** `/rakuten-lottery`

楽天の各種ラッキーくじを Selenium で自動巡回して応募する機能。Python スクリプトをバックグラウンドで起動・管理。

| 機能 | 説明 |
|------|------|
| 巡回開始 | 一回実行 or 定期実行（1〜48 時間間隔）を選択して起動 |
| くじ管理 | くじ URL の有効/無効切替（8 種類のデフォルトくじ） |
| ステータス | プロセスの稼働状態をポーリング確認 |
| ログ・スクリーンショット | 実行ログとスクリーンショットの閲覧 |

**必要な設定:** `RAKUTEN_EMAIL` / `RAKUTEN_PASSWORD`

---

## Zaim 家計簿連携

**URL:** `/zaim`

家計簿サービス Zaim と連携して取引データを取得・管理する機能。OAuth API とウェブスクレイパーの 2 モードに対応。

| 機能 | 説明 |
|------|------|
| OAuth 連携 | Zaim API で認可→取引・カテゴリ・口座データを取得 |
| スクレイパー | パスワード認証でウェブ版からデータ取得（API 制限回避用） |
| 取引保存 | 取得した取引履歴を DB に保存して参照 |

**必要な設定:** `ZAIM_CONSUMER_KEY` / `ZAIM_CONSUMER_SECRET`（OAuth）、`ZAIM_EMAIL` / `ZAIM_PASSWORD`（スクレイパー）

---

## クレジットカード明細管理

**URL:** `/finance/card-statement`

クレジットカードの利用明細を CSV アップロードまたはウェブスクレイピングで取得・管理する機能。複数カードブランドに対応。

| 機能 | 説明 |
|------|------|
| CSV アップロード | 楽天・JCB・セゾン・PayPay カードの CSV を自動判定して取り込み |
| AI パース | フォーマット不明の CSV を AI が解析して取り込み |
| スクレイピング | ウェブ経由で明細を自動取得 |
| 手動入力 | 個別明細の手入力 |
| セッション管理 | セッション単位で明細データを管理 |

**必要な設定:** `ANTHROPIC_API_KEY`（AI パース用）

---

## MUFG 銀行口座連携

**URL:** `/finance/mufg-bank`

三菱 UFJ 銀行の口座情報を OAuth2 認証で取得・表示する機能。

| 操作 | 説明 |
|------|------|
| 認可接続 | OAuth2 フローで銀行口座にアクセス許可 |
| 口座情報 | 口座一覧・残高情報の取得 |
| 取引履歴 | 入出金の取引履歴を表示 |
| 接続解除 | 認可トークンを削除して接続解除 |

**必要な設定:** `MUFG_CLIENT_ID` / `MUFG_CLIENT_SECRET` / `MUFG_REDIRECT_URI`

---

## 電気工事士試験対策

**URL:** `/electrical-exam`

電気工事士試験の過去問を JSON データから出題する学習ツール。

| 機能 | 説明 |
|------|------|
| 問題出題 | カテゴリ別にランダム出題 |
| カテゴリフィルタ | 分野を絞って集中学習 |

---

## スマートホーム管理

**URL:** `/smart-home`

Nature Remo と Amazon Alexa を統合的に管理するスマートホームダッシュボード。

| 機能 | 説明 |
|------|------|
| デバイス管理 | Nature Remo に接続されたデバイス・家電の一覧表示 |
| 家電操作 | エアコン・照明等の遠隔操作 |
| Alexa スキル | カスタムスキルの作成・編集・削除 |
| Alexa ルーティン | トリガーフレーズ・スケジュールによる自動化ルーティンの管理 |

**必要な設定:** `NATURE_REMO_ACCESS_TOKEN` / `ALEXA_CLIENT_ID` / `ALEXA_CLIENT_SECRET`

---

## Alexa ずんだもんボイス

**URL:** `/alexa-zundamon`
**Webhook:** `/api/alexa-zundamon/webhook`

Alexa カスタムスキルでずんだもんの声を使って応答する機能。Claude AI でずんだもん風の応答テキストを生成し、VOICEVOX で音声合成して Alexa に返す。

| 機能 | 説明 |
|------|------|
| Alexa Webhook | カスタムスキルからのリクエストを受けてずんだもんの声で応答 |
| AI 応答生成 | Claude API でずんだもんのキャラクター性を維持した応答を生成 |
| VOICEVOX 音声合成 | テキストをずんだもんの声で WAV → Alexa 対応 MP3 に変換 |
| テスト発話 | 管理画面から動作確認（AI応答 + 音声再生） |
| 会話ログ | Alexa との会話履歴を記録・閲覧 |

**必要な設定:** `ANTHROPIC_API_KEY` / `VOICEVOX_URL`

---

## 日本百選マップ

**URL:** `/real-estate/hyakusen_map`

日本の「百選」スポット（名城・名水・名橋・名瀑・名山・名園・名寺など 39 カテゴリ）を Google マップ上にインタラクティブ表示する機能。

| 機能 | 説明 |
|------|------|
| カテゴリ選択 | 39 種類の百選カテゴリから表示対象を選択 |
| マップ表示 | カテゴリごとに色分けされたマーカーで位置を表示 |
| 詳細確認 | マーカークリックでスポット名・所在地等を確認 |

**必要な設定:** `GOOGLE_MAPS_API_KEY`

---

## キャリーオーバー巡回チェッカー

**URL:** `/carryover`

宝くじ（ロト7・ロト6）、スポーツくじ（MEGA BIG・BIG）、競馬（WIN5）、オートレース（当たるんです）、競輪（Dokanto!）のキャリーオーバー発生状況を自動巡回チェックする機能。

| 操作 | 説明 |
|------|------|
| 1回チェック | 全対象サイトのキャリーオーバー状況を即時チェック |
| 定期チェック | 指定間隔（1〜48時間）で自動巡回を繰り返す |
| 対象ON/OFF | チェック対象ごとに有効/無効を切り替え |
| 結果一覧 | キャリーオーバーの有無・金額・ステータスを一覧表示 |
| サマリー | キャリーオーバー発生件数をリアルタイム表示 |
| ログ閲覧 | 巡回ログの閲覧・クリア |

**必要な設定:** なし（外部APIキー不要）

**対応サービス:**
- ロト7 / ロト6（みずほ銀行）
- MEGA BIG / BIG（toto公式）
- WIN5（JRA）
- 当たるんです（オートレース）
- Dokanto! 4two / 7（競輪）

---

## 環境変数まとめ

| 変数名 | 用途 |
|--------|------|
| `ANTHROPIC_API_KEY` | AI 機能全般（記事整形・YouTube 分析・音声スクリプト生成等） |
| `YOUTUBE_API_KEY` | YouTube チャンネル検索・情報取得 |
| `TWITTER_API_KEY` / `TWITTER_API_SECRET` / `TWITTER_ACCESS_TOKEN` / `TWITTER_ACCESS_TOKEN_SECRET` | Twitter 予約投稿・ツイート検索 |
| `GOOGLE_MAPS_API_KEY` | お城マップ・Google マップ場所検索 |
| `MLIT_REINFOLIB_API_KEY` | 国土交通省 不動産取引情報 API |
| `AMAZON_CREATORS_CREDENTIAL_ID` / `AMAZON_CREATORS_CREDENTIAL_SECRET` / `AMAZON_PAAPI_PARTNER_TAG` | Amazon 商品検索（アソシエイト登録必須） |
| `RAKUTEN_APP_ID` | 楽天市場 商品検索（楽天 Web Service 無料登録） |
| `HYPERLIQUID_WALLET_ADDRESS` / `HYPERLIQUID_PRIVATE_KEY` | Hyperliquid 取引・自動売買ボット |
| `VOICEVOX_URL` | VOICEVOX TTS エンジン（ローカル起動） |
| `NOTE_SCHEDULE_ENABLED` / `NOTE_DEFAULT_TOPIC` | note 自動生成スケジュール |
| `RAKUTEN_EMAIL` / `RAKUTEN_PASSWORD` | 楽天ラッキーくじ自動巡回 |
| `ZAIM_CONSUMER_KEY` / `ZAIM_CONSUMER_SECRET` | Zaim 家計簿 OAuth 連携 |
| `ZAIM_EMAIL` / `ZAIM_PASSWORD` | Zaim スクレイパーモード |
| `MUFG_CLIENT_ID` / `MUFG_CLIENT_SECRET` / `MUFG_REDIRECT_URI` | MUFG 銀行口座連携 |
| `NATURE_REMO_ACCESS_TOKEN` | Nature Remo スマートホーム操作 |
| `ALEXA_CLIENT_ID` / `ALEXA_CLIENT_SECRET` | Alexa スキル・ルーティン管理 |
| `CHATWORK_API_TOKEN` | Chatwork API トークン（仕様QA 返信用） |
| `CHATWORK_WEBHOOK_TOKEN` | Chatwork Webhook 署名検証トークン |
| `GITHUB_WEBHOOK_SECRET` | GitHub Webhook シークレット（署名検証用） |
| `DISCORD_WEBHOOK_URL` | SUUMO 自動巡回 Discord 通知 |
| `AMAZON_ASSOCIATES_EMAIL` / `AMAZON_ASSOCIATES_PASSWORD` | Amazon アソシエイト自動レポート取得 |
| `INTERNAL_API_TOKEN` | 内部 API 認証（scraper → Laravel の import-json 等） |
| `LARAVEL_BASE_URL` | スクレイパーコンテナが叩く Laravel の URL（compose 内ではデフォルト `http://app`） |
| `SCRAPER_VNC_PORT` / `SCRAPER_VNC_PASSWORD` / `SCRAPER_TZ` / `PUID` / `PGID` | 汎用スクレイパーコンテナ設定 |

---

## 汎用スクレイパーコンテナ

**Docker サービス:** `scraper`（`docker-compose.yml` / `docker/scraper/`）

`python/` 配下の Selenium/Chromium ベースのスクレイピングスクリプトを共通インフラで実行する GUI 対応コンテナ。`docker/scraper/README.md` に詳細。

| 項目 | 内容 |
|------|------|
| ベースイメージ | `python:3.11-slim-bookworm` |
| 同梱 | Chromium / chromium-driver / Xvfb / x11vnc / noVNC / fluxbox / supervisor |
| ブラウザ確認 | `http://<HOST>:${SCRAPER_VNC_PORT:-6080}/vnc.html`（noVNC） |
| スクリプト実行 | `docker exec match_12_scraper /app/docker/scraper/run.sh <dir> <script.py>` |
| ログ | `python/_scraper/logs/*.log` |
| 用途 | Amazon アソシエイト取得、Google 検索テスト、今後追加される Selenium 系スクリプト |

Amazon アソシエイトの自動取得など、スクレイプ結果は CSV を介さず `/api/shopping/amazon-associates/import-json`（`INTERNAL_API_TOKEN` 認証）に直接 POST する方式で Laravel DB へ反映される。

---

## ずんだもん会話デーモン（ラズパイ常駐）

**実体:** `python/zundamon-chat/`（systemd で常駐）

Web 版 `/ai/zundamon-chat` を Python CLI 化し、Raspberry Pi 上で常時マイク入力を監視する常駐プロセス。呼びかけワード（「ずんだもん」等）の検出後、スマートホーム操作 → Claude 応答の順に処理し、VOICEVOX でスピーカーから応答する。

| 項目 | 内容 |
|------|------|
| エントリ | `python/zundamon-chat/zundamon_chat.py`（`--text-mode` / `--once "発話"` あり） |
| 音声認識 | Google Speech Recognition（既定）または Vosk（オフライン） |
| 音声合成 | VOICEVOX Engine（ARM64 版 Docker でラズパイ上で起動） |
| スマートホーム | Nature Remo（テレビ／エアコン／照明） |
| AI 応答 | Anthropic Claude（`claude-3-haiku-20240307`） |
| 常駐化 | systemd `zundamon-chat.service`（詳細は `python/zundamon-chat/README.md`） |

Web 版との機能差分は `python/zundamon-chat/README.md` 参照（競馬収支報告は未対応）。

---

## 日米リードラグ戦略

**URL:** `/finance/lead-lag`

論文「部分空間正則化付き主成分分析を用いた日米業種リードラグ投資戦略」（人工知能学会 FIN-036, 2026）に基づく、日米セクターETFのリードラグ効果を利用したロング・ショート戦略。

| 機能 | 説明 |
|------|------|
| シグナル生成 | 米国セクターETF (11本) の当日リターンから、日本セクターETF (TOPIX-17, 17本) の翌営業日リターンを予測 |
| ポートフォリオ構成 | 予測上位をロング・下位をショートとするドルニュートラル戦略 |
| バックテスト | ローリングウィンドウ方式で過去データに対するパフォーマンスを検証 |
| パラメータ調整 | ルックバック期間・PCA主成分数・正則化パラメータ・ポジション数をUI上で変更可能 |
| 累積リターンチャート | バックテスト結果の時系列推移をChart.jsで可視化 |

**手法:** 部分空間正則化付きPCA（Ledoit-Wolf型シュリンケージ）により日米の結合共分散行列を正則化し、低ランク線形予測器を構成。

**必要なPythonパッケージ:** `numpy`, `yfinance`

**詳細ドキュメント:** [docs/lead-lag-strategy.md](docs/lead-lag-strategy.md)

---

## 仮想通貨リードラグ戦略

**URL:** `/finance/crypto-lead-lag`

日米リードラグ戦略のPCA手法を仮想通貨市場に応用した2パターンの投資戦略。バックテストで比較検証が可能。

| 機能 | 説明 |
|------|------|
| Pattern A | BTC/ETH の価格変動から12アルトコイン（SOL, BNB, XRP等）の翌日リターンを予測 |
| Pattern B | 5セクター（L1/DeFi/L2/Meme/Infra）間の情報伝播を利用したセクターローテーション |
| バックテスト | 両パターンの比較テーブル・累積リターン比較チャートを提供 |
| Hyperliquid連携 | シグナルにHyperliquidシンボルを含み、既存の取引機能と連携可能 |

**必要なPythonパッケージ:** `numpy`, `yfinance`

**詳細ドキュメント:** [docs/crypto-lead-lag-strategy.md](docs/crypto-lead-lag-strategy.md)

---

## 仕様QA

**URL:** `/qa`

Chatwork・GitHub Issue からの質問を受け付け、プロジェクト仕様書（FEATURES.md・docs/ 内のドキュメント）をもとに Claude AI が自動回答する機能。管理画面での手動質問にも対応。

| 機能 | 説明 |
|------|------|
| 手動質問 | 管理画面から仕様に関する質問を入力して AI 回答を取得 |
| Chatwork Webhook | `[QA]` または `質問:` で始まるメッセージを受信し、自動回答を同ルームに返信 |
| GitHub Webhook | `qa` / `question` ラベルが付いた Issue を受信し、自動回答をコメントとして投稿 |
| 履歴管理 | 全質問・回答の履歴を一覧表示・削除 |

**Webhook URL:**
- Chatwork: `/api/qa/chatwork-webhook`
- GitHub: `/api/qa/github-webhook`

**必要な設定:** `ANTHROPIC_API_KEY` / `CHATWORK_API_TOKEN`（Chatwork 返信用）/ `GITHUB_TOKEN`（GitHub コメント用）

**オプション設定:** `CHATWORK_WEBHOOK_TOKEN`（署名検証）/ `GITHUB_WEBHOOK_SECRET`（署名検証）

---

## 住宅ローンシミュレーション

**URL:** `/real-estate/housing-loan`

住宅ローンの返済シミュレーションと AI 診断を行う機能。SUUMO 物件から直接シミュレーションを開始でき、購入 vs 賃貸の比較や損益分岐点の算出が可能。

| 操作 | 説明 |
|------|------|
| シミュレーション作成 | 物件価格・頭金・金利・返済期間等を入力して月々の返済額を算出 |
| AI 診断 | Claude AI が投資回収率・購入 vs 賃貸コストを分析してアドバイス |
| 返済方式比較 | 元利均等・元金均等の返済方式を比較 |
| 住宅ローン減税 | 単独・ペアローンの税控除額を自動計算 |
| AI チャット | 診断結果に対する追加質問を AI アドバイザーに相談 |
| SUUMO 連携 | SUUMO 物件データから自動入力してシミュレーション開始 |
| 公開共有 | トークン付き URL で診断結果を共有可能（ログイン不要で閲覧） |

**必要な設定:** `ANTHROPIC_API_KEY`

---

## 住宅ローン会社おすすめ検索

**URL:** `/real-estate/housing-loan-recommend`

住宅ローンの借入先をスコアリングで比較・選定する機能。都市銀行・ネット銀行・モーゲージバンク等のカテゴリから最適な会社を提案。

| 操作 | 説明 |
|------|------|
| 会社検索 | カテゴリ・金利タイプ（変動/固定10年/全期間固定）・借入額・期間で絞り込み |
| スコアリング | 金利・手数料・団信保障・がん保障・全疾病保障を総合評価 |
| 優先度設定 | 低金利・低手数料・保障重視・オンライン完結で優先順位を指定 |
| 会社管理 | 金融機関情報の登録・編集・削除 |

---

## 住宅ローン審査自動入力

**URL:** `/real-estate/auto-fill`

住宅ローン審査フォームに個人情報を Playwright で自動入力する機能。10 社の金融機関に対応。

| 操作 | 説明 |
|------|------|
| プロフィール保存 | 氏名・連絡先・住所・勤務先情報等を保存 |
| 自動入力実行 | 対象銀行を選択してバックグラウンドで自動入力を起動 |
| ステータス確認 | 実行状態をリアルタイムで確認 |
| スクリーンショット | 自動入力プロセスのスクリーンショットを閲覧 |
| ログ閲覧 | 実行ログの確認・クリア |

**対応銀行:** SBI 新生銀行・au じぶん銀行・PayPay 銀行 等 10 社

---

## パチスロ収支管理

**URL:** `/pachislot-earnings`（収支管理）、`/pachislot-schedule`（演者来店スケジュール）

パチスロの収支記録・分析と、演者の来店スケジュール検索を統合管理する機能。

| 機能 | 説明 |
|------|------|
| 収支記録 | 日付・店舗・機種・投資額・回収額を記録 |
| OCR 入力 | スクリーンショットから AI が自動で収支データを抽出 |
| 月次・年次集計 | 月別・年別の勝率・累計収支をチャートで可視化 |
| カレンダー表示 | 日別の収支をカレンダー形式で確認 |
| CSV インポート/エクスポート | CSV での一括取り込み・書き出し（Excel 対応 BOM 付き） |
| メモ機能 | 戦略メモ・ノートの作成・管理 |
| 演者スケジュール | 演者名で来店情報を検索・保存 |

**必要な設定:** `ANTHROPIC_API_KEY`（OCR 用）

---

## ポケモンカード相場・抽選情報

**URL:** `/pokemon-card`

ポケモンカードの相場検索と抽選販売情報を表示する機能。

| 操作 | 説明 |
|------|------|
| カード検索 | キーワードでカード相場を検索 |
| 抽選情報 | 最新の抽選販売情報を取得・表示 |
| 情報更新 | 抽選情報をリフレッシュ |

---

## 日本株 株主優待チャート分析

**URL:** `/finance/company-stock/stock-yutai`

日本株の株主優待情報をチャートで分析する機能。銘柄コードまたは会社名・優待内容でオートコンプリート検索し、株価推移と配当利回りを可視化。

| 操作 | 説明 |
|------|------|
| 銘柄検索 | 4 桁の銘柄コード or 会社名・優待内容でオートコンプリート検索 |
| チャート分析 | 株価推移と配当利回り情報を表示 |
| 期間指定 | 分析期間・権利確定月でフィルタリング |

**必要な Python パッケージ:** `yfinance`

---

## 確定申告 売上管理

**URL:** `/finance/sales-tracking`

フリーランス・個人事業主向けの売上・経費を管理し、確定申告用の税額を自動計算する機能。

| 操作 | 説明 |
|------|------|
| 取引記録 | 日付・取引先・カテゴリ・金額・税区分を登録 |
| 月次・年次集計 | 月別・年別の売上・経費を集計 |
| 税額シミュレーション | 青色申告特別控除（65 万円）・基礎控除（48 万円）を含む所得税・住民税・事業税を自動計算 |
| CSV エクスポート | 取引履歴を CSV で書き出し |
| チャート | 売上・経費の推移をグラフで可視化 |

---

## 駅ガイド

**URL:** `/real-estate/station-guide`

東京近郊の鉄道路線（田園都市線・東横線・小田急線・南武線）の駅情報と住みやすさランキングを提供する機能。ログイン不要で閲覧可能。

| 操作 | 説明 |
|------|------|
| 路線別一覧 | 路線を選択して駅一覧を表示 |
| 駅詳細 | 土地価格推移シミュレーション・隣駅ナビゲーション |
| ランキング | 住みやすさ・利便性・コスパ・治安・自然の 6 カテゴリで総合ランキング |

---

## WEB マンガ検索 Comicy

**URL:** `/comic`

複数の WEB マンガサイトを横断検索し、お気に入り管理やランキングを提供する機能。ログイン不要で閲覧可能。

| 機能 | 説明 |
|------|------|
| マンガ検索 | キーワード・ジャンルで WEB マンガを検索 |
| ランキング | 7 日間の閲覧数に基づくランキング表示 |
| 今日の更新 | 当日更新された作品を一覧表示 |
| 更新スケジュール | 各作品の更新曜日を表示 |
| セール情報 | Kindle セール対象作品を表示 |
| お気に入り | 作品のブックマーク登録・管理（Cookie保存、ログイン時はDB保存） |
| 閲覧履歴 | 閲覧した作品の履歴表示（Cookie保存、ログイン時はDB保存） |
| コメント | 作品へのコメント投稿（スパム防止: 10 分間隔制限） |
| エピソード | 各サイトのエピソード情報を表示 |

---

## Kindle セール情報

**URL:** `/kindle-sale`

Amazon Kindle のセール対象書籍を一覧表示する機能。ポイント還元で実質無料の書籍をフィルタリングして表示。

| 操作 | 説明 |
|------|------|
| セール一覧 | セール中の Kindle 書籍を表示 |
| 無料フィルタ | 価格 ≦ ポイント還元の実質無料書籍を絞り込み |
| キーワード検索 | タイトル・著者名で検索 |
| ソート | 割引率・更新日時等でソート |

---

## Amazon × 楽天 キャンペーン情報

**URL:** `/campaign`

Amazon と楽天市場で現在開催中のキャンペーン・セール情報をスクレイピングして一覧表示する機能。

| 操作 | 説明 |
|------|------|
| キャンペーン一覧 | 現在開催中のキャンペーンを表示 |
| 情報更新 | 最新のキャンペーン情報を再取得 |

---

## 購入履歴管理

**URL:** `/purchase-history`

Amazon・楽天の購入履歴を CSV インポートして管理する機能。お気に入り登録で価格比較と連携。

| 操作 | 説明 |
|------|------|
| CSV インポート | Amazon・楽天の注文履歴 CSV を取り込み（日英カラム名対応・Shift-JIS 自動変換） |
| 一覧表示 | プラットフォーム別に購入履歴を表示 |
| お気に入り | 再購入候補をお気に入り登録 |
| 削除 | 個別購入履歴の削除 |

---

## 家計簿

**URL:** `/finance/kakeibo`

取引データを統合管理し、AI による自動カテゴリ分類やカテゴリ別集計を行う家計簿機能。

| 機能 | 説明 |
|------|------|
| MoneyForward CSV インポート | MoneyForward のエクスポート CSV を取り込み |
| スクレイピング | MoneyForward からデータを自動取得 |
| AI カテゴリ分類 | Claude AI が取引内容から自動でカテゴリを判定 |
| カテゴリルール | 手動でカテゴリ分類ルールを作成・管理 |
| 一括更新 | カテゴリ・モードの一括変更 |
| カテゴリ別集計 | 月別のカテゴリ別支出をピボットテーブルで年間比較 |
| 取引検索 | キーワード・カテゴリ・日付・金額で絞り込み |
| メモ編集 | 取引ごとのメモを更新 |

**必要な設定:** `ANTHROPIC_API_KEY`（AI カテゴリ分類用）

---

## マネーフォワード ME 連携

**URL:** `/finance/moneyforward`

マネーフォワード ME から資産・取引データを Playwright でスクレイピングして取得する機能。

| 操作 | 説明 |
|------|------|
| 資産情報取得 | 口座残高・資産総額をスクレイピングで取得 |
| 取引履歴取得 | 月別・年別の取引データを取得・保存 |

---

## CSV 分割ツール

**URL:** `/csv-splitter`

大容量の CSV ファイルを指定行数で分割し、ZIP にまとめてダウンロードするツール。

| 操作 | 説明 |
|------|------|
| ファイルアップロード | CSV ファイルをアップロード |
| 分割設定 | 分割行数を指定（ヘッダー行は各ファイルに自動付与） |
| ZIP ダウンロード | 分割結果を ZIP アーカイブでダウンロード |

Shift-JIS / BOM 付き UTF-8 の自動変換に対応。

---

## SUUMO 自動巡回 Discord 通知

**URL:** `/real-estate/suumo-auto-crawl`

SUUMO の検索条件を登録し、定期的に自動巡回して新着物件を Discord に通知する機能。

| 操作 | 説明 |
|------|------|
| 条件登録 | SUUMO 検索 URL と巡回間隔（毎時/毎日/毎週）を設定 |
| 有効/無効切替 | 巡回条件ごとに ON/OFF を切り替え |
| 即時実行 | 登録済み条件を手動で即時実行 |
| 進捗確認 | タスクの進捗率をリアルタイム表示 |
| Discord 通知 | 新着物件を Webhook 経由で Discord に通知 |
| 条件削除 | 不要な巡回条件を削除 |

**必要な設定:** `DISCORD_WEBHOOK_URL`

---

## Amazon アソシエイト

**URL:** `/amazon-associates`

Amazon アソシエイトの収益レポートを管理・分析する機能。CSV/TSV インポートと Selenium による自動取得に対応。

| 機能 | 説明 |
|------|------|
| レポートインポート | サマリー・詳細・バウンティレポートの CSV/TSV/ZIP を取り込み |
| 自動取得 | Selenium で Amazon アソシエイト管理画面からレポートを自動ダウンロード |
| DB 直送 API | スクレイパーが `POST /api/shopping/amazon-associates/import-json`（内部トークン認証）に JSON で直接投入、CSV ファイルを介さず UPSERT |
| OTP 対応 | 2 段階認証のワンタイムパスワード入力に対応 |
| 収益分析 | トラッキング ID・日付・カテゴリ別にクリック数・注文数・収益を集計 |
| 期間フィルタ | 30 日/90 日/月別/全期間で集計期間を切替 |
| データクリア | インポート済みデータの全削除 |

**必要な設定:** `AMAZON_ASSOCIATES_EMAIL` / `AMAZON_ASSOCIATES_PASSWORD`（自動取得用）
`INTERNAL_API_TOKEN`（スクレイパーコンテナから Laravel への直送用）

---

## ドンチアンバックテスト

**URL:** `/finance/hyperliquid/bot/donchian-backtest`

Hyperliquid 上の暗号通貨でドンチアンチャネル戦略のバックテストを実行する機能。

| 操作 | 説明 |
|------|------|
| バックテスト実行 | 銘柄・時間足・ドンチアン期間・ATR ストップロスを指定して実行 |
| パラメータ調整 | リスク率・トレンドフィルタ・トレーリングストップ・ピラミッディングを設定 |
| 方向指定 | ロング/ショート/両方の取引方向を選択 |
| 全銘柄分析 | 対応全銘柄を一括でバックテストして比較 |
| ログ閲覧 | 実行ログの確認・クリア |

**必要な設定:** `HYPERLIQUID_WALLET_ADDRESS` / `HYPERLIQUID_PRIVATE_KEY`

---

## 案件スクレイパー

**URL:** `/job-scraper`

Lancers・CrowdWorks・ジモティーから案件情報をスクレイピングし、AI 分析・お気に入り管理・提案文生成を行う機能。

| 機能 | 説明 |
|------|------|
| キーワード検索 | 複数プラットフォームから案件を一括検索 |
| AI 一括分析 | 取得した案件を Claude AI でスコアリング |
| AI 詳細分析 | 個別案件の詳細を AI で深掘り分析 |
| 提案文生成 | 案件に対する AI 提案文を自動生成（ユーザースキル考慮） |
| お気に入り | 気になる案件をお気に入り登録 |
| 除外キーワード | 不要な案件をキーワードで非表示 |
| 予算フィルタ | 予算上限・下限で案件を絞り込み |
| 閲覧履歴 | 閲覧した案件を履歴タブで確認 |

**必要な設定:** `ANTHROPIC_API_KEY`

---

## 株主優待一覧

**URL:** `/finance/company-stock/yutai-list`

日本株の株主優待情報を月別・キーワード検索で一覧表示する機能。優待内容の概要・必要投資額・利回りを表示。

| 操作 | 説明 |
|------|------|
| 月別フィルタ | 権利確定月で絞り込み |
| キーワード検索 | 銘柄名・優待内容で検索 |
| ソート | 銘柄コード・優待利回り・配当利回り・最低投資額で並べ替え |
| ページネーション | 50 件ずつ表示 |

---

## 投資シミュレーター

**URL:** `/finance/investment`

日本株の値動きを **stooq.com（無料・約 15 分遅延）** から取得し、仮想 100 万円で売買をシミュレーションする機能。Claude Code の投資判断能力を実取引前に検証するための実験プラットフォーム。

| 操作 | 説明 |
|------|------|
| ダッシュボード | 総覧・保有銘柄・資産推移グラフ・近時売買 |
| 売買発注 | `/finance/investment/trade` で銘柄検索 → 株価取得 → 約定。判断理由メモを保存 |
| 売買履歴 | `/finance/investment/history` でメモをインライン編集 |
| 設定 | 口座名・運用方針メモ・初期資金リセット |
| 株価 API | `api/search`・`api/quote/{ticker}`・`api/history/{ticker}` でスロットリング付き公開 |
| チャートデータ | `chart-data` で資産推移グラフ用 JSON を配信 |
| 自動実行 | `php artisan investment:daily`（平日 18:00 JST）で日足取得 + 時価スナップショット |

手数料モデルは SBI 証券スタンダード相当（約定代金 × 0.055%、最低 55 円、上限 1,070 円）。買付時の平均取得単価は手数料込みで按分。詳細は `docs/Finance/investment-simulator.md` 参照。

**必要な設定:** stooq.com は無料・登録不要のため追加環境変数なし

---

## Twitter 投稿アカウント管理

**URL:** `/admin/twitter-posting-accounts`

Twitter 予約投稿で使用するアカウントを DB で管理する機能。OAuth 1.0a 連携または手動入力で複数アカウントを登録し、認証情報は暗号化保存される。

| 操作 | 説明 |
|------|------|
| 一覧 | 登録済みアカウントの表示、有効/無効切替 |
| 新規登録 | アカウント情報と API 認証情報を手動入力 |
| OAuth 連携 | `.env` のコンシューマーキーで認可フローを開始し、access_token だけを暗号化保存 |
| 編集 | シークレット系は空欄なら既存値を維持 |
| 削除 | アカウントの論理削除 |

`TwitterApiService::useAccount()` はアカウント値を優先し、未設定項目は `.env` にフォールバックする。予約投稿・コミック投稿自動化・ツイート検索すべてが同一機構を利用する。

**必要な設定:** `TWITTER_CONSUMER_KEY` / `TWITTER_CONSUMER_SECRET`（OAuth 連携時）、Developer Portal の Callback URL に `/admin/twitter-posting-accounts/oauth/callback` を登録

---

## コミック投稿自動化

**URL:** `/admin/comic-tweet-management`

本日更新された人気コミックを自動抽出し、Twitter 予約投稿として登録する機能。

| 操作 | 説明 |
|------|------|
| 設定 | 投稿アカウント・上限件数・集計日数・ランキング上位件数・投稿時刻・除外キーワード・ハッシュタグ・テンプレートを設定 |
| 即時実行 | `comic:tweet-updates` をブラウザから実行、直近の `last_executed_at` と登録件数を表示 |
| 予約クリア | 未投稿のコミック予約を一括削除 |
| 失敗クリア | 失敗ログを削除 |
| テンプレート | `{title}` / `{summary}` / `{url}` / `{hashtags}` プレースホルダー対応 |

内部ロジック: PV ランキング上位 N 件から本日更新エピソードを絞り込み、`post_hours`（例 `8,12,17,19`）の「まだ来ていない時刻」にスロット割り当てして `TwitterScheduledPost` を生成。実際の送信は既存 Twitter 予約投稿スケジューラが担う。

**必要な設定:** Twitter 投稿アカウントの登録（前節）

---

## ソーシャルログイン

**URL:** `/login`（ソーシャルログインボタン表示）

LINE・Twitter/X・Google の OAuth 2.0 によるソーシャルログイン機能。既存アカウントへの紐付け・新規ユーザー自動作成に対応。

| 操作 | 説明 |
|------|------|
| プロバイダ選択 | ログイン画面でプロバイダのボタンをクリック |
| OAuth 認可 | プロバイダの認可画面でログイン許可 |
| アカウント紐付け | 既存メールアドレスと一致すれば自動紐付け、なければ新規作成 |

**必要な設定:** 各プロバイダの `CLIENT_ID` / `CLIENT_SECRET`（`LINE_LOGIN_*`, `TWITTER_LOGIN_*`, `GOOGLE_LOGIN_*`）

詳細: `docs/Core/social-login.md`

---

## システム設定（ヘルスチェック）

**URL:** `/admin/system-setting`

システムの環境変数・Python パッケージ・外部サーバー・ストレージの状態を一覧表示する管理画面。各機能の稼働に必要な設定が不足していないかを一目で確認できる。

| 操作 | 説明 |
|------|------|
| 環境変数確認 | カテゴリ別に環境変数の設定状況を表示（秘密情報は「設定済み ✓」のみ） |
| Python 環境確認 | Python バージョンと必要パッケージの import 可否を表示 |
| 機能ステータス | 各機能に必要な環境変数・パッケージの充足状況を自動判定 |
| 外部サーバー確認 | メルカリスクレイパー等の外部サーバーのヘルスチェック |
| ストレージ確認 | 必要なディレクトリの存在・書き込み権限を確認 |

詳細: `docs/Core/system-setting.md`

---

## サイト認証ゲート

本番環境で未ログインユーザーに対し、メニュー非表示カテゴリのページを 404 で返すミドルウェア。ページの存在自体を隠すことでセキュリティを強化。

| 機能 | 説明 |
|------|------|
| 公開ルート | 認証系・価格比較・マンガ・公開記事・駅ガイドは常時公開 |
| カテゴリ制御 | `setting_sites.menu_category_ids` に含まれるカテゴリのページのみゲスト公開 |
| 404 応答 | 本番環境でメニュー非表示ページは 404 を返し、存在を隠蔽 |
| 全ページ認証 | `require_auth_all_pages` フラグで全ページログイン必須モードにも対応 |

詳細: `docs/Core/site-auth-gate.md`

---

## 楽天ROOM アフィリエイト自動投稿

**URL:** `/shopping/rakuten-room`

楽天市場APIで商品を検索し、レビュー評価・件数でフィルタ後、Seleniumで楽天ROOMに自動投稿する。

| 操作 | 説明 |
|------|------|
| キーワード設定 | 検索キーワード・価格帯を複数登録 |
| プレビュー | 設定したキーワードで商品検索結果を確認 |
| 投稿開始 | 条件に合う商品を楽天ROOMに自動投稿 |
| ログ確認 | 実行ログ・スクリーンショットを表示 |

**必要な設定:** `RAKUTEN_APP_ID`, `RAKUTEN_AFFILIATE_ID`, `RAKUTEN_EMAIL`, `RAKUTEN_PASSWORD`

詳細: `docs/Shopping/rakuten-room.md`

---

## a8.net アフィリエイト案件管理

a8.net のアフィリエイト案件をDBに取り込み、Twitter/X で自動宣伝する。

| 操作 | 説明 |
|------|------|
| CSVインポート | a8.net管理画面のCSVを取り込み（推奨） |
| SNS自動宣伝 | 案件を自動的にTwitter予約投稿に登録 |
| 投稿間隔制御 | 同一案件の再投稿間隔を設定 |

Artisan コマンド: `a8net:fetch-programs`, `a8net:queue-promotions`

**必要な設定:** `A8NET_PROMOTION_ENABLED=true`（宣伝有効化）

詳細: `docs/Shopping/a8net-affiliate.md`

---

## Hyperliquid ペアトレード

相関の高い2銘柄間のスプレッドを利用した統計的裁定取引ボットおよびバックテスト。

| 操作 | 説明 |
|------|------|
| バックテスト実行 | `python hl_pair_backtest.py` でペア戦略をテスト |
| ライブボット起動 | `python hl_pair_bot.py` でリアルタイム裁定 |
| Z-score監視 | スプレッドのZ-scoreでエントリー/エグジット判断 |

**必要な設定:** `HYPERLIQUID_WALLET_ADDRESS`, `HYPERLIQUID_PRIVATE_KEY`

詳細: `docs/Finance/hyperliquid.md`

---

## Shorts 動画自動生成

**URL:** `/shorts-generator`

テキストまたはURLを入力し、Claude AIで台本生成 → Stable Diffusionで画像生成 → VOICEVOXでナレーション → Remotion.jsで動画合成まで、YouTube Shorts向けずんだもん解説動画を全自動で生成する。

| 操作 | 説明 |
|------|------|
| テーマ入力 | テキストまたはURLで動画テーマを指定（最大10,000文字） |
| 事前チェック | Claude API・Stable Diffusion WebUI・VOICEVOX・Remotion の稼働を自動確認 |
| ジョブ投入 | 尺（30〜60秒）を指定してキューに投入 |
| 進捗確認 | AJAX ポーリングで台本→画像→音声→レンダリングの進捗をリアルタイム表示 |
| 動画再生 | 完成した MP4 をブラウザ内で再生・ダウンロード |
| リトライ | 失敗ジョブの再実行（アトミックな状態遷移で二重実行を防止） |
| 削除 | ジョブと出力ファイルの一括削除 |

**必要な設定:** `ANTHROPIC_API_KEY`, `SD_WEBUI_URL`（Stable Diffusion WebUI）, `VOICEVOX_URL`, `REMOTION_URL`

詳細: `docs/Tool/shorts-generator.md`

---

## 暮らしサービス

**URL:** `/kurashi`

暮らし関連サービス（引越し、ハウスクリーニング、修理など）のカテゴリ別検索・比較・予約機能。サービス提供者の登録にも対応。

| 操作 | 説明 |
|------|------|
| カテゴリ一覧 | 全カテゴリと人気サービスをトップに表示 |
| カテゴリ検索 | エリア・ソート（評価/価格/レビュー数）でフィルタ |
| サービス詳細 | 料金・特徴・説明・同カテゴリ関連サービスを表示 |
| 予約リクエスト | 名前・メール・日付を入力して予約（現状モック） |
| サービス登録 | 出品者向け登録フォーム（カテゴリ・店名・エリア・料金・説明） |

詳細: `docs/Shopping/kurashi-services.md`

---

## 競馬タスクステータス

**URL:** `/horse-racing/task-status`

競馬システムの長時間タスク（passage再インポート、予想パイプライン）の進捗をリアルタイム監視するダッシュボード。

| 操作 | 説明 |
|------|------|
| 進捗確認 | Cache ベースでバックグラウンドジョブの進捗をポーリング表示 |
| 年別カバー率 | 各年のpassageデータ取得率を表示 |
| パイプライン実行 | 週次予想パイプライン（レース同期→ML予測→自動購入）をボタンで投入 |
| 購入モニター | 購入対象レース表で購入済み・購入待ちベットのオッズ・人気順位を表示 |
| サイドバー収支 | 今週・先週・今月・先月・全体の損益を一覧表示 |
| 投票照会（サーバー経由） | IPATサーバーの `/check-votes` API で投票照会し、DB上のbet状態と照合 |

詳細: `docs/Entertainment/horse-racing-system-spec.md`

---

## Hyperliquid コンテナ管理

**URL:** `/hyperliquid/bot/containers`

複数の Hyperliquid ボットをDockerコンテナで並行稼働させるためのヘルスチェック・セットアップガイド画面。個別 Bot の詳細ビュー・停止・削除操作にも対応。

| 操作 | 説明 |
|------|------|
| コンテナ状態確認 | 各ボットコンテナのヘルス情報をJSON取得・表示 |
| Bot 詳細ビュー | コンテナ Bot のステータス・ポジション・損切ライン・設定・ログを閲覧専用で表示 |
| Bot 停止 | 稼働中のコンテナ Bot を停止（PID kill / Docker stop） |
| Bot 削除 | 停止済み Bot のランタイムファイルを削除 |
| セットアップガイド | Docker Compose 設定・環境変数の設定手順を表示 |
| AJAX ヘルスチェック | ポーリングで最新のコンテナ稼働状況を更新 |

**必要な設定:** `HYPERLIQUID_PRIVATE_KEY`, `HYPERLIQUID_WALLET_ADDRESS`（Agent運用時）, Docker環境

詳細: `docs/Finance/hyperliquid.md`

---

## 地域セール情報

**URL:** `/regional-sale`

郵便番号を指定して近隣店舗のチラシ情報をクラシルチラシからスクレイピングし、お気に入り店舗管理・セール品抽出・特売日カレンダーを提供する機能。

| 操作 | 説明 |
|------|------|
| 店舗一覧 | 郵便番号を指定して近隣店舗をカード形式で表示（デフォルト: `213-0022`） |
| 店舗詳細 | チラシ画像一覧・営業時間・地図を確認 |
| 商品抽出 | Gemini Vision API でチラシ画像からセール品（商品名・価格・カテゴリ）を自動抽出 |
| お気に入り | 店舗のお気に入り登録・JSON エクスポート/インポート |
| セール品検索 | お気に入り店舗のセール品をカテゴリ・価格帯で横断検索 |
| 特売日カレンダー | 各店舗の定期的な特売日（ポイントデー等）を月間カレンダーで表示 |
| NAS 同期 | ローカル→リモート（NAS等）へのデータ同期 |
| モバイルAPI | iPhone/Androidアプリ用のお気に入り店舗一覧API（Bearer認証対応） |

**必要な設定:** `GEMINI_API_KEY`（商品抽出用）、`REGIONAL_SALE_PUSH_URL`（NAS同期用）、`INTERNAL_API_TOKEN`（API認証用）

詳細: `docs/Shopping/regional-sale.md`

---

## 武蔵新城 地域ポータル

**URL:** `/musashi-shinjou`

神奈川県川崎市中原区・JR南武線「武蔵新城駅」周辺の地域情報ポータルサイト。ニュース・店舗・イベント情報をまとめて表示する。

| 操作 | 説明 |
|------|------|
| トップ | 最新ニュース・注目店舗・直近イベント・駅情報・天気を一覧表示 |
| ニュース | Yahoo!ニュースから自動取得した地域ニュースをカテゴリ別に閲覧 |
| 店舗 | グルメ・カフェ・ショッピング等カテゴリ別に店舗情報を検索 |
| イベント | 地域のイベント情報を開催日順に一覧表示 |
| ニュース取得 | 管理者がYahoo!ニュース検索から記事を一括取得（ジョブ実行） |

**必要な設定:** なし（外部APIキー不要）

詳細: `docs/LocalPortal/musashi-shinjou.md`

---

## LIFF 価格比較（LINE内検索）

**URL:** `/liff/price-compare`

LINE LIFF（LINE Front-end Framework）上で動作する価格比較の軽量版。LINEアプリ内ブラウザから商品検索ができ、既存の価格比較APIを共有する。

| 操作 | 説明 |
|------|------|
| 商品検索 | キーワードを入力して複数ECサイトの価格を横断検索 |
| カテゴリ・価格帯フィルタ | カテゴリ選択と最小/最大価格で検索結果を絞り込み |
| ショップ選択 | 検索対象のECサイトをチェックボックスで切り替え |
| 結果カード表示 | 商品画像・タイトル・価格をカード形式で表示（タップで商品ページへ遷移） |

**必要な設定:** `LIFF_ID`

詳細: `docs/Shopping/price-compare.md`

---

## 動画自動カット

**URL:** `/auto-video-edit`

動画ファイルをアップロードし、無音区間を自動検出してカット・結合する動画編集ツール。FFmpegとPythonスクリプトによるバックグラウンド処理で、大容量ファイル（最大20GB）のチャンクアップロードに対応。

| 操作 | 説明 |
|------|------|
| 動画アップロード | ドラッグ&ドロップまたはファイル選択でアップロード（チャンク分割対応） |
| プリフライトチェック | FFmpeg・Pythonモジュールの利用可否を自動確認 |
| 自動カット実行 | 無音区間の検出・カット・結合をバックグラウンドで非同期実行 |
| 進捗確認 | SSE（Server-Sent Events）でリアルタイムに処理進捗を表示 |
| ダウンロード | 処理済み動画をダウンロード |
| リトライ | 失敗したジョブの再実行 |

**必要な設定:** FFmpeg（サーバーにインストール）、Python 3 + `moviepy`, `pydub`, `numpy`

---

## Bot Watchdog（自動復旧）

**コマンド:** `php artisan bot:watchdog`

Hyperliquid Bot のプロセスを定期監視し、クラッシュした Bot を自動復旧するスケジュールコマンド。不足 Python モジュールの自動インストールも行う。

| 操作 | 説明 |
|------|------|
| プロセス監視 | 各 Bot の PID を確認し、プロセス死活を判定 |
| 自動再起動 | クラッシュ検出時に Bot を自動再起動（1時間あたりの最大再起動回数制限あり） |
| モジュール自動インストール | ログから不足モジュールを検出し `pip install` で補完 |
| autofix ログ | 自動修正の履歴を JSON ファイルに記録 |

**必要な設定:** `HYPERLIQUID_PRIVATE_KEY`, Python環境

詳細: `docs/Finance/hyperliquid.md`

---

## 競艇AI予想・自動購入

**URL:** `/boat-racing`

boatrace.jp からレースデータをスクレイピングし、Claude AI 予想・バックテスト・Teleboat 自動購入までを統合した日次運用型の競艇予想システム。競馬システムとミラー構造。

| 機能 | 説明 |
|------|------|
| レースデータ同期 | boatrace.jp から出走表・オッズ・結果をスクレイピング |
| AI予想 | Claude AI で期待値・信頼度・推奨金額を算出 |
| バックテスト | 10戦略（1番人気単勝〜複合EV）×任意パラメータで過去検証 |
| 戦略採用 | バックテスト結果を未来レースに自動適用 |
| Teleboat自動購入 | 週予算・レース上限を守り Selenium 経由で自動投票 |
| 購入モニタ | noVNC 連携でリアルタイムブラウザ監視 |
| 投票照会 | Teleboat 投票照会で購入済み舟券を検証・精算 |
| 選手一覧・詳細 | 登録番号・級別・勝率・戦績を参照 |
| 重賞スケジュール | SG/G1/G2/G3 の年間スケジュール＋iCal 配信 |
| 共有ページ | 賭けプラン・履歴・サマリをゲストに公開 |

**必要な設定:** `ANTHROPIC_API_KEY`, `SCRAPING_PROXY`（任意）, Teleboat認証情報（自動購入時）

詳細: `docs/Entertainment/boat-racing-system-spec.md`