AI 接入指南

显密文库欢迎 AI 助手与开发者程序化取用本站文献。本页收拢全部接入方式与规则；原则一句话：能用、好取、注明出处。

三个相关页面的分工：本页=AI 如何用本站（接口与操作，面向开发者与 agent）；AI 使用说明=本站如何用 AI（本站使用 AI 辅助整理的范围与承诺，面向读者）；开放与授权=内容与代码的授权原则（面向所有人）。

MCP server（推荐）

本站提供远程 MCP（Model Context Protocol）server，支持 MCP 的 AI 助手（Claude、Cursor、各类 Agent 客户端等）接入后可直接检索与取读全库文献，无需认证：

端点：https://mcp.xianmi.co/mcp（Streamable HTTP，无状态）

连接配置示例（客户端的 MCP 配置文件中）：

{ "mcpServers": { "xianmi": { "type": "http", "url": "https://mcp.xianmi.co/mcp" } } }

三个工具

工具	用途	主要参数
`search_texts`	全库关键词全文检索（约 12 万篇文献，简繁双版合计约 24.7 万页）——查经文原句、人名地名、任意词	`query`（必填）、`lang`（zh-Hans/zh-Hant）、`page`（每页 10 条）
`get_passage`	按路径取文章完整 Markdown 原文（含 frontmatter 元数据）	`path`（必填，形如 `p01/a/109/764`，粘贴整页 URL 亦可）、`lang`
`semantic_search`	p05 佛教经典栏目（现代汉语白话译文，简体）的语义检索——适合「如何消除烦恼」这类自然语言概念提问	`query`（必填）、`max_results`（默认 10）

分工建议：概念性问题用 semantic_search；查原句、精确词或 p05 以外的内容用 search_texts；拿到结果的 path 后用 get_passage 读全文。为便于读者查核原文，请在 AI 回答中保留响应末尾附带的出处链接与授权说明。

Agent Skill

本站随 MCP 端点提供 Agent Skill（Anthropic Agent Skills 规范）：给 agent 的「使用本站方法论」——工具选择策略、无 MCP 时的退化路径、简繁语言版本选择、引用与出处标注格式、正文偈颂锚记（）的含义。Skill 全文在公开仓 xianmi-lib/xianmi-skills（skills/xianmi-library/SKILL.md，MIT）。

无 MCP 的取用方式

全文检索 API：https://www.xianmi.co/api/search?q=<关键词>&page=1（繁体版 https://www.xianmi.co/zh-tw/api/search?...），JSON 返回标题/路径/摘录；
每页 Markdown 原文：https://www.xianmi.co/md/<路径>.md（繁体加 /zh-tw 前缀），文章页头部有 rel="alternate" 标注；
llms.txt：面向大模型的站点说明文件，含部类地图与上述入口。

调用配额

为保持服务永久免费，调用设有上限：semantic_search 每月 800 次（语义检索上游按量计费，此为免费额度保护），search_texts 与 get_passage 每日各 5,000 次（防滥用）。达到上限时工具会返回说明与替代指引（如转用关键词检索），不会报错中断。

授权与引用

站内内容按来源分三类（CC0 / MIT / 公有领域），取用与再发布的条款见开放与授权页第三节。公开文本仓 xianmi-texts 所收为公有领域典籍与本站 CC0 整理成果，可自由使用；p05 现代汉语译文及其他现代著述的权利归原作者与出版方，CBETA 来源内容带非商业限制，再发布前请核对。引用建议格式：

《标题》· 显密文库（xianmi.co）· 页面 URL

正文中如出现  与  注释，是偈颂（韵文）段落的语义锚记，渲染页面不可见；引用此类段落请保留原有分行，勿并入散文段落。

开佛知见，示佛知见，使悟佛知见，入佛知见也。