跳至正文
AGENT 接入

把 AI頭條新聞 接進你的 Agent

MCP、RSS、API 三種方式讀的是同一份資料：精選、熱點、日報、週報和月報，依你用的工具選一種就行。全部匿名唯讀，不用註冊，也不用 API Key。

服務正常版本 4.0.0匿名唯讀 · 無需 Key
MCP填一個位址，多出 7 個工具RSS複製位址，用閱讀器訂閱REST API匿名 GET，自己寫程式取數
REST API · 4.0.0

匿名 GET，拿來就能用

不用 token；瀏覽器跨域、curl 和各語言預設的 HTTP 用戶端都能直接呼叫。路徑是 /api/v1，欄位和錯誤碼以 OpenAPI 為準。

第一個請求
curl --compressed 'https://aitopnews.wiki/api/v1/items?mode=selected&window=24h&limit=20'

依分類篩選

在資訊請求中加上 category，只取對應分類；不傳則包含全部分類。回傳條目的 category 也使用下表中的值。

分類請求參數
AI 模型category=ai-models
AI 產品category=ai-products
產業動態category=industry
論文category=paper
教學category=tip
觀點category=opinion

用得省，也更快

  1. 01
    開壓縮

    curl 加 --compressed，其他用戶端開啟 gzip 或 br。JSON 壓縮後只有原來的 1/4 到 1/8。

  2. 02
    帶上 ETag

    保存回應裡的 ETag，下次帶 If-None-Match；內容沒變時回傳 304，不傳正文。

  3. 03
    依節奏取

    資訊和熱點最快一分鐘一次；日報每天 08:00 後取一次，週報、月報出刊後取一次；往回翻頁翻到已有的那則就停。

內容多久變一次：新資訊全天陸續進來，精選每天變幾次到幾十次，日報每天 08:00、週報每週一 10:00、月報每月 1 日 10:30（北京時間）各一期。

介面一覽

路徑用來做什麼多久取一次
資訊
/api/v1/items精選或最近 7 天全部動態，可依分類、時間窗、關鍵詞篩最快 1 分鐘一次
熱點與事件
/api/v1/hot-topics目前熱點榜 Top 10最快 1 分鐘一次
/api/v1/stories/{publicId}一個事件的報導時間線、AI 綜述和關聯事件需要時
日報
/api/v1/dailies/latest最新一期日報每天 08:00 後一次
/api/v1/dailies/{date}指定日期日報；撤稿會移除引用快取過期後使用前驗證 ETag
/api/v1/dailies日報日期索引每天一次
週報與月報
/api/v1/weeklies/latest最新一期週報：頭條、總述和一週重點，依欄目分好每週一 10:00 後一次
/api/v1/weeklies/{week}指定一週，ISO 週如 2026-W39；撤稿會移除引用快取過期後使用前驗證 ETag
/api/v1/weeklies週報索引每週一次
/api/v1/monthlies/latest最新一期月報每月 1 日 10:30 後一次
/api/v1/monthlies/{month}指定月份，如 2026-09快取過期後使用前驗證 ETag
/api/v1/monthlies月報索引每月一次
給 AI 助手
/api/v1/agent給 Agent 的使用說明，列出的位址回傳整理好的 Markdown需要時
完整精選同步
/api/v1/selected/snapshot目前全部精選，分頁一次拿全只在第一次
/api/v1/selected/changes之後的新增、修改和撤選幾分鐘一次

常見用法

bash
# 第一次：保存回應標頭裡的 ETag\n# 之後最快每分鐘一次，帶上 ETag；回傳 304 就是沒變化\n
curl --compressed -i 'https://aitopnews.wiki/api/v1/items?mode=selected&window=24h&limit=20'
curl --compressed -i -H 'If-None-Match: <last ETag>' 'https://aitopnews.wiki/api/v1/items?mode=selected&window=24h&limit=20'

需要往回翻頁時，把 page.nextCursor 作為 cursor 傳回去，翻到已經有的那則就停，不要每次把 7 天重翻一遍。

出錯了怎麼辦

400
參數不對：依 OpenAPI 和回傳的 code 修正，不要自動換成更寬的查詢。cursor 無效或滑出時間窗回傳 invalid_cursor，從第一頁重來。
409
snapshot_required：增量沒法安全續上，重新取一次完整快照。
429
請求太密：依 Retry-After 等待，不要並發重試。
5xx
指數退避，先用上次成功的結果；公開服務不承諾 SLA。

能匿名呼叫不等於所有用途都獲許可：見使用規則。