接入 AI Agent(MCP)

DataSinking 是一個 MCP 伺服器。把你的 agent 指向它,就能用自然語言搜尋並閱讀中國、韓國、日本與台灣的財報全文——無需撰寫程式碼,共 6 個工具。請先 取得免費金鑰,再開始使用。這是 API 參考文件的一部分。

選擇你的客戶端

客戶端設定檔託管 URL 是否可用
Claude Code~/.claude.json, .mcp.json可以
Claude Desktopclaude_desktop_config.json + Connectors UI走 UI
Cursor.cursor/mcp.json可以
OpenAI Codex CLI~/.codex/config.toml可以
WorkBuddy / CodeBuddy~/.workbuddy/mcp.json, ~/.codebuddy/.mcp.json僅 CodeBuddy
其它command + args + env通常可以
DeepSeek (Harness dsh)~/.dsh/cordis.patch.yml (YAML)可以
Windsurf / Devin~/.config/devin/mcp_config.json可以

託管端點

一個 URL,無需安裝,機器上不必有 Python 或 Node。驗證方式是 bearer 標頭,或對無法設定標頭的客戶端改用 ?apikey=

https://api.datasink.ing/mcp

Authorization: Bearer YOUR_KEY      # or: https://api.datasink.ing/mcp?apikey=YOUR_KEY

下面每個客戶端都會在支援的情況下顯示託管版設定。不支援時,文件會退回本地伺服器——同樣 6 個工具,在你自己的機器上透過 npx uvx 執行,同樣無需安裝。

Claude Code

.mcp.json · ~/.claude.json

一行指令就能完成——提示時加入金鑰,然後確認是否已連上:

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

claude mcp list        # → datasinking: ✔ Connected

加上 --scope user 就能在每個專案使用,而不只是目前這一個。Claude Code 會自行對伺服器做健康檢查,所以 claude mcp get datasinking 會直接告訴你連線失敗的確切原因。

完整設定指南 →

Claude Desktop

claude_desktop_config.json

Settings → Connectors → Add → Add custom connector,貼上 https://api.datasink.ing/mcp,並完成驗證提示。這種接法不要改 JSON 設定檔,也不要使用 mcp-remote——那個檔案只支援 stdio,不接受 url 鍵。

完整設定指南 →

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "datasinking": {
      "url": "https://api.datasink.ing/mcp",
      "headers": { "Authorization": "Bearer ${env:DATASINK_API_KEY}" }
    }
  }
}

Cursor 會內插 ${env:NAME}——而不是 Claude Code 那種 ${NAME}。修改後請重新啟動 Cursor;連線錯誤會顯示在 Output → MCP Logs。

完整設定指南 →

OpenAI Codex CLI

~/.codex/config.toml

[mcp_servers.datasinking]
url = "https://api.datasink.ing/mcp"
bearer_token_env_var = "DATASINK_API_KEY"

Codex 沒有 type 欄位——傳輸方式是由你寫了 url 還是 command 推斷出來的。標頭鍵是 http_headers,不是 headers,而且單獨寫 bearer_token 會被拒絕——請改用環境變數。

完整設定指南 →

WorkBuddy / CodeBuddy (Tencent)

~/.workbuddy/mcp.json · ~/.codebuddy/.mcp.json

這是兩個不同的產品,各有各的設定檔——設定“無法生效”最常見的原因就是搞混了:

// WorkBuddy (desktop app) — ~/.workbuddy/mcp.json
{
  "mcpServers": {
    "datasinking": {
      "command": "npx",
      "args": ["-y", "datasinking-mcp"],
      "env": { "DATASINK_API_KEY": "YOUR_KEY" }
    }
  }
}

WorkBuddy 官方文件的設定只支援 stdio;type: "http" 這種寫法在 CodeBuddy Code 上有效,它的設定檔放在 ~/.codebuddy/.mcp.json。改完任一份後請重新啟動應用程式。

完整設定指南 →

其它 MCP 客戶端

command + args + env

本地、stdio、Node 18+ 或 Python 3.8+:

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

# Python instead of Node:
#   "command": "uvx", "args": ["--from", "datasinking[mcp]", "datasinking-mcp"]

完整設定指南 →

Agent 能用什麼

6 個工具。它們與 REST 端點一對一對應,所以 API 參考文件 裡的任何內容都能靠提問取得。

list_exchanges涵蓋哪些市場,以及各有多少
list_stocks單一交易所裡的公司
list_reports某家公司的財報——只有中繼資料
get_report單一份財報,全文
list_sections某份財報的章節標題,附大小
get_section只取一個章節——節省 token,最適合 RAG

第一次測試可以先問 “DataSinking 涵蓋哪些交易所?”——agent 呼叫 list_exchanges 就證明整條鏈路都通了。接著試 “豐田最新的年報對風險有什麼說法?”

連不上時

託管端點只接受 POST、而且是無狀態的。這兩個特性是多數連線失敗的原因,因為客戶端往往假設相反的情況:

401{"detail":"Missing API key"} ——什麼都沒送出。 {"detail":"无效的 API key"} ——金鑰未被辨識。
405用了 GET。這裡沒有 SSE 串流——只能 POST
no tools重新啟動客戶端。它們全部都在啟動時讀取 MCP 設定。
blank header客戶端啟動前環境變數沒有設定好,或是你對該客戶端用了錯誤的內插語法。

想分辨“我的客戶端設定錯了”和“我的金鑰不對”,可以直接跳過客戶端:

curl -s -X POST https://api.datasink.ing/mcp \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

各客戶端的疑難排解——包括每個客戶端實際印出的錯誤——都寫在上面連結的指南裡,位於 docs/mcp/底下。

保留來源署名

每個回應都帶有 source 欄位,標明這份財報來自哪個官方平台——cninfo.com.cn(中國)、DART(韓國)、EDINET(日本)、MOPS(台灣)。MCP 工具描述會要求模型在引用時保留它。轉散布時請不要移除。