イナゴライダー

EDINETの大量保有報告書（新規=350 / 変更=360）を取得し、ウォッチ対象の投資家が提出したものだけを一覧表示する。マルチバガーくんとは別アプリ。

動かし方

npm install
npm run dev

APIキーが無い状態ではモックデータ（架空銘柄）で表示される。

実データに切り替える

1. EDINETのサイトでAPIキーを取得（無料、メールアドレス登録）
2. .env.local を作って書く

   EDINET_API_KEY=取得したキー
   

3. 社名・証券コードは、サーバーがEDINETコードリストを1日1回自動で取得して変換する（/api/status で件数を確認できる）
4. Vercelに置くときは、環境変数 EDINET_API_KEY を設定する

過去の履歴（30日〜半年）

EDINETは1日分ずつしか取れないので、GitHub Actions が平日19時半ごろに自動で取りに行き、 ウォッチ対象の報告書だけを data/history.json に貯める（.github/workflows/history.yml）。 コミットされるとVercelが自動で再デプロイする。

• 準備：GitHubのリポジトリの Settings → Secrets and variables → Actions に EDINET_API_KEY を登録
• 初回：Actions タブの「履歴の更新」→「Run workflow」。空欄のまま実行すると半年分を取得（5分前後）
• ウォッチ対象を増やしたら：同じ画面で日数に 180 を入れて実行すると、過去分も取り直す
• もっと昔まで見たくなったら：日数に 365 などを入れて実行すれば履歴を足せる（画面の期間メニューも足す）

配当利回り・優待

• 配当利回り・PBR・時価総額：Yahoo Finance から1時間ごとに取得（/api/quotes、lib/quotes.js）
• 優待：各社の最新の有価証券報告書「株主に対する特典」欄を読む（scripts/update-yutai.mjs → data/yutai.json）
  • 履歴の更新と同じGitHub Actionsで実行。初回は有報を探すため過去400日分の書類一覧を見る（10分前後）
  • 有報は年1回なので、優待の新設・廃止の反映は次の有報まで遅れることがある

マイ銘柄（/my、合言葉つき）

自分の保有銘柄と、そこに入っている大物の動き（買い増し・売り・5%割れ）を見るページ。トップページからはリンクしていないので、URLと合言葉を知っている人だけが開ける。

Vercelの環境変数に次を入れる（保有銘柄をリポジトリの data/ には置かない）。

変数	内容
MY_PASSWORD	合言葉。変えると全員ログアウトになる
MY_HOLDINGS	「証券コード:株数:取得単価:撤退価格」をカンマ区切り。2つ目以降は省略可。撤退価格は円か、-10% のように取得単価からの下落率で書く。例）8233:100:1622.65,9831:100:733.19:650,4746:100:2129.75:-10%
MY_TOTAL	資産総額（円）。米国株・投信・現金も含めた全体。1銘柄の上限の計算に使う。未設定なら MY_HOLDINGS の評価額の合計で代用
MY_MAX_PCT	1銘柄の上限（資産総額に対する%）。既定は5
MY_STOP_PCT	撤退価格を書いていない銘柄に一律で使う下落率（%）。未設定なら撤退ラインなし
MY_SECRET	任意。ログイン状態の署名に使う鍵（未設定なら合言葉から作る）

• ログインは30日有効（HttpOnlyのCookie）。5回まちがえると15分ロック
• 大物の動きは直近半年分。直近30日の買い・売りは「お知らせ」に出る
• 資金管理：撤退ライン割れ・接近（5%以内）・上限超えを上部にまとめて表示。「これから買う銘柄の上限」に証券コードを入れると、上限内で買える株数を計算する
• 保有銘柄を変えたら MY_HOLDINGS を書き換えて再デプロイ

ファイル

ファイル	役割
data/watchlist.json	ウォッチ対象・分類・提出者名に含まれる文字列。ここを育てる
data/history.json	自動で貯まる過去の報告書（手で編集しない）
scripts/update-history.mjs	履歴を集めるスクリプト
lib/edinet.js	書類一覧APIの取得と照合
app/api/filings	GET /api/filings?days=7&all=1
app/api/pdf/[docId]	PDFをサーバー経由で返す（キーを隠すため）
scripts/build-codes.mjs	EDINETコードリスト → data/codes.json

最初にやること（実データで）

• 「対象外の提出者も表示」をオンにして14日ぶん眺め、ウォッチ対象なのに拾えていない提出者名を data/watchlist.json に足す。特に光通信は関連会社名が多い。
• 井村俊哉さんなど個人は、本人名義で出しているか要確認。

次の段階

• Vercel Cronで1日数回チェックし、新着だけLINEやメールに通知
• 手応えがあれば、マルチバガーくんに「大物の動き」タブとして統合し、銘柄ごとにスコア表示