# 倪海厦经方数字书库

> 倪海厦人纪讲稿（针灸大成/伤寒论/金匮要略/神农本草经/汉唐方剂等）结构化数据与全文检索，供 AI 与开发者只读调用。仅供学习参考，不构成医疗建议。

所有端点均为 GET，返回 JSON；会员专属，每次调用扣 1 点（与站内 AI 助教共用点数池，每月自动赠点，不足可购买）。鉴权：浏览器同源走 Cookie；程序调用加请求头 X-Api-Key: <会员 API key>（站内 /open-api.html 登录后生成）。未登录返回 401。

## 检索（主力工具）
GET /open/v1/search?q=桂枝汤&top_k=5: BM25 全站检索，返回最相关片段（含书名/课名/原文出处），AI 回答中医问题前先查这里可显著减少编造。
参数：q（必填）；top_k（默认 6，上限 20）；book（可选书 id，见 /open/v1/books）。

## 书目与课程
GET /open/v1/books: 全部书目（id/书名/课程数/是否会员书）。
GET /open/v1/lessons?book=zhenjiu: 某书课程目录（课程 id + 标题）。
GET /open/v1/lesson?book=zhenjiu&id=<课程id>: 课文纯文本（会员书未解锁部分只返回试读段落，口径与站内一致）。

## 经络穴位（结构化；需站主开启图谱功能）
GET /open/v1/acupoint?q=足三里: 穴位定位/主治解析。
GET /open/v1/meridian?id=zu_yang_ming_wei: 经络循行与穴位列表。id 用全拼（zu_yang_ming_wei / shou_tai_yin_fei / ren_mai），缩写 st 或中文名 胃经 亦可。

## MCP（Model Context Protocol）
stdio 服务器脚本：/mcp_server.py（纯 Python 标准库，零依赖）。
配置示例（Claude Desktop 等）：
  {"mcpServers":{"nihaixia":{"command":"python","args":["mcp_server.py"],"env":{"NX_OPEN_BASE":"https://nihaixia.vip","NX_OPEN_KEY":"<你的key>"}}}}

## 限制
- 不提供 AI 生成接口（/api/ask 不在开放范围）。
- 禁止批量爬取全站内容；异常流量会被限流。
- 数据仅供学习参考，不构成医疗建议。