DataSinking

DataSinking

覆盖美国和亚洲的金融报告全文，采用整洁的 Markdown 格式。

DataSinking 提供金融报告全文——年度、半年度和季度报告，涵盖美国、英国、中国、日本、韩国和台湾，并以整洁的 Markdown 格式呈现，可供大模型阅读和用于 RAG。可按 FMP 风格的代码（AAPL、600519.SS、7203.T、005930.KS、2330.TW）查询，也可按交易所、报告期间或章节筛选——只提取 MD&A／风险章节，而非整份文件，从而节省令牌。每项数据都可追溯至其来源披露和区块。报告来自官方披露平台，并解析为结构化 Markdown，包含 YAML 前置元数据，并保留标题、段落和表格。

---

MCP 服务

将 DataSinking 作为 MCP 服务接入任何 AI Agent（Claude / Cursor / Codex / Devin Desktop / n8n）——提供 6 个工具：列出交易所、列出股票、列出报告、获取报告、列出章节、获取单个章节（适合节省令牌的 RAG）。

托管服务——无需安装

只需一个 URL，无需安装软件包、Python 或本地服务。大多数客户端使用以下配置：

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

Claude Code，只需一行：

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 中的密钥会留在日志和屏幕共享中，客户端也无法将其隐藏。

有两个客户端不适用上述配置：Codex 使用 TOML 配置，而 Devin Desktop 的远程服务字段是 serverUrl，不是 url。各客户端的配置文件见：docs/mcp/。

本地运行——自行启动

如果你更愿意将所有内容保留在自己的计算机上，这里有两个功能相同的构建版本——选择你已有的运行时即可：

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。

两者运行相同的六个工具，且使用相同的架构——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 指南——每个客户端各有一份文件，包含准确的配置路径、两种作用域、验证方法，以及该客户端实际产生的错误：

客户端	指南
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. 一行代码（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"))

所有五个函数（curl / Python / LLM）：api-examples.md。R 客户端位于 r-datasinking/。

向 LLM 提问（无需编写代码）

不想编写代码？让任意 LLM 访问 datasink.ing， 提供你的 API 密钥，然后用自然语言提问。请参阅 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 会获取某个交易所的所有报告（例如，深圳的所有报告，共 150k+ 份文档）。配额按文档数而非请求数统计，按滚动 7 天计算：免费密钥的限额为每秒 3 个请求、每 7 天 8,191 份文档，且计入所有免费用户和网站访客共享的每 7 天 524,287 份文档的总池。因此，使用免费密钥下载整个交易所的数据将耗时超过一周，强烈建议使用**付费（年度）**密钥（每秒 31 个请求、每 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，请添加数据可用性说明（也可选添加致谢）。

数据可用性：

全文财务报告（涵盖美国、中国、日本、韩国和台湾的年度、半年度及季度申报文件）以 Markdown 格式从 DataSinking（https://datasink.ing）获取。

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 提供报告文本，不提供投资建议。

联盟推广

每推荐一位客户购买，即可赚取 $7，收益可重复获得，通过 PayPal 收款，最低提现金额为 $31：datasink.ing/affiliate

许可证

MIT