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 为准；保留原版本资讯同引用来源。