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 時的退化路徑、簡繁語言版本選擇、引用與出處標註格式、正文偈頌錨記（<!-- verse:* -->）的含義。Skill 全文在公開倉 xianmi-lib/xianmi-skills（skills/xianmi-library/SKILL.md，MIT）。

無 MCP 的取用方式

• 全文檢索 API：https://www.xianmi.co/zh-tw/api/search?q=<關鍵詞>&page=1（簡體版 https://www.xianmi.co/api/search?...），JSON 回傳標題/路徑/摘錄；
• 每頁 Markdown 原文：https://www.xianmi.co/zh-tw/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

正文中如出現 <!-- verse:... --> 與 <!-- /verse --> 註釋，是偈頌（韻文）段落的語義錨記，渲染頁面不可見；引用此類段落請保留原有分行，勿併入散文段落。