1
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

日本株・J-REITのチャートを並べて見比べるデスクトップアプリ「elecxstock」をClaude Codeで作った

1
Last updated at Posted at 2026-11-18

2026年11月18日に、v0.1.13の内容に合わせて更新しました。ポートフォリオ・マーケット・配当シミュレータ・トレンドラインなど、v0.1.0以降に追加した機能を加えています。

私は日本株とJ-REITのデスクトップアプリelecxstockを開発しています。東証プライムとJ-REITの日足・週足・月足と配当の履歴を手元のPCに取り込み、スクリーナーで絞った銘柄のチャートを最大30枚まで並べて見比べられるほか、保有の集計や配当を軸にした過去の試算もでき、操作はすべてキーボードで行えます。Windows向けで、MIT Licenseで公開しています。

チャートグリッド。スクリーナーで絞った銘柄の週足を4×3で並べたところ
チャートグリッド

画面と動画の株価・利回り・配当・保有は、テスト用に乱数で作った架空の値です(銘柄名とコードだけ実在します)。

作ったものと設計のほか、AIのレビューでテストを丸ごと作り直した話も書きます。

動機

私は高配当株とJ-REITを中心に、長期で持つ前提で投資しています。銘柄を選ぶときは、だいたい次の繰り返しです。

  1. 利回りや連続増配年数などの条件で候補を絞る
  2. 候補のチャートを日足・週足・月足で見て、今が高いか安いかを見る
  3. 過去の配当の推移と、利回りが過去3年のどのあたりにあるかを見る
  4. 保有している銘柄と業種の偏りを確かめる

これまでは、条件で絞るのはWebのスクリーナー、チャートは証券会社のツール、配当の推移は別のサイト、保有の集計は表計算ソフトと、ツールが分かれていました。特に2で何十銘柄も見比べるときは、ブラウザのタブを行き来するしかありませんでした。

そこで、大引けのあとのこの作業だけに絞って作りました。場中の売買や板、分足、発注、米国株は対象外です。

できること

画面は9つのタブに分かれていて、Ctrl+Shift+1〜9で切り替えます。各タブはペインを分割した配置で、ペインの種類や並びは変えられます。

スクリーナーのタブ。左から条件と結果、銘柄情報、日足のチャートと配当シミュレータ
スクリーナー。結果の行を上下キーで移ると、銘柄情報・チャート・配当シミュレータが追従します

  • スクリーナー: 利回り・連続増配年数・5年の増配率・権利確定月・PER・PBR・騰落率(配当込みも)・最大下落率・保有割合・取得利回りなど58項目。「かつ/または」と、「終値 ≥ 75日移動平均」のような相対条件で組み、名前を付けて保存できます
  • チャートグリッド: 2×2から6×5まで並べられます。時間軸・表示期間・並べ替え・比較(始点を100%)をまとめて切り替えます
  • チャート: 移動平均・一目均衡表・RSI・MACDなど、配当落ちと株式分割のマーカー、分割調整/未調整/配当込みの切り替え、目標利回りに当たる株価の水平線、トレンドライン
  • 保有とポートフォリオ: NISAの各枠と特定・一般口座を分けて記録し、楽天証券のCSVを取り込めます。評価額の推移、資産構成、損益寄与、配当の分析を1つのタブにまとめています
  • 配当シミュレータ: スクリーナーの結果や保有を仮想の銘柄群として、「3年前に買っていたら今いくらか」と「今買ったら配当はいくら入りそうか」を手元のデータで計算します
  • アラート: 銘柄の条件か、保存したスクリーニング条件に新しく入った銘柄で知らせます。分割があってもしきい値を換算します
  • マーケット: 国内外の指数・為替・金利の一覧、33業種のヒートマップ(面積が時価総額、色が騰落率)、騰落とランキング、ニュースの見出し
  • マイレイアウト: 自分で組んだ配置を名前付きのページとして最大30枚まで持てます
  • マルチモニタ: タブのないサブウィンドウを最大3枚開き、別のモニタにチャートを並べられます

2枚のモニタに並べたところ
右のサブウィンドウのチャートは、左のメインウィンドウで選んだ銘柄を追います

数字キーを打ち始めると証券コードで銘柄にジャンプします。Ctrl+Kはコマンドバー、Alt+矢印はペイン間のフォーカス移動、D・W・Mは時間軸の切り替え、Ctrl+Shift+Enterはペインの最大化です。

v0.1.0以降に追加した機能

v0.1.0を出したあと、6日間でv0.1.13まで更新しました。主なものを紹介します。

ポートフォリオ

ポートフォリオのタブ。評価額、資産推移、資産構成、損益寄与、配当見込み
ポートフォリオ。保有と資産推移の記録はすべて架空です

評価額と含み損益に加えて、資産推移、業種・口座・銘柄ごとの資産構成、期間ごとの損益寄与を1画面で見られます。PgDnで配当の分析に切り替わり、年間配当(税引後)と前年比、今後12か月の見込みを出します。資産推移は、毎日の更新と保有の変更のたびにその時点の評価額を記録しています。

画面共有や録画のために、保有の金額と数量を****で隠すプライバシーモードも付けました(Ctrl+Shift+H)。金額と数量が見えなければ資産の大きさは分からないので、割合や利回りのように分析に使う値は隠さずに残しています。

配当シミュレータ

配当シミュレータ。保有の9銘柄を3年前に300万円で均等に買っていた場合の試算
配当シミュレータ。値は架空のデータからの試算です

スクリーナーで絞った銘柄群を、そのまま「N年前に買っていたら」の計算にかけるペインです。元本、配当を受け取るか再投資するか、税率をペイン上部の設定欄で指定すると、今の評価額をキャピタルとインカムに分けて表示します。比較対象として、TOPIX連動ETF(1306)と、同じ業種の銘柄に均等に投資した場合も同じ条件で計算します。

TOPIXに対する超過リターンは「規模」「業種の配分」「銘柄選び」の3つの要因に分解します。さらに、同じ業種構成で無作為に選んだ銘柄群を1,000通り作り、その分布の中で選んだ銘柄群が下から何%の位置にいるかも表示します。ただし、今日の条件で選んだ銘柄で過去を測っているので良く見えるのは当然で、その偏りや、上場廃止した銘柄が入らないことは、画面の「前提」の欄に書いています。

PgDnの「これから」では、横ばいと伸びを見込む場合の年ごと・月ごとの配当を試算します。予想ではなく過去の実績の延長なので、画面の下に投資助言ではない旨を常に表示しています。

マーケットとニュース

マーケットのタブ。指数の一覧、ヒートマップ、騰落、ニュース、指数のチャート
マーケット。ニュースの見出しはスタブの架空のものです

TOPIXやJPX日経400など、Yahooから取れない指数は連動ETFで代わりに出しています。ニュースのペインは、日本銀行・金融庁・JPXなどのRSSフィードの見出しを並べます。同梱する23本のフィードは、私が規約を読んで、使ってよいと判断したものだけです。報道の配信元の多くは要約を出さず、見出しとリンクだけを出します。ニュースを取るかどうかは初回の起動で選び、オフにしている間は1回も通信しません。

トレンドライン

トレンドライン。日足に支持線と抵抗線を引いたところ
トレンドライン。下部に操作キーを表示しています

チャートでAlt+Tを押し、矢印キーで始点と終点をローソク足や高値・安値に合わせて引きます。線は銘柄ごとに日付と価格で保存するので、日足から週足に切り替えても同じ位置に表示されます。サブウィンドウで引いた線も、ほかのウィンドウのチャートに表示されます。

このほか、タスクトレイへの常駐とWindows起動時の自動起動、ペインの最大化とタブの切り替えのアニメーション、日足の保存期間の既定を3年にする変更などを入れています。

数字で見る開発

項目 値
期間 2026年11月13日〜18日の6日間
コミット 237(2026年11月18日時点)
リリース v0.0.1〜v0.1.13(20回)
ソース 約45,000行(TypeScript / Svelte / CSS)
テスト 約21,000行。Vitestで1,175件、Playwrightで231件
文書 要求仕様書1,112行、設計判断の記録167行、CLAUDE.md 190行

方針は私が決めて、仕様書もコードもテストもClaude Codeに書いてもらっています。

アプリの構成

データの取得・保存・指標の計算は、別のプロセス(以下Core)に分けています。CoreはElectronのutilityProcessで動き、electronをimportしない素のTypeScriptです。

  • ウィンドウごとにMessagePortを渡し、UIとCoreが直接やり取りします。約1,600銘柄の指標を再計算している間もUIは止まりません
  • UIからCoreへの要求は、すべてzodのスキーマで検証します。サブウィンドウは「読むだけ」で、書けるのは★の切り替えやトレンドラインなどに限ります
  • 外へ通信できるのはCoreだけで、行き先はYahoo・JPX・GitHub(新しいバージョンの確認)の許可リストに限っています。リダイレクトの行き先も確かめます。ニュースは専用のfetchを使い、オンにしたフィードのホストにだけ通信します。UIからの通信はCSPで禁止しています
  • 利用者のデータはJSON、市場データはSQLiteで、どちらも手元のPCに保存します

SQLiteは、better-sqlite3とNode.jsに組み込まれたnode:sqliteを2,000銘柄×5年(245万行)で比べました。書き込みは8.9秒と6.4秒、1銘柄の読み出しは0.97msと1.38msで、どちらも要件には十分でした。ネイティブモジュールの再ビルドが要らないnode:sqliteにしています。

データの取得方法

価格はyahoo-finance2経由でYahoo Financeの非公式APIから取っています。作り始める前に、応答の癖を調べて仕様に書きました。

調べたこと 結果 仕様への反映
日足のOHLC 分割調整済みで返る。配当の金額も分割調整済み 調整済みのまま保存し、未調整・配当込みは表示のときに計算する
大引け直後の当日の足 しばらくcloseがnull 終値のない足は保存せず、一括取得した終値を使う
52週高値・安値 当日の値幅が入っていて使えない 手元の日足から計算する
月足の日付 UTCで返り、日本時間にしないと1か月ずれる 日本時間に直してから月を決める
TOPIXなどの指数 取れない 連動ETFで代わりに出す
予想配当 算出元が一貫しない 実績配当だけを使う
上場廃止 Yahooは過去データも消す(yahoo-finance2のREADMEによる) 手元のデータを消さずに残す

日々の更新では、複数銘柄の現在値をまとめて取得するAPI(1リクエストで最大50銘柄)で終値を取り、日足を取り直すのは分割の疑い・取りこぼし・定期の照合に当たる銘柄だけにしています。分割を見つけたら全期間を取り直し、取得に成功してから1つのトランザクションで置き換えます。Yahooが混み合ったとき(429・5xx)や通信が切れたときは、ログに残すようにしました。

指標は1つの定義表で管理

スクリーナーとアラートの条件、一覧の列、条件を選ぶダイアログは、1つの定義表(レジストリ)から作っています。指標を1つ足すと、どの画面にも出ます。型を抜粋します。

export interface FieldDef {
  id: string // 例: 'income.yield'
  label: LocalizedName // 日本語と英語
  type: FieldType // 'money' | 'percent' | 'ratio' | ...
  source:
    | { kind: 'metrics'; column: string } // 取得のたびに作る指標の表
    | { kind: 'attr'; key: 'market' | 'kind' | 'sectorJa' } // 市場区分・業種など
    | { kind: 'user'; key: 'favorite' | 'watchlist' | 'held' } // ★・ウォッチリスト・保有
    | { kind: 'compute'; key: string } // 実行時に計算(保有割合・予定までの日数)
  operators: CondOp[]
  unit?: LocalizedName // 円・万円・億円など
  refGroup?: RefGroup // 相対条件の相手にできるまとまり
}

市場データだけで決まる指標は、取得のたびに銘柄ごとのmetrics表へ1行にまとめて書きます。日足をその場で集計すると2,000銘柄で300〜600msかかり、スクリーニングを500ms以内にする目標に余裕がなかったためです。保有割合や権利付最終日・決算発表までの日数のように、利用者のデータや今日の日付で変わる指標だけを実行時に計算します。

条件を選ぶダイアログ
条件を選ぶダイアログ。分類ごとに並び、キーワードで絞り込めます

テストの作り直し

テストをすり抜けた10件の不具合

スクリーナーの指標を23項目足したあと(v0.1.1)、別のAIにリポジトリをレビューしてもらったら、テストは全部通っているのに不具合が10件出てきました。たとえばこんなものです。

  • 金額の条件の単位がずれる(時価総額を億円のつもりで「100」と打つと100円になる)
  • 5年の増配率が、銘柄情報とスクリーナーで別々に計算されていて値が違う
  • 保有を変えても、スクリーナーが走り直さない

テストで見つからなかった原因を調べると、変換や判定がSvelteのコンポーネントの中にあって単体テストで確認できない、定義表の一部しか確かめていない、同じ値を2か所で計算しているのに突き合わせていない、E2Eが変えたあとの追従を見ていない、の4つでした。

テストの層と観点を決めてから書き直し

その場で穴をふさぐのをやめ、先にテストの計画をClaude Codeで書きました。別モデル(Claude Fable 5.2)のサブエージェントで「この計画で上の不具合を検出できるか」を検証し、指摘がなくなってから実装に入りました。

層 何を確かめるか
L1 純粋な関数 指標・足の集計・営業日・条件の評価・表示と入力の変換
L2 定義表 指標・キー操作・利用者のデータを書くメソッドが、すべての項目について整合すること
L3 Coreの結合 取得・分割・取り直し・DBの移行・利用者のデータ
L4 画面のロジックの結合 一覧の列や保有の評価を、Coreにつないで動かす
L5 E2E キーボード操作、状態の変化への追従、再起動、複数のウィンドウ
L6 契約 実際のYahoo・JPX・ニュースのフィードの応答の形(値は保存しない)

やってみて効いたと思うのは、この4つです。

  • コンポーネントに計算を書かない。条件の値の入力と表示の変換を関数に切り出し、スクリーナーとアラートが同じ関数を呼びます。単位のずれは、この関数の単体テストで検出できます
  • 定義表はすべての項目で確かめる。58項目それぞれで「表示した値を入力し直すと元の値に戻る」ことを確かめ、単位・入力の倍率・欠損の扱い・列の有無を1つの表にまとめてスナップショットテストで管理しています
  • 2つの経路は突き合わせる。配当の指標と銘柄情報のグラフ、スクリーナーとアラートの判定は、境界のデータ(上場5年未満・無配に転じた・配当なし)で比べます
  • 時刻を基準日時にそろえる。スタブのデータのときだけ効く環境変数ELECXSTOCK_NOWで、main・Core・UIのDateを同じだけずらします。テストは「2026年11月13日(金)18:00」として動き、時間の経過を見るテストだけが時計を進めます

E2Eは、初回取得を済ませたデータを1回だけ作り、各テストをそのコピーから起動します。キー入力ごとの60msの待ちもやめ、並列で回しています。作り直した時点で、53件で3.4分かかっていたのが、104件に増えても約2分になりました!

最後に、10件の修正を1件ずつ元に戻し、新しいテストが10件とも失敗することを確かめました。作り直しの途中でも、条件の値を開き直して確定すると細かい桁が丸められて値が変わる、★の付け外しでスクリーナーが走り直さない、サブウィンドウで配置を変えた直後に終了すると変更が消える、といった不具合が見つかっています。

その後の機能も、この層の分け方で足しています。たとえばニュースは、コードをニュース用のフォルダにまとめ、既存のファイルへの変更を決めた箇所だけに限っています。その箇所はL2のテストがimport文を読んで確かめています。

現状の制限

データ源は非公式のAPIなので、仕様の変更で取れなくなることがあります。データ源を差し替えられる形にはしてありますが、今あるのはYahooだけです。

会社予想の配当や、売上・利益の長期の推移はまだないので、Webの分析サイトと併用しています。配当シミュレータの「これから」も、予想配当ではなく過去の実績から計算しています。

初回は全銘柄の日足を取るので数十分かかります(取得中も、取得済みの銘柄から使えます)。また、コード署名をしていないので初回の実行でSmartScreenの警告が出るうえ、動作を確かめているのはWindowsだけです。

おわりに

Geminiに国内外の似たツールを調べてもらいましたが、長期・インカム投資向けにチャートの比較とスクリーナーを手元のデータとキーボード操作でまとめたものは見つかりませんでした。私は毎日、大引けのあとに使っています!

機能の要望や不具合はIssuesかXで教えてください。


開発中の日本株アプリ「elecxstock」について

Repository: GitHub - kurouna/elecxstock
Download: Releases
X (Twitter): @elecxstock

価格と配当はYahoo Financeの非公式APIから取っています。本アプリは投資助言ではありません。投資の判断はご自身の責任でお願いします。

開発中のエディタ「elecxzy」について
elecxzyでは、サクサク動くEmacsっぽいキーバインドのエディタを目指して開発を続けています!

Repository: GitHub - kurouna/elecxzy
Download: Releases
X (Twitter): @elecxzy

興味があればぜひ触ってみてください!

1
2
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?