給程式與 AI 代理的存取說明
這個資料庫同時給讀者、搜尋引擎的爬蟲、AI 代理與自己寫的程式使用。大家讀到的內容與權限相同,差別只在入口:讀者看頁面,程式可以直接取得 JSON。
資料介面
唯讀,回應是 JSON,不需要申請,也不需要金鑰。機器可讀的說明在:
https://ejournal.press.ntu.edu.tw/index.php?act=Opendata
https://ejournal.press.ntu.edu.tw/index.php?act=Opendata/journals- 全部期刊:代號、刊名、學門、開放範圍、篇數、最新一期
https://ejournal.press.ntu.edu.tw/index.php?act=Opendata/journal/J17- 一種期刊的基本資料與全部卷期
https://ejournal.press.ntu.edu.tw/index.php?act=Opendata/issue/J17_0_104- 一期的目錄
https://ejournal.press.ntu.edu.tw/index.php?act=Opendata/article/1- 一篇文章的完整書目、摘要、關鍵詞與全文狀態
https://ejournal.press.ntu.edu.tw/index.php?act=Opendata/search&q=…- 檢索,參數與頁面的檢索相同
檢索時請用中文與英文各查一次:多數文章同時有中文與英文的篇名與摘要,兩種語言查到的結果不完全相同。檢索結果的每一筆都附摘要的開頭與關鍵詞;年份可以給區間(year_from、year_to),最多十年。
網站每一頁的標頭區都有 <link rel="service-desc"> 指向上面那個機器可讀的說明。
給 AI 助手的 MCP 入口
支援 Model Context Protocol(MCP)的 AI 助手可以直接把這個資料庫加成工具。在助手的 MCP 設定裡新增一個遠端(HTTP)伺服器,網址填:
https://ejournal.press.ntu.edu.tw/index.php?act=Opendata/mcp
不需要帳號或金鑰。加入之後,助手會看到下面五個唯讀的工具;它們和上面的網址是同一組功能、同一套權限。
search_articles- 檢索文章
get_article- 一篇文章的完整書目、摘要、關鍵詞與全文狀態
list_journals- 全部期刊:代號、刊名、學門、開放範圍、篇數、最新一期
get_journal- 一種期刊的基本資料與全部卷期
get_issue- 一期的目錄
全文不透過 MCP 傳送:工具回傳全文的狀態與網址,由助手依網站的權限去讀。雲端的 AI 助手是從廠商的主機連線,不在校內,所以讀不到限校內的全文;在校內電腦上執行的助手可以。
全文的權限
全文沒有另外的入口。文章的回應裡有 full_text,說明這一篇的全文狀態、這次連線能不能讀,以及全文的網址;那個網址就是網站上的全文網址,照常檢查權限。
- 公開的期刊,任何來源都可以讀全文。
- 標示「全文限校內」的期刊,只有臺大校內網路可以讀全文,程式也一樣。
- 只有書目的文章沒有全文可讀。
用量上限
程式與讀者的用量分開計算,程式再多也不會佔用讀者的額度;反過來,程式超量時只會被請求稍後再試,不會被封鎖。
大量抓取的爬蟲和替使用者做事的 AI 助手也分開計算:爬蟲把自己的額度用完,不影響助手。爬蟲不論抓的是頁面還是資料介面,都算在爬蟲這一邊。
| 來源 | 單一來源每分鐘 | 全部合計每分鐘 |
|---|---|---|
| 資料介面,以及替使用者讀取的 AI 助手(次) | 120 | 300 |
| 爬蟲,以及其他表明身分的程式讀頁面(次) | 600 | 300 |
| AI 助手開啟全文(份) | – | 10 |
| 爬蟲與程式開啟全文(份) | – | 30 |
| 程式讀取帶條件的檢索結果頁(次) | – | 20 |
超過時回應 HTTP 429 與 Retry-After 標頭,請等到指定的秒數之後再試。
帶條件的檢索結果頁(勾選、排除、學門)組合無限多,內容與文章頁重複,robots.txt 不開放給機器人;程式送出的這類請求合計有一個很低的上限。要依條件查詢請用資料介面的檢索。沒有表明身分、也沒有瀏覽器跡象的請求,同樣算在這個上限裡。
資料介面的每個回應都帶 RateLimit-Policy 與 RateLimit 標頭,說明這個來源適用的上限、這一分鐘還剩幾次、幾秒後重新計算。
全文請一次取完整份:程式分段取得同一份全文時,每一段都算一次。只要標頭(HEAD)與內容沒有變動(304)的請求不算。
沒有表明身分的程式(User-Agent 和瀏覽器一樣)會被當成讀者:單一來源每分鐘上限是 120 次,超過會被暫時擋下,重複發生會被封鎖。請在 User-Agent 寫明程式的名稱與聯絡方式。
內容沒有變動時
每一個頁面與資料介面的網址都支援 ETag 與 Last-Modified。請帶 If-None-Match 或 If-Modified-Since 來問;沒有變動時回應 304,不必重新下載。資料介面的回應裡,meta.updated 是資料最後一次有變動的時間。
使用條件
- 全文僅供個人學術研究與教學使用。
- 標示「全文限校內」的期刊,全文只能在臺大校內網路閱讀。
- 請勿以程式大量下載。
有問題,或研究上需要較高的用量,請聯絡國立臺灣大學出版中心:ntuprs@ntu.edu.tw
請 AI 助手查這個資料庫
助手支援 MCP 的話,照上面的方式加入 MCP 入口最省事。不支援的話,把下面的網址交給它即可,它會從那裡讀到全部的用法:
https://ejournal.press.ntu.edu.tw/index.php?act=Opendata