跳到主要內容

Deerpark API

本站提供公開 API,可用來查詢佛經資料、全文搜索、下載經文以及查閱佛學辭典。API 風格類似 CBETA API 的簡化版本。

如果你使用 Claude Code、Codex 等 AI Agent,可以直接安裝 deerpark Agent Skill,讓 Agent 自動學會用這些 URL 查經、讀經、找出處。

基本概念

  • work — 一部經或一部論,有的很長有 600 卷,有的只有一卷。
  • juan — 一卷,也就是一個 html 文件。
  • lb — 行號。在 html 文件中以 <span class="lineInfo" line="0106c09"></span> 的形式出現。

All Works — 取回所有佛經

取回所有佛經的 metadata,目前有 4600+ 條。

請求

GET https://deerpark.app/api/v1/allworks

返回示例

[
  {
    "id": "T0001",
    "title": "長阿含經",
    "byline": "後秦 佛陀耶舍共竺佛念譯",
    "juans": [1,2,3,...,22],
    "chars": 198729,
    "alias": "...",   // 可選,短名稱
    "alt": "X0001 ..." // 可選,CBETA 其它編號
  },
  ...
]

Work — 一部經的完整資訊

取回一部經的元數據、分類、譯者/作者、AI 導讀(部級 + 卷級)與相關 URL。給 AI Agent「認識一部經」的單一入口。對只有目錄條目、未收錄全文的作品,返回 hosted: false 與 CBETA Online 連結,而非 404。

請求

GET https://deerpark.app/api/v1/work/:id

請求示例

GET https://deerpark.app/api/v1/work/T0235

返回示例

{
  "id": "T0235",
  "hosted": true,
  "title": "金剛般若波羅蜜經",
  "alias": "金剛經",
  "byline": "後秦 鳩摩羅什譯",
  "canon": "T",
  "canonName": "大正新脩大藏經",
  "category": "般若部",
  "juans": [1],
  "chars": 5191,
  "creators": [{ "id": "A001583", "name": "鳩摩羅什", "dynasty": "姚秦", "workCount": 54, "url": "..." }],
  "summary": "這部經記錄了佛在舍衛國祇樹給孤獨園與弟子須菩提的一場對話……",
  "juanSummaries": [],          // 多卷經會有 [{ "juan": 1, "summary": "..." }, ...]
  "urls": {
    "read": "https://deerpark.app/cbeta/T0235",
    "toc": "https://deerpark.app/api/v1/toc/T0235",
    "text": "https://deerpark.app/api/v1/text/T0235/1",
    "html": "https://deerpark.app/api/v1/html/T0235/1",
    ...
  }
}

Table of Contents — 經典目錄

取回某部經典的目錄。

請求

GET https://deerpark.app/api/v1/toc/:id

請求示例

GET https://deerpark.app/api/v1/toc/T0251

返回示例

{
  "juans": [
    {
      "file": "T08n0251",
      "lb": "0848c04",
      "juan": 1,
      "title": "第一"
    }
  ],
  "mulu": [
    {
      "indent": 1,
      "title": "般若波羅蜜多心經序",
      "juan": 1,
      "lb": "0848b19"
    }
  ]
}

Article in HTML — 經文 HTML

取回某卷經文的 HTML 版本。不帶卷號的 URL 會自動轉向該經的第一卷。少量經文帶有以 Data URI 形式嵌入的圖片。

請求

GET https://deerpark.app/api/v1/html/:id
GET https://deerpark.app/api/v1/html/:id/:juan

請求示例

GET https://deerpark.app/api/v1/html/T0251
GET https://deerpark.app/api/v1/html/T0251/1

返回示例

<!doctype html>
<html lang="zh-TW">
<meta charset=utf-8>
...
<title>般若波羅蜜多心經</title>

<article>
...
</article>

</html>

Article in Markdown — 經文純文字

取回某卷經文的 Markdown 純文字版本:去掉行號、標點標記與校勘錨點,章品標題轉為 Markdown 標題,偈頌轉為引用塊,頁尾附出處與閱讀連結。體積約為 HTML 的 1/15,適合 AI Agent 直接放入上下文。不帶卷號的 URL 會自動轉向該經的第一卷。

請求

GET https://deerpark.app/api/v1/text/:id
GET https://deerpark.app/api/v1/text/:id/:juan

請求示例

GET https://deerpark.app/api/v1/text/T0235/1

返回示例(Content-Type: text/markdown)

# 金剛般若波羅蜜經

*姚秦天竺三藏鳩摩羅什譯*

如是我聞:

一時,佛在舍衛國祇樹給孤獨園,與大比丘眾千二百五十人俱。……

> 一切有為法, 如夢、幻、泡、影,
> 如露亦如電, 應作如是觀。

---
來源:CBETA T0235《金剛般若波羅蜜經》
閱讀:https://deerpark.app/cbeta/T0235

Download — 下載 PDF / ePub / MOBI

CBETA 提供了三種格式的文件下載:PDF(適合 A4 打印)、ePub(開放格式,適合 Apple Books 等閱讀器)、MOBI(適合 Kindle)。

請求

GET https://deerpark.app/api/v1/download/:type/:id

請求示例

GET https://deerpark.app/api/v1/download/pdf/T0945
GET https://deerpark.app/api/v1/download/epub/T0945
GET https://deerpark.app/api/v1/download/mobi/T0945

Full Text Search — 在所有經中搜索

搜索結果最多返回 100 部經,無分頁功能。超過 100 個時,請增加搜索詞。

請求

GET https://deerpark.app/api/v1/fts/works/:term

請求示例

GET https://deerpark.app/api/v1/fts/works/一切有为法

返回示例

{
  "found": 864,
  "works": [
    {
      "search_results": 56,
      "id": "T1509",
      "title": "大智度論",
      "byline": "龍樹菩薩造 後秦 鳩摩羅什譯",
      "juans": [1,2,3,...],
      "chars": 956053
    },
    ...
  ]
}

Full Text Search — 在一部經中搜索

在指定的一部經中搜索,最多返回 100 個結果,按出現順序排序。

請求

GET https://deerpark.app/api/v1/fts/:id/:term

請求示例

GET https://deerpark.app/api/v1/fts/T0220/一切有为法

返回示例

{
  "found": 6,
  "results": [
    {
      "juan": 69,
      "lb": "0391a15",
      "paragraph": "...<mark>一切有為法</mark>非常非壞..."
    },
    ...
  ]
}

Dictionary Suggest — 佛學辭典搜索建議

佛學辭典內含五部辭典:《陳義孝佛學常見辭彙》、《法相辭典》、《三藏法數》、《丁福保佛學大辭典》、《佛光大辭典》。輸入簡體字會自動轉為繁體。最多返回 50 個結果。

請求

GET https://deerpark.app/api/v1/dict/suggest/:term

請求示例

GET https://deerpark.app/api/v1/dict/suggest/如來藏

返回示例

[
  "如來藏",
  "如來藏心",
  "如來藏緣起",
  "如來藏性",
  "如來藏經",
  ...
]

Dictionary Lookup — 佛學辭典查詢

精確查詢辭典詞條。搜索詞必須精確匹配,不提供簡繁轉換,建議使用上方 Suggest API 返回的結果作為搜索詞。

請求

GET https://deerpark.app/api/v1/dict/lookup/:term

請求示例

GET https://deerpark.app/api/v1/dict/lookup/如來藏

返回示例

{
  "word": "如來藏",
  "data": [
    {
      "dictid": 0,
      "dict": "陳義孝佛學常見辭彙",
      "expl": "<p>真如在煩惱中,攝藏如來一切果地上的功德...</p>"
    },
    ...
  ]
}

提示:在 URL 尾部加 ?html 可以得到簡易版網頁。