xfinlab

XFINLAB

金融インテリジェンス基盤 — 開発者や AI エージェント向けの API、SDK、MCP サーバーに加え、同じバックエンド上に構築された一般消費者向けリサーチプラットフォームです。

実際の市場イベント、FinBERT によるセンチメント分析、テクニカル分析／市場構造分析、SEC／CFTC／FDIC／USDA／CBOE の公式データ、モンテカルロ・ストレステストを提供します。すべてのフィールドは、実際の計算または公式データソースに基づいており、捏造や補間は一切ありません。

アーキテクチャ · 無料の API キーを取得 · API ドキュメント · llms.txt · 一般消費者向け製品

クイックスタート（API）

pip install "git+https://github.com/lnanology/Xfinlab.git#subdirectory=sdk/python"

from xfinlab_intelligence import XfinlabClient

client = XfinlabClient(api_key="xfl_...")  # free tier, issued instantly
sentiment = client.sentiment("AAPL")
technical = client.technical("AAPL", period="6mo")
fundamentals = client.fundamentals("AAPL")

または JavaScript／Node の場合：

npm install "github:lnanology/Xfinlab#path:sdk/js"

const { XfinlabClient } = require('xfinlab-intelligence');
const client = new XfinlabClient('xfl_...');
const sentiment = await client.sentiment('AAPL');

合計 19 個のエンドポイントがあります。市場イベント、センチメント、AI ディベート、テクニカル分析／市場構造分析、モンテカルロ・ストレステスト、インサイダー取引、機関投資家の保有状況、空売り残高、SEC XBRL ファンダメンタルズ、CBOE VIX 期間構造、FDIC 銀行健全性、USDA 農業、EIA エネルギー、暗号資産、地域横断型マーケットマップ、Pro ティアの Webhook を提供します。完全なリファレンスは intelligence-api.html をご覧ください。

MCP サーバー（Claude などの AI エージェント向け）

このサーバーが返すフィールドはすべて、実際の計算結果または公式ソースの実データ値です。該当しない場合は、説明を添えて null を返します。現在、MCP エコシステムには多くのサーバーがありますが、ツール呼び出しの背後にあるデータの実際の品質について説明しているものはほとんどありません。このサーバーは、その品質を公開しています。xfinlab.com/trust.html では、すべての基盤データ収集システムの稼働／停止状況をリアルタイムで確認できます。

すでに本番環境で稼働しているため、セットアップは不要です。MCP 対応クライアントから接続するだけです。

{
  "mcpServers": {
    "xfinlab": {
      "url": "https://api.xfinlab.com/api/mcp",
      "headers": { "X-API-Key": "xfl_..." }
    }
  }
}

ホスト型サービス（サーバーの実装はプロプライエタリで、api.xfinlab.com で稼働しています）。ツール（6 個）：get_market_events、get_sentiment、get_technical_analysis、get_intelligence_feed、get_global_market_map、get_fundamentals_as_of（特定時点の SEC ファンダメンタルズ）。認証と無料ティアは REST API と共通です。ドキュメント：intelligence-api.html#mcp。

本番環境での利用状況

初期段階の実数を正直に公開しています。2026-09-22 にプラットフォームの管理画面に表示されていた指標をそのまま引用しており、見栄えをよくするための編集はしていません。個々のメールアドレスは管理画面では確認できますが、実在する人のアドレスを公開 README でさらす理由はないため、ここでは掲載していません。

• セルフサービスの無料プラン開始以降、API キーを 15 個発行しました（有効 14 個、失効 1 個）。運営者自身のテストキーは呼び出し回数が 0 回のため、以下の利用量に自作のトラフィックは含まれておらず、およそ 13 人の異なる外部開発者・研究者が利用しています。
• 累計 669 回の重み付け API 呼び出しに対応しており、実際のインテグレーションは少数に集中しています。最も利用量の多い単一アカウントが累計の半分以上を占め、2 番目に多いアカウントがさらにおよそ 5 分の 1 を占めています。
• 登録者の 1 人は .edu のメールアドレスを使用しており、単なる気軽な試用だけでなく、学術・研究分野の関心を示す小さな初期シグナルとなっています。
• API 専用登録者とは別に、コンシューマー向け調査サイト（xfinlab.com）には自然流入によるアカウントが 5 件あります。登録アカウントは合計 7 件で、そのうち 2 件は運営者自身のアカウントと社内の LINE ボット連携であり、外部ユーザーではないため、この数には含めていません。
• 応答時間や稼働率の SLA 数値は掲載していません。実際にはまだ測定しておらず、このプロジェクトはユーザーに掲げているのと同じ捏造ゼロの方針を自らにも課しているため、ケーススタディ向けに未測定の数値を作り出すこともありません。データソースごとのステータス（リクエストごとのレイテンシではありません）は、同じページでリアルタイムに確認できます。

この利用で見つかり、いずれも発見当日に修正した実際のバグが 2 件あります。

• SEC Form 4 の誤検出（2026 年 9 月）。 SEC EDGAR の browse-edgar の type フィルターは完全一致ではなく、前方一致のワイルドカードとして動作することが判明しました。type=4 が無関係な 424B シリーズの提出書類にも密かに一致し、「インサイダー取引」のアクティビティとして扱われていました。ユーザーからのバグ報告ではなく、プラットフォーム独自のデータソース健全性アラートで発見し、SEC のライブレスポンスと照合して確認しました。SEC のページネーションリンク自体が type=4 を type=4%25 に書き換えており、それがバグを見つける手掛かりになりました。
• 時点指定／ビンテージデータストア（2026 年 9 月）。 r/quant に寄せられたクオンツ研究者のコメントにより、提出書類の期間末日を「その日に既知だった」日付として扱うと、実際の提出遅延や後日の修正を無視してしまうことが指摘されました。これはバックテストで古くから知られる先読みバイアスの原因です。ファンダメンタルズの各値について、対象期間ではなく実際に提出情報が利用可能になったタイムスタンプを保持する専用の（独自仕様の）ストアを構築しました。また、修正後の値は元の値を上書きせず、新しい不変の行として保存されます。そのため、「日付 X に何がわかっていたか」と「現時点で判明している最新の値」は、どちらも正しい別々のクエリとして扱えます。

SDK とサンプル

Python SDK	sdk/python — README
JavaScript/Node SDK	sdk/js — README
クイックスタートスクリプト	sdk/examples/python_quickstart.py、sdk/examples/js_quickstart.js
OpenAPI 仕様	https://api.xfinlab.com/api/intelligence/openapi.json
Postman コレクション	https://api.xfinlab.com/api/intelligence/postman.json

両 SDK は MIT ライセンス（sdk/LICENSE）で、標準ライブラリ／ネイティブの fetch 以外に必須の依存関係はありません。

コンシューマー向け製品

同じバックエンドは、小口投資家向け調査プラットフォームの xfinlab.com も支えています。

モジュール	パス
ホームページ	index.html
AI マーケットリサーチ™	ai-analysis.html
チャートリサーチ™	chart-analysis.html
企業比較™	company-compare.html
イベントインテリジェンス™	news-denoise.html
リスクエンジン™	stress-lab.html

ローカル開発

python3 mock-server.py

その後、http://localhost:8080 を開きます。本番バックエンドは独立した非公開サービス（api.xfinlab.com としてデプロイ）です。上記の静的サイトは別途 Vercel に xfinlab.com としてデプロイされます。

その他のドキュメント

• XFINLAB_ARCHITECTURE.md — システムアーキテクチャの全容
• PROJECT_ROADMAP.md — ロードマップ
• PROJECT_STYLE_GUIDE.md — UI スタイルガイド
• DATA-LICENSE-MATRIX.md — 有料エンドポイントごとの上流データソースのライセンス
• MCP_MARKETPLACE_SUBMISSION.md — MCP サーバーディレクトリへの掲載申請文