接入 AI Agent(MCP)
DataSinking 是一個 MCP 伺服器。把你的 agent 指向它,就能用自然語言搜尋並閱讀中國、韓國、日本與台灣的財報全文——無需撰寫程式碼,共 6 個工具。請先 取得免費金鑰,再開始使用。這是 API 參考文件的一部分。
選擇你的客戶端
| 客戶端 | 設定檔 | 託管 URL 是否可用 |
| Claude Code | ~/.claude.json, .mcp.json | 可以 |
| Claude Desktop | claude_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 工具描述會要求模型在引用時保留它。轉散布時請不要移除。