🇬🇧 English version

Dexter JP — 日本株の自律型リサーチエージェント

聞くだけで、勝手に計画を立てて、複数のデータソースを横断して、自分で検証しながらレポートまで仕上げる。

EDINET DB + J-Quants で動く、日本株特化の金融AIエージェント。 virattt/dexter（米国株版）をフォークし、日本市場向けに全面改修。

⚠️ 免責事項

本プロジェクトは教育・娯楽・情報提供のみを目的としています。実際の取引や投資判断のために使用することは意図していません。

• 金融、投資、税務、法律に関する助言ではありません
• 正確性、完全性、特定目的への適合性を保証するものではありません
• 出力結果には誤り、不完全な情報、古い情報が含まれる可能性があります
• 作成者および貢献者は、本ソフトウェアの利用によって生じたいかなる金銭的損失・損害についても責任を負いません
• 投資判断を行う前には、必ず有資格の金融アドバイザーにご相談ください
• 過去の実績は将来の成果を示すものではありません

本ソフトウェアを利用することにより、学習・情報提供の目的のみに使用することに同意し、利用に伴う一切のリスクを受け入れたものとします。

10 分で動かす

新しい環境で、次の 3 段で動きます。Bun が無ければ先に入れてください。

1. 録画を再生する（鍵なし・外部への通信なし）

git clone https://github.com/edinetdb/dexter-jp.git
cd dexter-jp
DEXTER_SKIP_BROWSER=1 bun install
bun run demo

2. EDINET DB の鍵を入れる

cp env.example .env

.env の EDINETDB_API_KEY= の右に鍵を書きます。鍵はこちらから無料で取れます（会員登録が要ります）。ほかの行は your-... のままで構いません。env.example に書いてある仮の値のままの行は、起動時に未設定として扱います。

3. LLM を選んで聞く

bun run start

起動したら /model で LLM を選びます。

• Claude Code にログインしているなら「Claude Agent SDK」を選ぶと、API キーを入れずに動きます。Claude のプランでの利用条件は後述のとおりです。.env や環境に ANTHROPIC_API_KEY があると従量課金の経路になるため、送る前に止まります（その経路で動かすときの設定も後述）。このモードでは /check はまだ使えません（この版に入っていないもの）
• OpenAI などの API キーで動かすときは、.env の該当行に鍵を書いてから選びます

たとえば次のように聞きます。

トヨタの直近5年の財務推移を見せて

起動直後の画面に「このセッションで外に出るもの」が出ます。どこへ何が送られるかは、そことデータがどこへ行くかの表で確かめてください。

Dexter を入れずに、手元の AI から直接つなぐ（MCP）

EDINET DB は MCP サーバーとしても公開しています。Claude Code には次の 1 行で登録できます。使うには認証が要ります。認証の画面が出たら EDINET DB のアカウントでログインしてください。画面が出ないときは、下の MCP ガイドにある API キーでの設定を使ってください。

claude mcp add edinetdb https://edinetdb.jp/mcp --transport http

Claude.ai・Claude Desktop・ChatGPT・Cursor・Codex CLI での手順は edinet-db-mcp の README と MCP ガイド にあります。つないだ後にそのまま貼れる問いの例はプロンプトテンプレート集にまとめています。

答え合わせ（v1.1.0-jp）

自分の仮説を、その会社の有価証券報告書の段落に 1 本ずつ当てて、「裏付ける」「食い違う」「無関係」を出典つきで返します。会社自身が何と書いたかを並べるだけで、売買の判断はしません。

/check 9983 中国事業は回復していると会社は説明している

仮説を主張に分け（原文と並べて見せます）、有報の対象節を段落に切り、段落ごとに主張を当てます。段落から確かめられなければ「判定不能」で止めます。モデルに埋めさせません。

パネルには、仮説の原文、分けた主張、判定の根拠になった会社自身の段落（doc_id・提出者・書類種別・節つき）、検査した範囲と未検査数が出ます。

まず動かす

DEXTER_SKIP_BROWSER=1 bun install
bun run demo

bun run demo は記録済みの実行を再生します。鍵は要りません。外部への通信もありません。画面に「録画の再生」と出ます。

DEXTER_SKIP_BROWSER=1 は Chromium（130MB 超）のダウンロードを飛ばします。browser ツールを使うときだけ入れ直してください。

自分の仮説で回すのに要るもの

	鍵	できること
1	なし	bun run demo（録画の再生）
2	EDINETDB_API_KEY + TYPESAFE_API_KEY	/check が動く

EDINET DB の鍵はこちらから無料で取れます（会員登録が要ります）。

/check は TYPESAFE_API_KEY が無いと動きません。 手元の LLM にラベルだけ代行させる構成でも動くようにはしていません。理由は測った結果です。

/check の入口には、売買や株価の水準についての助言を求める入力を判定に進めない検査があります。この検査は「決まった語彙と言い回しの検査」と「判定層の票」の 2 つでできていて、片方だけでは足りません。実装も語彙リストも見せずに別のモデルに書かせた 30 本の助言入力で測ると、こうなりました。

検査	素通りした数	正常な 20 本の誤検知
決まった語彙と言い回しだけ	12/30	0/20
判定層（Jev）の票だけ	1/30	0/20
2 つを合わせたもの（実装の形）	0/30	0/20
決まった語彙 + 手元の LLM の票	8/30	0/20

手元の LLM で代行すると 30 本のうち 8 本が素通りします。素通りさせたまま動かすより、止まる方を選びました。鍵を入れる前に何が返るかは bun run demo で見てください。

出さないもの

• 本ツールは投資助言を行いません。/check と /watch は、売買の指示・目標株価・建玉の大きさを出力しません
• 割安か割高か、妥当な株価の水準は出しません。それを尋ねる入力は判定に進めず、開示で確かめられる言い換えを提案します
• 上昇基調・高値圏のような相場の局面を表す言葉は使いません
• 検査した段落の中での分類数は出しますが、「仮説の支持率」のような 1 つの数字にまとめることはしません
• 確率の表示は「この段落と主張の関係についてのモデルの推定」です。仮説が正しい確率ではありません
• /check の記録は端末内の .dexter/checks/ に残ります。消したいときはこのディレクトリを消してください

データがどこへ行くか

送信先	何が送られるか	いつ	誰の鍵・契約	既定
EDINET DB	銘柄コードと API の要求（有価証券報告書の本文・財務データ・開示イベントの取得）	EDINETDB_API_KEY	あなたの EDINET DB の鍵	有効
選択中の LLM プロバイダ	あなたの仮説の文、有価証券報告書の段落、会話の内容（分解・要約・自由質問）	選んだプロバイダの鍵（/model で切り替え）	あなたの鍵・契約	有効
TypeSafe（Jev、米国）	あなたの仮説から分けた主張と、有価証券報告書の段落（1 段落ずつ）	TYPESAFE_API_KEY	あなたの TypeSafe の鍵	無効
会話履歴の埋め込み（OpenAI → Gemini → Ollama の順で自動選択）	会話の全文（あなたの入力とエージェントの応答）。選択中の LLM とは独立に決まります — /model で Claude を選んでいても、OPENAI_API_KEY があれば OpenAI に送られます	既定で有効。OPENAI_API_KEY / GOOGLE_API_KEY / OLLAMA_BASE_URL のいずれか	あなたの鍵	有効
LangSmith	LangChain のプロンプトとツールの結果（トレース）	LANGSMITH_TRACING=1	あなたの LangSmith の鍵	無効
J-Quants	銘柄コードと日付（株価の取得）	JQUANTS_API_KEY	あなたの J-Quants の契約	無効
Web 検索プロバイダ（Tavily / Exa / Perplexity / LangSearch）	検索語（/search で選んだプロバイダにだけ送られます）	選んだプロバイダの鍵	あなたの鍵	無効
X（旧 Twitter）	検索語（あなたが入力した、またはエージェントが組み立てた検索の語句）	X_BEARER_TOKEN	あなたの鍵	無効
Ollama（既定では手元、設定すれば別のホスト）	会話の内容・埋め込みの対象テキスト	OLLAMA_BASE_URL / OLLAMA_CLOUD_API_KEY	—（手元で動かす場合は外に出ません）	無効
OpenRouter	会話の内容（OpenRouter 経由のモデルを選んだ場合）	OPENROUTER_API_KEY	あなたの鍵	無効
Moonshot	会話の内容（Kimi を選んだ場合）	MOONSHOT_API_KEY	あなたの鍵	無効
DeepSeek	会話の内容（DeepSeek のモデルを選んだ場合）	DEEPSEEK_API_KEY	あなたの鍵	無効
メッセージングのゲートウェイ（Slack / Discord / WhatsApp / LINE）	エージェントの応答（ゲートウェイを起動した場合のみ）	それぞれのゲートウェイを起動したとき	あなたのトークン	無効

TypeSafe（Jev）について、「保存しない」とは書きません。同社は入力を学習データに含めない旨を規約で定めていますが、Telemetry の生成・不正対策・法令対応のための処理権を留保しています。各サービスの規約はご自身でご確認ください。

会話履歴の埋め込みは既定で有効で、選択中の LLM とは独立に送信先が決まります。/model で Claude を選んでいても、.env に OPENAI_API_KEY があれば会話は OpenAI に送られます。起動時に、.env に設定された鍵から、そのセッションで外へ出うる先の一覧が出ます（一覧への掲載は実際の送信を意味しません。送信の条件は機能ごとに異なり、会話履歴の埋め込み先は自動で選ばれます）。

同梱しているデータ

bun run demo が再生する段落は、有価証券報告書の本文です。同梱データ（src/data/materials/）の段落と一字一句同じで（テストで照合しています）、そちらの 1 件ずつに書類管理番号・提出者・書類種別・箇所・取得日・出典表記・編集加工の主体を持たせています。

出典：EDINET閲覧（提出）サイト（https://disclosure2.edinet-fsa.go.jp/）、PDL1.0（https://www.digital.go.jp/resources/open_data/public_data_license_v1.0）

This is the beginning of the README. Read the rest at the original. Read the full README ↗