Kurage Stock Brain
Kurage Stock Brain (ksbrain):証拠IDを必須化し、根拠追跡可能な日本株・米国株インテリジェンスを返すエージェント向けAPI。
Kurage Stock Brain(ksbrain)は、kurage(株式会社エクスブリッジ)が公開する根拠を追跡できる日本株・米国株インテリジェンスAPIです。kcbrain(暗号資産)・kfxbrain(FX)に続く「Kurage brainシリーズ」の頭脳として、「判断より先に、根拠を揃える」を掲げ、証拠IDを必須化したエージェント向けJSONで判断を返します。公開repoのREADME(kurage-repos収録)では、TradingAgents-JPや外部AIエージェントに価格・財務・開示・ニュース・市場環境の評価を構造化JSONで提供する「日本株インテリジェンスAPI」と定義され、米国株はSEC EDGAR自動取得の拡張として実装されています。LP上の見出しは「証拠優先・GEMMA 4・AGENT-READY」で、AIエージェント向け日本株・米国株インテリジェンスと案内されています。リファレンス実装はtradingagents-jpです。
- プロダクトサイト: https://ksbrain.exbridge.jp/(kurage-sitesに収録)
- 日本語LP: https://ksbrain.exbridge.jp/ksbrain.html(kurage-lpsに収録)
- リファレンス実装: https://tajp.exbridge.jp/
- 公開repoのREADME冒頭アイコン: images/ksbrain-icon.png
- 開発時ポート: 18338
- LPからの導線: English / 実際の画面を試す / GitHub / TradingAgents-JPを試す
概要
- kcbrain・kfxbrainに続く日本株・米国株向けの頭脳です。READMEは「根拠を追跡できる日本株インテリジェンスAPI」と説明し、テクニカル・ファンダメンタルズ・開示・ニュース・強弱討論・リスク評価を、証拠IDとデータ時点付きのJSONで提供します(米国株はSEC EDGAR自動取得に対応)。
- 利用者が権利を持つ市場データや入力資料だけを使用し、存在しない証拠IDは除外、資料がなければ「証拠不足」と明示します(evidence-traceability)。
- 有料レールはdeepseek(deepseek-v4-flash)、自前運用ではgemma 4(ローカルLLM)を選択できます。
- 取引画面ではなく、他のAIエージェントやサービスからも呼べる再利用可能な「頭脳」として設計されています。
- LP・READMEとも「発注、証券口座接続、資産運用は行わない」「出力は投資助言ではなく、判断を検証するための補助情報」と明記しています。README末尾の注意も同様に、モデル出力には誤りがあり得るため、データ提供元の規約、金融商品取引法その他の適用法令を確認し、最終判断は一次資料と照合するよう促しています。
設計原則
LPで明示されている3つの原則です。
- TRACEABLE(証拠IDを必須化) — 判断が参照した入力をIDで返します。存在しないIDは除外し、資料がなければ「証拠不足」と明示します。
- STRUCTURED(エージェント向けJSON) — 方向、確信度、反証、リスク、不足情報、品質、時点を安定したスキーマで返します。
- BOUNDARY(注文を実行しない) — 証券口座には触れません。ポリシー、数量、人間の承認、執行は呼び出し側に残します(trust-boundary)。
「生データから監査可能な判断まで」を、データ取得・判断・委員会の進行・執行を分離することで実現しています(後述の処理の流れ参照)。
設計の変遷
- 2026-07-25の記事「TradingAgents-JPを公開し、判断基盤ksbrainを独立APIにした設計——日本株AIで『画面』と『頭脳』を分ける」で、日本株AIのUI部分(tradingagents-jp)と判断基盤(ksbrain)を分離する設計が公開されました。
- この「画面と頭脳の分離」により、ksbrainは独立したAPIとして利用でき、リファレンス実装はその後マルチユーザーSaaSのktajp(Kurage TradingAgents)へ発展しました。
- 同様に、finrobotを日本語ファーストにforkし、Kurage判断APIをx402従量課金で接続したkfinanalyst(Kurage Finanalyst)も、この判断基盤の活用事例です。ksbrainの判断所見をレポートに添付できる点で関連します。
- kurage-reposに収録されたREADMEは、分離後のAPIサーバーとしてのksbrain(証拠登録→分析→突合の基本フロー、J-Quantsデータアダプター、x402ゲート、設計境界)を詳述しています。
設計境界
READMEで明示されている境界です。
- 株の分析に専念し、暗号資産用のkcbrainには依存しません。
- LLMはollamaへ直接接続します。
- 発注、証券口座接続、資産運用は行いません。ポリシー・数量・人間の承認・執行は呼び出し側に残します。
- 入力された根拠ID以外を判断の出典として返しません。
- Yahoo Finance等の非公式APIへ黙ってフォールバックしません。
- J-Quantsの利用・再配布条件は利用者自身の契約に従います。
- EDINETは設定状態を公開しますが、0.1.0では自動同期対象外です。
処理の流れ
基本的な利用フロー(README準拠)は次のとおりです。
POST /v1/evidenceで証拠を登録する。POST /v1/analyze/{type}またはPOST /v1/analyze/fullを呼ぶ。- 返却された
evidence_idsとGET /v1/company/{symbol}/evidenceを突合する。
証拠登録の具体例(READMEより)。
curl -X POST http://127.0.0.1:18338/v1/evidence \
-H "Authorization: Bearer $KSBRAIN_KEY" \
-H "Content-Type: application/json" \
-d '{
"symbol": "7203",
"kind": "technical",
"title": "日足指標",
"facts": {"close": 3000, "sma_20": 2950},
"source_name": "licensed data",
"observed_at": "2026-07-25T00:00:00Z"
}'
type は technical, fundamentals, disclosure, news, market-context, bull-bear, risk です。役割が明確な別名として POST /v1/debate/bull-bear と POST /v1/assess/risk も提供します。最大10銘柄の保存済み証拠を比較する POST /v1/screen/opportunities は、強弱方向と確信度から順位を返します。
LPの「生データから監査可能な判断まで」に対応する4ステップでも整理できます。
- 収集 — 手動資料、または利用者の契約下で取得したJ-Quantsデータ(
POST /v1/data/jquants/sync。APIキーがない場合はHTTP 503を返し、別データを捏造しません)。 - 保存 — 正規化・時刻付与・ハッシュ化を行い証拠IDを発行。
- 判断 — gemmaが入力済み証拠だけを評価し、不足も返却。
- 統合 — tradingagents-jpなどが討論と最終ポリシーを適用。
認証とx402
/v1/*はAuthorization: BearerまたはX-API-Keyで利用する内部・契約者向けAPIです。/x402/v1/analyze/fullは機械間課金用で、初期状態では無効です。有効化には次が必要です。
1..venv/bin/pip install -e '.[x402]'
2. 受取ウォレット、ネットワーク、facilitatorを明示設定
3.KSBRAIN_X402_ENABLED=true- 初期ネットワークはBase Sepolia(
eip155:84532)です。公式x402 SDKがPAYMENT-SIGNATUREを検証し、facilitatorで精算します。テストネット専用のhttps://x402.org/facilitatorをBase mainnetで使う設定は起動時に拒否されます。
提供チャネル
kcbrain・kfxbrainと同じ全マーケットプレイスで販売中です。LPでも「kcbrain・kfxbrainと同じ全マーケットプレイスで販売中」と明記されています。決済にはx402を利用し、サブスクなしの従量課金です。有料レールはDeepSeek(deepseek-v4-flash)で応答します。
| チャネル | 入口 | 料金 |
|---|---|---|
| bankr(x402) | x402.bankr.bot/.../ksbrain | $0.05/コール |
| coinbase-cdp / Bazaar(x402) | cdp-gateway /ksbrain/* | 全スキル$0.05 |
| jpyc(x402) | :18349 /ksbrain/* | 全スキル7.5 JPYC |
| virtuals-acp | 「Kurage AI Project」のoffering: Kurage Stock Brain | $0.05 |
| rapidapi(カード決済) | rapidapi.com/katsushi2441/api/kurage-stock-brain | 従量課金 |
API構成(抜粋)
APIキー認証(直叩き・ローカルGemma)に加え、米株はSEC EDGAR自動取得のワンショット分析(POST /v1/us/analyze/full)に対応します。証拠登録(POST /v1/evidence)の主なフィールドは symbol / kind / title / facts / source_name / observed_at です。
- POST /v1/evidence — 追跡可能な証拠の登録
- POST /v1/data/jquants/sync — 日本株の一次データ同期(J-Quants・要契約。日足と財務情報を証拠ストアへ保存)
- POST /v1/data/us/sync — 米国株の一次データ同期(SEC EDGAR財務・開示+日足)
- POST /v1/us/analyze/full — 米株ワンショット:EDGAR自動取得+7段フル分析
- POST /v1/analyze/technical — 価格・指標評価(market=jp/us対応)
- POST /v1/analyze/fundamentals — 財務情報評価
- POST /v1/analyze/disclosure — 開示・資料評価
- POST /v1/debate/bull-bear — 強気・弱気材料の統合
- POST /v1/assess/risk — リスク評価
- POST /v1/analyze/full — 総合分析
- POST /v1/screen/opportunities — 最大10銘柄の比較
- GET /health、GET /docs、GET /.well-known/x402.json — 動作確認・API仕様・x402 discovery
分析呼び出しの例:
curl -X POST http://127.0.0.1:18338/v1/analyze/technical \
-H "Authorization: Bearer $KSBRAIN_KEY" \
-H "Content-Type: application/json" \
-d '{"symbol":"7203","evidence_ids":["ev_..."]}'
開発起動
READMEの手順です。
python3 -m venv .venv
.venv/bin/pip install -e '.[dev]'
cp .env.example .env
# .env に KSBRAIN_API_KEYS を設定
.venv/bin/ksbrain
- Web:
http://127.0.0.1:18338/ - OpenAPI:
http://127.0.0.1:18338/docs - Health:
http://127.0.0.1:18338/health - x402 discovery:
http://127.0.0.1:18338/.well-known/x402.json
バイブトレーディングとの関係
vibe-tradingの道具として、「根拠を追跡できる銘柄インテリジェンス」を提供します。証拠IDを必須化し、資料がなければ「証拠不足」と返すので、AIの提案を鵜呑みにせず検証する作法に合います。動いているシステムはkfreqai(暗号資産)とkfxai(FX)です。
関連プロダクトとの関係
- kcbrain(暗号資産)・kfxbrain(FX)と同じマーケットプレイス群で販売されています。ksbrainの判断スキーマ(方向・確信度・リスク・不足情報)もこのシリーズと共通の設計思想に沿っています。
- リファレンス実装としてtradingagents-jpがあり、ktajp(Kurage TradingAgents)とも関連します。
- kfinanalystのレポートにはksbrainの判断API所見を添付できます。
- kfreqaiやkfxaiと同様に、ai-judgment-backendとしても位置づけられます。
- kurage-reposでは、主要プロダクトのREADME群の中にksbrainのREADMEも収録されています。
公開URL
公式のKurage / exbridge.jp公開URL索引(kurage-sites)では、ksbrainは以下の2エントリで登録されています。
- https://ksbrain.exbridge.jp/
- https://ksbrain.exbridge.jp/ksbrain.html
この索引は、主要サイト・プロダクトLP・デモ/商品ページをカテゴリ別に整理したもので、ksbrainは「プロダクトLP」の一覧に含まれています。これらはexbridgeが運用するexbridge.jpドメイン群の一部であり、他プロダクト(karchitect、ktajp、url2brain等)と並んで一覧に管理されています。
出典
- kurage-lps(Kurage各プロダクトのLP集)
- kurage-repos(Kurage主要プロダクトの公開repo README集。ksbrainのREADMEを含む)
- kurage-sites(Kurage / exbridge.jp公開URL索引)
- kurage-articles-index(Kurage AI OSS技術解説ブログ記事索引)
- 関連コンセプト: trust-boundary、x402、local-llm、vibe-trading、evidence-traceability、ai-judgment-backend
See also: kurage-articles-index
Kurage.AI に質問する
