DataSinking

DataSinking

米国とアジアの財務報告書全文を、読みやすいMarkdownで提供します。

DataSinking は、米国、英国、中国、日本、韓国、台湾の年次・半期・四半期の財務報告書全文を、LLM での読み込みや RAG にすぐ使える、読みやすい Markdown 形式で提供します。FMP 形式のシンボル（AAPL、600519.SS、7203.T、005930.KS、2330.TW）で検索するか、取引所、報告期間、セクションで絞り込みます。報告書全体ではなく MD&A／リスクのセクションだけを取得できるため、トークンを節約できます。すべての数値は、出典となる開示資料とブロックまで追跡できます。報告書は公式の開示プラットフォームから取得し、YAML frontmatter、見出し、段落、表を保持した構造化 Markdown に変換されます。

---

MCP サーバー

DataSinking を MCP サーバーとして、あらゆる AI エージェント（Claude / Cursor / Codex / Devin Desktop / n8n）に導入できます。6 つのツールを利用できます。取引所の一覧表示、株式の一覧表示、報告書の一覧表示、報告書の取得、セクションの一覧表示、セクションの取得（RAG 向けにトークンを節約）。

ホスト型 — インストール不要

URL は 1 つだけで、パッケージも Python もローカルサーバーも不要です。ほとんどのクライアントでは、次の形式を使います。

{
  "mcpServers": {
    "datasinking": {
      "type": "http",
      "url": "https://api.datasink.ing/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Claude Code の場合は、1 行で設定できます。

claude mcp add --transport http datasinking https://api.datasink.ing/mcp \
  --header "Authorization: Bearer YOUR_KEY"

ヘッダーを設定できないクライアントでは、代わりにキーを URL に含めることができます — https://api.datasink.ing/mcp?apikey=YOUR_KEY — ただし、ほかに手段がない場合に限ってください。URL に含めたキーはログや画面共有に残り、クライアント側で秘匿することもできません。

上記の形式に当てはまらないクライアントが 2 つあります。Codex の設定は TOML 形式で、Devin Desktop のリモート用フィールドは url ではなく serverUrl です。クライアントごとのファイルはこちらです：docs/mcp/。

ローカル — 自分で実行

すべてを自分のマシン上に置きたい場合は、同じ機能を持つビルドが 2 種類あります。すでに使っているランタイムを選んでください。

Node 18+（Python 不要）：

{
  "mcpServers": {
    "datasinking": {
      "command": "npx",
      "args": ["-y", "datasinking-mcp"],
      "env": { "DATASINK_API_KEY": "YOUR_KEY" }
    }
  }
}

Python 3.8+：

pip install "datasinking[mcp]"
datasinking-mcp          # requires DATASINK_API_KEY (free at https://datasink.ing)

その後、クライアントで command: datasinking-mcp を使用します。

どちらも同じスキーマの 6 つのツールを実行します。npm/ と datasinking/mcp_server.py は、check_mcp_parity.py によって常に同じ内容に保たれています。

クライアントごとの詳しい設定方法：mcp-server.md（概要） · docs/mcp/（クライアントごとのガイド）。

ホスト型エンドポイントは POST 専用でステートレスです。GET /mcp は 405 を返し、セッション ID は発行されません。ほとんどのクライアントは起動時に MCP の設定を読み込むため、設定を変更したらクライアントを再起動してください。

このリポジトリについて

財務報告書データの扱い方を示す例、調査、チュートリアルを提供します。財務報告書に関する研究論文で使われている表示スタイルの再現方法も紹介します。

datasinking/
├── examples/     # Example scripts: pull data from the API and analyze it
├── research/     # Research notes / blog posts (reproducing paper-style presentation)
├── datasinking/  # Python client + MCP server — pip install "datasinking[mcp]"
├── npm/          # The same MCP server on npm — npx -y datasinking-mcp (Node 18+)
├── r-datasinking/  # R client for the same API
├── docs/mcp/     # Per-client MCP setup — Claude Code, Desktop, Cursor, Codex, WorkBuddy, Devin…
├── mcp-server.md # MCP server overview — endpoint, per-client table, tools, troubleshooting
├── llm-examples.md  # Ask an LLM — no code needed (8 end-to-end examples)
├── api-examples.md  # 7 examples × 3 interfaces (curl / Python / LLM)
└── README.md

クライアントごとの MCP ガイド — 設定ファイルの正確なパス、両方のスコープ、検証方法、そのクライアントで実際に発生するエラーを、それぞれ 1 ファイルにまとめています。

クライアント	ガイド
Claude Code	docs/mcp/claude-code.md
Claude Desktop	docs/mcp/claude-desktop.md
OpenAI Codex CLI	docs/mcp/codex.md
WorkBuddy / CodeBuddy	docs/mcp/workbuddy.md
Doubao Work / 豆包工作	docs/mcp/doubao.md
Cursor	docs/mcp/cursor.md
DeepSeek Harness (dsh)	docs/mcp/deepseek.md
Devin Desktop	docs/mcp/windsurf.md
OpenCode	docs/mcp/opencode.md
Qoder	docs/mcp/qoder.md
Reasonix	docs/mcp/reasonix.md

クイックスタート

1. datasink.ing で API キーを取得します
2. 1 行で実行します（FMP 形式の ?apikey=）：

curl "https://api.datasink.ing/documents?symbol=600519.SS&with_content=1&apikey=YOUR_KEY"

または、Python の場合：

pip install datasinking

from datasinking import DataSinking

ds = DataSinking("YOUR_KEY")
for r in ds.get_stock_reports("600519.SS", limit=3):
    print(r["report_period"], r["title"], len(r["content"]), "chars")

または、R の場合：

library(datasinking)
ds_set_key("YOUR_KEY")
head(ds_documents(symbol = "600519.SS", doc_type = "annual"))

5 つの関数すべて（curl / Python / LLM）については、api-examples.md をご覧ください。R クライアントは r-datasinking/ にあります。

LLM に質問する（コード不要）

コードを書きたくありませんか？任意の LLM から datasink.ing にアクセスできるようにし、API キーを渡して、自然な言葉で質問してください。8 つの一連の例（対応範囲の確認、企業のレポート一覧の取得、正しい単位での数値抽出）については、llm-examples.md をご覧ください。

例（examples/）

ファイル	内容
01_quickstart.py	5 つの基本関数：取引所／株式／レポートの一覧取得、レポートの取得、株式のレポートの取得
02_download_company.py	企業のレポート一式をローカルの Markdown ファイルにダウンロード
03_download_exchange.py	取引所全体のレポート（全銘柄分）をローカルの Markdown ファイルにダウンロード
rag_ingest.py	レポートを RAG チャンクに分割（`` アンカーを使用し、source で追跡可能）して、ベクトルストアに取り込み

すべての例はライブ API からデータを取得し、そのまま実行できます。

03_download_exchange.py は、取引所のレポートをすべて取得します（例：深センの全銘柄分、15 万件以上の文書）。クォータは、ローリング 7 日間でリクエスト数ではなく文書数をカウントします。無料キーでは、7 日間あたり 3 req/s、8,191 件の文書を利用でき、無料ユーザーとウェブサイト訪問者全員で共有する 7 日間あたり 524,287 件のプールに含まれます。そのため、無料キーで取引所全体を取得するには 1 週間を大幅に超える時間がかかります。**有料（年額）**キー（31 req/s、7 日間あたり 524,287 件の文書）を強くおすすめします。

リサーチ（research/）

research/ には、DataSinking のデータを使い、出典を明記したリサーチノートやブログ記事があります。金融レポートに関する研究論文に掲載されたグラフやプレゼンテーションを再現できます。例：

• 長期的な売上高／利益の推移
• 業界比較と分布
• 財務指標の時系列

research/TEMPLATE.md から始めてください。

データ概要

対応範囲	米国（NYSE / NASDAQ / OTC）・中国（SSE / SZSE / BSE）・英国（LSE）・日本（TSE）・韓国（KOSPI / KOSDAQ）・台湾（TWSE / TPEx）
文書の種類	年次／半期／q1／q3／修正
更新頻度	毎日 — 米国／韓国／日本は SEC EDGAR / DART / EDINET の公式 API を利用（公開から約 24 時間以内に新規提出書類を取得）
形式	全文 Markdown（YAML frontmatter を含む）
API	REST — GET /documents、一括ダウンロード、全文取得用の with_content=1、章単位のアクセス用の ?section= + /sections
銘柄コード	FMP 形式：AAPL / 600519.SS / 7203.T / 005930.KS
認証	?apikey= クエリパラメーター（FMP 形式）

データソース

レポートは各市場の公式規制情報開示プラットフォームから取得し、社内で整形して読みやすい Markdown に変換しています。

市場	ソース	プラットフォーム
米国（例：AAPL のようなティッカー）	SEC EDGAR	米国証券取引委員会 — sec.gov/edgar
中国 A 株（.SS .SZ .BJ）	巨潮资讯网 cninfo	中国証券監督管理委員会（CSRC）指定の開示プラットフォーム
韓国（.KS .KQ .KN）	DART	金融監督院 — opendart.fss.or.kr
日本（.T）	EDINET	金融庁 — disclosure2.edinet-fsa.go.jp
台湾（.TW .TWO）	公開資訊觀測站 MOPS	台湾証券取引所 — mops.twse.com.tw

すべての文書には API レスポンスの source フィールドも含まれているため、出典情報はデータとともに保持されます。再配布する際も、この情報を残してください。

引用方法

論文で DataSinking を使用する場合は、データの入手可能性に関する注記（必要に応じて謝辞も）を追加してください。

データの入手可能性：

米国、中国、日本、韓国、台湾の全文金融レポート（年次、半期、四半期の提出書類）は、DataSinking（https://datasink.ing）から Markdown 形式で取得しました。

BibTeX：

@misc{datasinking2026,
  author       = {{DataSinking}},
  title        = {{DataSinking: Full-text financial reports as Markdown}},
  year         = {2026},
  howpublished = {https://datasink.ing},
  note         = {Accessed: 2026-10-27}
}

DataSinking が提供するのはレポート本文であり、投資助言ではありません。

アフィリエイト

紹介した顧客が購入するたびに、1件につき7ドルを獲得できます。報酬は継続的に発生し、PayPalで受け取れます。最低出金額は31ドルです：datasink.ing/affiliate

ライセンス

MIT