新時空 MCP 接入指南

所有參數均為可選。不傳任何參數即返回全站最新文章。

search_articles

返回單段 Markdown 文本，不是 JSON。結構固定為「概要行 → 分隔線 → 逐條列表」：

📋 NewTimeSpace 資訊檢索結果
關鍵詞: 小米 | 分類: 全部 | 語言: zh-cn
日期: * ~ * | 排序: publish_time desc
第 1/15 頁 · 本頁 10 條 · 總計 143 條
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【1】恒生中國企業(02828.HK)盤中漲0.96%，恒指重回23000點… (ID: 1455411)
· 分類: ETF | 語言: zh-cn | 發布時間: 2026-10-23T13:45:24+08:00
· 作者: 沈博瀚 | 來源: 新時空 | 標簽: ETF盤中異動,恒生中國企業,02828.HK
· 摘要: 恒生中國企業(02828.HK)10月23日盤中漲0.96%、報79.640港元…
· 鏈接: https://www.newtimespace.com/zh-cn/etf/1455411.html

──────────────────────────────

【2】…

• 概要行給出當前頁碼 / 總頁數 / 本頁條數 / 命中總數，可據此判斷是否需要翻頁。
• 列表中的 摘要 可能被截斷（以 ...... 結尾），需要全文請調 get_article_detail。
• 發布時間 為帶時區 ISO 8601（+08:00）。
• 鏈接 的路徑隨 language 變化（/zh-cn/、/zh-hk/、/en/）。
• 傳 include_content: true 時，每條改為 📰 文章詳情 [ID: …] 塊並附 正文內容 (N 字，Markdown)。

get_article_detail

📰 文章詳情 [ID: 1455411]
標題: 恒生中國企業(02828.HK)盤中漲0.96%，恒指重回23000點、國企指數午盤漲0.93%
分類: ETF | 語言: zh-cn | 時間: 2026-10-23T13:45:24+08:00
作者: 沈博瀚 | 來源: 新時空 | 標簽: ETF盤中異動,恒生中國企業,02828.HK
鏈接: https://www.newtimespace.com/zh-cn/etf/1455411.html
────────────────────────────────────────
正文內容 (842 字，Markdown):
新時空訊：截至10月23日13時39分，恒生中國企業(02828.HK)上漲0.96%…

多篇時同樣以 📰 文章詳情 [ID: …] 分塊連續返回。單篇正文約 800–2800 字。

標準兩步式：先檢索列表拿到 ID，再按需取正文，避免一次性拉取大量正文導致上下文溢出。

1. 檢索：search_articles({"query":"小米","limit":10})。先看概要行的命中總數，判斷關鍵詞是否過寬（數萬條）或過窄（0 條）。
2. 選目標：從列表挑 1–10 條最相關的 ID。
3. 取正文：get_article_detail({"article_ids":"1455411,1455409"})。
4. 整理輸出：回答中保留 標題 + 發布時間 + 鏈接，便於溯源。

常見場景速查

服務端會區分兩類失敗：參數越界返回工具錯誤（isError: true），無結果返回空文案 + 提示。

如果所在環境無法添加 MCP Server，只要能發 POST 請求就能調用本服務。整個流程兩步：先 initialize 拿會話 ID，再帶著會話 ID 發 tools/call。

12.1 硬性要求（缺一不可）

12.2 最快方式：一條命令跑完

把兩步合成一次執行，直接返回數據：

SID=$(curl -si --max-time 40 -X POST https://mcp.newtimespace.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"web-agent","version":"1.0"}}}' \
  | grep -i '^mcp-session-id:' | tr -d '\r' | cut -d' ' -f2) && \
curl -s --max-time 40 -X POST https://mcp.newtimespace.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: $SID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_articles","arguments":{"query":"小米","limit":2}}}'

它就是下面 12.3 的兩步用 && 串起來的。若你的運行環境一次只能執行一條命令，直接用這條最省事。

12.3 拆開執行（兩步分別調用）

第一步，握手並取出會話 ID：

SID=$(curl -si --max-time 40 -X POST https://mcp.newtimespace.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"web-agent","version":"1.0"}}}' \
  | grep -i '^mcp-session-id:' | tr -d '\r' | cut -d' ' -f2)
echo "SID=$SID"

第二步，帶著會話 ID 調用工具：

curl -s --max-time 40 -X POST https://mcp.newtimespace.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: $SID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_articles","arguments":{"query":"小米","limit":3}}}'

響應是 SSE 流，正文包在 data: 行裏：

event: message
data: {"result":{"content":[{"type":"text","text":"📋 NewTimeSpace 資訊檢索結果n…"}],"isError":false},"jsonrpc":"2.0","id":2}

取用方法：取 data: 其後那一段 JSON，讀 result.content[0].text，內容即第八節所示的 Markdown 文本。若 result.isError 為 true，text 裏是錯誤說明而非數據。

12.4 用官方 SDK（Python）

若環境裏有 Python 且能 pip install mcp，直接用官方 SDK 最省事，握手與會話管理它全包了：

import anyio
from mcp import ClientSession
from mcp.client.streamable_http import streamable_http_client

async def main():
    async with streamable_http_client("https://mcp.newtimespace.com/mcp") as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print([t.name for t in tools.tools])

            r = await session.call_tool("search_articles", {"query": "小米", "limit": 3})
            print(r.content[0].text)

anyio.run(main)

適配 mcp 2.x：只傳 URL 即可連通，SDK 會自動把協議版本協商到 2025-11-25，兩個工具及全部參數均正常。註意 2.x 起字段為蛇形命名（is_error、input_schema），照舊版教程寫 isError 會報 AttributeError。

12.5 三個可以省掉的動作

• notifications/initialized 可以不發。規範建議發送，但本服務不強製——跳過它直接調 tools/call 完全正常。發了會返回 202 空響應，無副作用。
• MCP-Protocol-Version 請求頭可以不帶，帶了值不對也不影響調用。
• 同一個會話 ID 可以連續復用多次調用，不必每次重新 initialize；若中途失效，重跑第一步即可。

12.6 排錯對照