AI、Agents 與公開資料

探索檔同匿名讀取規格

poppy.json 嘅標準欄位包括 protocol_version、organization 同 web: {}。本站只提供普通未登入網站探索，唔會建立 Poppy Session，亦未提供協議授權登入、代理對話或遠端 MCP 服務。

公開資料入口放喺本站自訂擴充 extensions["canread.bible/public-data"]，版本 "1"：guide 係本指南；catalog 係章節目錄；readingCatalog 係歷史譯本目錄；openapi 係只讀規格；licenses 係授權資料；anonymousReadPolicy 說明讀取方式。呢啲唔係協議標準 API 欄位；唔認識擴充嘅客戶端可以忽略佢，繼續用普通 HTTPS 讀取。

協議仍係草案；範圍見官方規格。本站嘅匿名 OpenAPI 唔列入需要 Session Token 嘅標準 apis 欄位。

粵語經文：優先跟隨目錄嘅章節 JSON

版本 ID yue、語言 yue-Hant-HK，係香港粵語譯文，唔係普通中文改用粵音朗讀。先讀 catalog，再用該章提供嘅 json、text 同 url。唔好由章數推斷未發布內容。

GET /data/catalog.json
# 目錄目前列出嘅章節例子
GET /data/yue/mark/1.json
GET /text/yue/mark/1.txt
GET /bible/mark/1/

HTML 正文毋須 JavaScript，適合查閱上下文同註解。JSON 各版本嘅可選欄位可以不同；讀取原有欄位，保留版本及授權資訊。

歷史譯本：先確認公開版本同章節

動態目錄嘅 editions 列出公開章節，書卷可用章次以 chapterCount 或 available 為準。sourceEditions 如有項目，只跟隨佢嘅來源入口，唔好假設有逐節 JSON。

GET /api/reading-catalog.php
GET /api/editions.php?book=MRK&chapter=1
# 使用回應提供嘅 jsonURL，或目錄中嘅實際 ID
GET /api/chapter.php?edition=<public-id>&book=MRK&chapter=1

book 用目錄嘅書卷代碼，chapter 用整數；查詢可讀版本時一併提供兩者。閱讀入口見歷史譯本目錄。401 代表需要授權，404 代表內容未提供，503 代表暫時不可用；唔好繞過登入或補寫內容。

部分 AI OCR 版本嘅分節同標點未必可以自動辨認，可能有錯。有啲記錄係段落錨點或節號範圍；保留 verse、verseRange、sourceVerseId 同疑點欄位嘅原有意思，唔好虛構拆成獨立經節。整本下載只跟隨公開頁實際提供、授權允許嘅連結。

可靠讀取同引用

1. 讀目錄，揀實際公開嘅版本、書卷同章節。
2. 按提供嘅 JSON／TXT URL 取文；需要上下文或註解時讀 HTML。
3. 保存版本 ID、名稱、語言、章節、原有節號或範圍、正文、來源 URL 同授權。
4. 引用唔同譯本時分開標示；唔好把模型生成文字標示成本站譯文。

使用低並行度、合理逾時同回應大小上限；遵守 HTTP 快取標頭。遇到 429／503，按回應提供嘅 Retry-After 等候，冇提供時逐步延長重試間隔。呢個係客戶端讀取建議，唔代表本站承諾固定速率限制。

只讀公開及授權允許嘅內容，唔存取管理、草稿、內部校對或私人研究資料。用網站地圖同目錄發現頁面；搜尋介面係網頁功能，未提供獨立文字搜尋 API。

目前閱讀頁嘅瀏覽器工具

支援 WebMCP 嘅瀏覽器環境可用 read_current_passage 讀目前粵語經文、set_comparison 切換本地對照、configure_teleprompter 設定提詞器。佢哋只操作目前閱讀頁，唔係遠端 MCP 伺服器；批量讀取請用目錄及章節資料。

按版本保留授權同來源

本站原創粵語譯文、譯註及介紹文字，除另有註明外，自 2026 年 10 月 6 日起採用 CC BY-NC-SA 4.0。署名列明「粵讀聖經 · Can Read Bible」、經文位置、來源網址同任何修改。

第三方版本各按自己條款；例如 OCCBT 採用 CC BY-SA 4.0。歷史文獻、原文底本及其他第三方內容唔會因收錄而改用本站原創授權。見授權 JSON同完整說明。

正式入口：canread.bible。若資料入口更新，以目前目錄及頁面 canonical 為準；保留原版本資訊同引用來源。