跳到主要內容

開發者文件

這份日報的每一則都有結構化的資料與原始出處。以下是取得它的四種方式： REST API、MCP、RSS，以及電子報。

閱讀統計與隱私

我們以站內匿名事件統計公開頁面的可見載入，不記錄 IP、帳戶身分、來源網址或查詢參數。工作階段以每分頁的暫存識別碼計算，伺服器每日更換雜湊；不等同獨立人數。瀏覽器開啟 Do Not Track 或 Global Privacy Control 時不送出瀏覽事件。收藏排行只顯示文章的收藏總數，不公開誰收藏了什麼。統計從啟用日起累積，沒有補造歷史瀏覽量。

開始使用

讀取端點全部公開，不需要金鑰。回應是 JSON，日期即識別碼。

最快的一次呼叫
1curl https://newsapi.yuhuanstudio.com/api/issues/latest

每一則都有出處

條目裡的 url 是原始文章的網址，confidence 是信心等級 （一手來源／多家報導／單一來源），與逐項原文核實結果分開顯示。引用時請一併帶上出處——AI 彙整只用來 快速掌握脈絡，重要資訊要回原文確認。

管線內部的評分不在回應裡。它決定什麼刊出、以什麼順序刊出，之後就 沒有意義了：它講的是管線而不是新聞。條目的先後就是rank。

REST API

GET/api/issues

最近的期別日期，最新的在前。

GET/api/issues/latest

最新一期，含全部條目。

GET/api/issues/{date}

指定一期，日期格式 YYYY-MM-DD。 期別上還有兩個欄位：gist 是 當天的一句概要（站上的 og:description、Discord 公告、RSS 與電子報 都用它），cover_version 是封面 的指紋，內容變它才變——把它接在封面網址的?v= 上，那張圖就可以放心永久 快取。

GET/api/entries

全部已刊出條目的 (date, uid)。

GET/api/search?q=&limit=

全文檢索。中文查詢以子字串比對，英文走全文索引——Postgres 沒有 中文斷詞，兩者用同一種比對的話中文會全部落空。

GET/api/rollups

週報列表。

GET/api/rollups/{end}

指定一份週報。

GET/api/topics

全部主題與各自的報導則數，最多的在前。min_entries 預設 2。

GET/api/topics/{key}

一個主題的時間線。名稱會正規化後比對，所以NVIDIA、Nvidia 與輝達 是同一條。

GET/api/auth/bookmarks

自己的收藏。需要金鑰或已登入的 cookie。

管理者金鑰

金鑰屬於管理者帳號時，也可以讀/api/admin/* 的 GET——執行紀錄、 來源健康、對照覆蓋率。寫入（發佈、改設定、隱藏條目）一律仍需登入的 工作階段，界線畫在 HTTP 方法上而不是逐條路由：GET 改不了任何東西。 一般讀者的金鑰在那裡讀不到東西。

速率限制

每 60 秒 120 次。帶金鑰的呼叫獨立計算，沒帶的以來源位址計算。 超過時回 429，並帶Retry-After。每個回應都有X-RateLimit-Remaining。

API 金鑰

公開端點不需要金鑰。金鑰的用途是提高速率上限，以及讀取自己的收藏。在/account/keys建立。

兩種標頭都可以
1curl -H "Authorization: Bearer yn_…" https://newsapi.yuhuanstudio.com/api/auth/bookmarks
2 
3# X-API-Key 也行，與 Yunxin 一致
4curl -H "X-API-Key: yn_…" https://newsapi.yuhuanstudio.com/api/auth/bookmarks

MCP

把日報接進任何支援 MCP 的客戶端（Claude Desktop 等），讓模型直接讀， 不必去爬 HTML。

claude_desktop_config.json
1{
2  "mcpServers": {
3    "yunnews": {
4      "command": "python",
5      "args": ["-m", "yunnews.mcp_server"],
6      "env": { "YUNNEWS_API_KEY": "yn_…" }
7    }
8  }
9}

YUNNEWS_API_KEY 可以省略——省略時 一樣讀得到公開內容，只是速率上限較低，也看不到收藏。

提供的工具

toollatest_issue

今天（或最近一期）的全文。

toolget_issue(date)

指定日期的那一期。

toolsearch(query, limit)

全文檢索。查特定模型或公司的歷史用這個，不要逐日翻。

toollist_issues

有哪些期別。

toolweekly_rollup(end)

一週的收束。

toollist_saved

自己的收藏（需金鑰）。

資源與提示

工具是「問」，資源是「翻」：客戶端可以直接把yunnews://latest掛進對話，模型不必先猜日期。另有yunnews://issues與yunnews://issue/{date}，以及一個 brief_me 提示。

RSS 與電子報

GET/rss.xml

完整 RSS，每期一則。

POST/api/subscribe

訂閱每日電子報（需確認信）。也可以直接用訂閱頁。

給 AI 代理的站台說明在/llms.txt。

引用與授權

條目文字由 AI 整理自公開來源，每則附原始連結。轉載請保留出處連結， 並註明內容為 AI 彙整。原始文章的著作權屬於各自的出版者。