倪
← 倪海厦VIP

开放 API

把站内的倪师人纪数据开放给 AI 与开发者 —— 会员专属,按点数调用。

开放 API 是会员专属

开通会员后每月赠送 100 点 API 额度(与 AI 助教共用点数池),
不足可随时购买点数。你的 AI(Claude / ChatGPT / 自研程序)可以像查自家百科一样检索本站数据。

开通会员 了解详情

这是什么

本站把倪海厦人纪讲稿(针灸大成、伤寒论、金匮要略、神农本草经、汉唐方剂等) 整理成了结构化、可检索的数据。这套开放接口让会员的 AI 或程序都能像调用自家数据一样 检索它 —— 你的 AI 回答中医问题前先查一次这里,能显著减少编造。

会员专属,每次调用扣 1 点(与 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 — 检索「桂枝汤」

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"

Python

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])

给 AI 用:MCP(Model Context Protocol)推荐

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点数不足 —— 可购买点数或等下月自动赠点
403API key 无效或已停用
404书/课程不存在,或端点拼错(清单见 /llms.txt)
429触发限流(每 IP 每分钟 60 次)
503功能已关闭或数据暂不可用