# 中华古籍文库 cn.jic.io

> 公版中国古籍全文库，面向 agent 开放：殆知阁十藏 15694 种古籍（约 20 亿字，简体）、
> CBETA 电子佛典 4882 部（繁体，带卷与页栏行号）、历代诗词 344270 首。
> 全部公版内容无需登录、无密钥、无配额申请，所有接口 CORS 允许任意来源，响应可缓存。

## 两种接入方式

- HTTP JSON：`GET https://cn.jic.io/api` 返回自描述的接口清单，读这一份即可用全库。
- MCP（Streamable HTTP，无状态）：`https://cn.jic.io/mcp`。
  Claude Code：`claude mcp add --transport http jic https://cn.jic.io/mcp`
  工具：search_fulltext、search_title、semantic_search、read_text、book_info、browse、
  resolve_cbeta、author、classify、poem、library_overview。

## 路径约定

每部书有唯一 path：「藏/子目录/书名.txt」，例如 `史藏/正史/史记.txt`、
`CBETA/大正藏/般若部类/T0235 金刚般若波罗蜜经.txt`。同一 path 对应：

- 整本原文：`/t/<path>`（text/plain，gzip，永久缓存）
- 著录信息：`/api/book/<path>`
- 正文切片：`/api/text/<path>?offset=0&limit=20000`（十藏）或 `?juan=7`（CBETA）
- 阅读页：`/book/<path 去 .txt>`（给人看的页面，引用时附上）

藏名：易藏、儒藏、道藏、佛藏、子藏、史藏、诗藏、集藏、医藏、艺藏、CBETA。

## 常用步骤

1. 找书：`/api/find?q=史记` → books[].path
2. 看著录与体量：`/api/book/史藏/正史/史记` → chars、juans（CBETA）、how_to_read
3. 读正文：`/api/text/史藏/正史/史记?offset=0&limit=20000` → text、next_offset；
   加 `&format=txt` 直接得纯文本。
4. 查一句话出自哪里：`/api/search?q=元亨利贞&limit=10` → results[].snippets（pre/hit/post）、
   hits、juan、lb（CBETA 行号）、text_url。candidates_total 为候选总数，用 offset 翻页。
   `canon=史藏` 或 `canon=CBETA/大正藏` 限定范围；`verify=0` 只要候选清单。
5. 佛典按意思找段落：`/api/sem?q=如何对治嗔恚&c=T`
6. 经号直达：`/api/cbeta/T0235`、`/api/cbeta/T0262_007`、`/api/cbeta/T08n0235_p0749a05`
7. 撰者与分类：`/api/people?q=朱熹`、`/api/people/朱熹`、`/api/class`、`/api/class/sibu/易类`
8. 诗词：`/api/poem/12345`

## 文本须知

- 十藏为简体，CBETA 为繁体。全文检索查询时繁简、异体自动归一，正文不转换。
- CBETA 正文每卷以 `#J<卷号>` 起行，每行形如 `T08n0235_p0749a05║正文`；`plain=1` 可去掉行号前缀。
  缺字以 `⟦|CB12345⟧` 标记，字形图在 `/gaiji/CB12345.gif`。
- 十藏文本系多年网络协作录入，未经系统校勘，引用前请核对权威底本。

## 许可

- 十藏：公版文献，数据源自 daizhigev20（https://github.com/garychowcmu/daizhigev20）。
- CBETA：CC BY-NC-SA 3.0 TW，须署名 CBETA、不得商用、派生内容以相同许可共享。
- 诗词：chinese-poetry（MIT），原文为公版。
- 《道祕天书》为当代著作，经授权仅向 JIC 会员提供，不在开放接口内。