把站内的倪师人纪数据开放给 AI 与开发者 —— 会员专属,按点数调用。
程序调用时在请求头加 X-Api-Key,浏览器同源调用自动走 Cookie。key 即会员身份,勿外传——泄露后他人调用扣的是你的点数。
开通会员后每月赠送 100 点 API 额度(与 AI 助教共用点数池),
不足可随时购买点数。你的 AI(Claude / ChatGPT / 自研程序)可以像查自家百科一样检索本站数据。
本站把倪海厦人纪讲稿(针灸大成、伤寒论、金匮要略、神农本草经、汉唐方剂等) 整理成了结构化、可检索的数据。这套开放接口让会员的 AI 或程序都能像调用自家数据一样 检索它 —— 你的 AI 回答中医问题前先查一次这里,能显著减少编造。
所有端点均为 GET,返回 JSON,须登录会员。
配额
| 方式 | 扣点 | 说明 |
|---|---|---|
| 浏览器(Cookie 自动携带) | 1 点 / 次 | 同源调用,与 AI 助教共用点数池 |
| 程序(X-Api-Key 头)推荐 | 1 点 / 次 | 会员中心生成 key,程序调用时加在请求头 |
另有限速:每 IP 每分钟 60 次(防打爆)。异常批量爬取会被限流。
| 端点 | 说明 |
|---|---|
GET /open/v1/search | 全站 BM25 检索。参数:q(必填)、top_k(默认 6,≤20)、book(限定某书 id)。返回最相关片段 + 书名/课名/出处。AI 回答中医问题前先查这个。 |
GET /open/v1/books | 全部书目:id、书名、课程数、是否会员书。 |
GET /open/v1/lessons | 某书课程目录。参数:book(书 id)。 |
GET /open/v1/lesson | 课文纯文本。参数:book、id(课程 id)。会员书未解锁部分只返回试读段落(口径与站内一致)。 |
GET /open/v1/acupoint | 穴位解析。参数:q(穴名/拼音/编号,如 足三里 / ST36)。需站主开启图谱 |
GET /open/v1/meridian | 经络循行与穴位列表。参数:id(全拼 zu_yang_ming_wei;缩写 st、中文名 胃经 亦可)。需站主开启图谱 |
GET /llms.txt | 本页的纯文本版(llmstxt.org 约定),供 AI 自动发现接口。 |
响应统一为 JSON:{"ok":true, ...};出错时带 error 字段与对应 HTTP 状态码(400/403/404/429/503)。
curl -H "X-Api-Key: nxk_你的key" "https://nihaixia.vip/open/v1/search?q=%E6%A1%82%E6%9E%9D%E6%B1%A4&top_k=3"
import urllib.request, urllib.parse, json
q = urllib.parse.quote("小柴胡汤")
req = urllib.request.Request(
f"https://nihaixia.vip/open/v1/search?q={q}&top_k=5",
headers={"X-Api-Key": "nxk_你的key"})
r = json.load(urllib.request.urlopen(req))
for it in r["results"]:
print(it["title"], "→", it["text"][:80])
Claude Desktop、ChatGPT 等支持 MCP 的 AI,可以直接「安装」本站数据当自己的工具。 下载零依赖的 mcp_server.py(纯 Python 标准库), 在 MCP 客户端配置里加:
{
"mcpServers": {
"nihaixia": {
"command": "python",
"args": ["/路径/mcp_server.py"],
"env": {
"NX_OPEN_BASE": "https://nihaixia.vip",
"NX_OPEN_KEY": "本页上方生成的会员 key(必填)"
}
}
}
}
装好后 AI 就多了这些工具:search_tcm(检索讲稿)、list_books / list_lessons / get_lesson(书目与课文)、 search_acupoint / get_meridian(经络穴位)。
| 状态 | 含义 |
|---|---|
| 400 | 缺少必填参数 |
| 401 | 未登录会员 / key 为空(浏览器登录后自动携带 Cookie) |
| 402 | 点数不足 —— 可购买点数或等下月自动赠点 |
| 403 | API key 无效或已停用 |
| 404 | 书/课程不存在,或端点拼错(清单见 /llms.txt) |
| 429 | 触发限流(每 IP 每分钟 60 次) |
| 503 | 功能已关闭或数据暂不可用 |