地址和认证
| MCP | https://agent.maixiaoya.com/mcp | Streamable HTTP,无状态;2026-07-28 和 2025 两代协议都接 |
|---|---|---|
| 认证 | Authorization: Bearer myb_live_… | 在工作台的「应用接入」里为每个 AI 应用建一把,只显示一次 |
| 限速 | 每把 Key 60 次/分钟,每个企业 300 次/分钟 | 超了是工具错误 rate_limited,带 retry_after(秒) |
各工具的数据来源见下表。每条结果都会注明来源和查询时间。
开通和点数
- 先申请内测,开通以后登录,进的就是工作台。
- 在工作台做企业认证:填企业全称、统一社会信用代码、法定代表人、联系人,上传营业执照。
- 审核通过后,企业自动开通试用点数,你成为企业的所有者,可以邀请同事。
- 在「应用接入」里选你在用的 AI 应用,照步骤接上。
接 MCP
在 AI 助手或智能体的 MCP 配置里加一条(不同客户端的写法略有差别,关键是地址和 Authorization 请求头):
{
"mcpServers": {
"maiyabang": {
"url": "https://agent.maixiaoya.com/mcp",
"headers": { "Authorization": "Bearer 你的 Key" }
}
}
}Claude Code 用命令添加,Cherry Studio、Dify 在界面里逐项填,各家怎么填见接入方式。
连上以后,模型会看到下面的工具,以及一段使用规矩:先锚定是哪一家企业,要花钱的先问用户,只说「查到登记记录」,不说「没问题」。
工具清单
| 工具 | 做什么 | 点数 | 试查参数 |
|---|---|---|---|
lookup_ 查药品批准文号 | 按批准文号查药品的登记记录、品种状态和有效期 京源登记数据 | 10 | drugcode 国药准字Z43020255 |
lookup_ 查医疗器械注册证 | 按注册证编号或备案编号查医疗器械的注册记录 京源登记数据 | 10 | instrumentcode 国械注准20243010222 |
lookup_ 查化妆品注册备案 | 按注册证号或备案编号查化妆品的注册备案记录 京源登记数据 | 10 | cosmeticcode 国妆特字20259223 |
lookup_ 查医疗机构 | 按名称或机构编号查医疗机构的执业登记 京源登记数据 | 10 | name 中国医学科学院北京协和医院 |
lookup_ 查企业许可证和备案 | 查药品、器械、化妆品生产经营企业的许可证或备案 京源登记数据 | 10 | entname 北京同仁堂股份有限公司 |
list_ 查企业资质证书 | 列出企业名下的资质证书,可以按类型和是否有效筛 京源登记数据 | 10 | key 北京同仁堂股份有限公司 |
lookup_ 按编号查资质证书 | 按证书类型和编号查一张资质证书 京源登记数据 | 10 | cert_type 食品经营许可证cert_no JY31101012169813 |
lookup_ 查互联网药品信息服务证书 | 查互联网药品信息服务资格证书和对应网站 京源登记数据 | 10 | certno (粤)—非经营性—2023—0165 |
lookup_ 查医疗器械网络销售备案 | 查企业的医疗器械网络销售备案和网站 京源登记数据 | 10 | entname 阿里健康大药房医药连锁有限公司 |
lookup_ 查网站 ICP 备案 | 按单位名称、统一社会信用代码或网站域名查 ICP 备案 京源登记数据 | 10 | key baidu.com |
lookup_ 查企业登记信息 | 按企业名称或统一社会信用代码查工商登记信息 京源登记数据 | 20 | key 北京同仁堂股份有限公司 |
lookup_ 查企业经营异常(按次计费) | 查企业是否在经营异常名录里,以及列入和移出记录;按次扣点,要先确认 京源登记数据 | 50先确认 | key 北京同仁堂股份有限公司 |
list_ 查企业商标 | 列出企业名下的商标,可以按分类和状态筛 京源登记数据 | 20 | key 北京同仁堂股份有限公司 |
get_ 查商标详情 | 按商标查询号查商标的商品服务、专用权期限和流程 京源登记数据 | 20 | mark_key 85558609 |
list_ 查企业专利 | 列出企业名下的专利,可以按类型和申请号筛 京源登记数据 | 20 | key 北京同仁堂股份有限公司 |
list_ 查企业著作权 | 列出企业名下登记的软件著作权和作品著作权 京源登记数据 | 20 | key 北京同仁堂股份有限公司 |
list_ 查老字号 | 查企业名下的中华老字号和省级老字号 京源登记数据 | 20 | entname 中国北京同仁堂(集团)有限责任公司 |
verify_ 核对证号和持有人 | 按证号核对登记记录、持有人是否一致和有效期 京源登记数据 | 10 | number 国药准字Z43020255 |
check_ 校验证照上读出的字段 | 按国标和证号写法校验从证照上读出的信用代码、证号和日期,不查记录、不扣点 固定规则校验 | 0 | creditcode 91110000MA00000A9Plicence_kind 药品经营许可证licence_no 京AA010000001 |
get_ 查本企业的点数和用量 | 查本企业的点数余额和近几天的调用、扣点,不扣点 账户用量账本 | 0 | days 7 |
返回格式
「查没查到」(match)和「在不在有效期」(validity)分开写。同名多家时 status 是 candidates,只给候选,不扣点;让用户选定后用统一社会信用代码重查。工具的结果里,structuredContent 含数据来源(source)、原查询时间(queried_at)和演示标记(demo)。content 里是一句结论,后面跟着同样的 JSON。下面用一条演示记录展示格式。
{
"status": "ok",
"tool": "lookup_drug",
"match": "matched",
"record": { "批准文号": "国药准字H20990001", "品种状态": "正常", "有效期至": "2030-04-15", … },
"validity": { "state": "valid", "basis": "有效期至 2030-04-15" },
"source": "麦芽帮 · 非官方数据,以官网为准",
"demo": true,
"demo_notice": "演示数据,不代表真实查询结果",
"queried_at": "2026-11-09T14:30:00.000+08:00",
"cached": false,
"notice": "这是登记记录的核对结果,不代表质量判断或用药建议。…",
"usage": { "points": 10, "balance": 9990 },
"trace_id": "6f1c…"
}错误码
连接这一层出错(没带 Key、Key 不对、企业停用、认证失败太多次)回 HTTP 状态码,响应体是 {code, message, trace_id}。调工具时出的错是工具错误:结果里 isError 为真,structuredContent 是同样的 {code, message, trace_id};参数不合工具的 inputSchema 时,MCP 直接回工具错误,只有一段说明哪个参数不对的文字。点数不够、没开通、被限速都是工具错误,不会回 401/403,客户端不会反复去授权。
| code | 怎么回 | 什么时候 |
|---|---|---|
| unauthorized | HTTP 401 | 没带 Key,或 Key 无效、已作废、已过期 |
| forbidden | HTTP 403 | 所在企业的账号已停用 |
| rate_limited | HTTP 429、工具错误 | 认证失败太多次(HTTP 429),或调用太快(工具错误);看 retry_after(秒) |
| invalid_input | 工具错误 | 参数不对,或 confirm_token 对不上、已过期 |
| quota_exhausted | 工具错误 | 企业的点数不够了 |
| entitlement_required | 工具错误 | 企业还没开通试用点数 |
| source_unavailable | 工具错误 | 数据源暂时不可用,没有扣点 |
| confirmation_required | 不算错误 | 按次计费的查询:第一次只回报价和 confirm_token(status 是 confirmation_required) |
扣点规则
- 有结论才扣:查到、没查到都算结论。
- 同名多家只给候选,不扣;用户选定后重查的那一次扣。
- 同一个企业、同样的参数,10 分钟内再查,返回缓存结果,不扣,并标出原来的查询时间。
- 参数错、被限速、点数不够、数据源出错,都不扣。
- 经营异常按次计费:第一次只报价,带 confirm_token 确认后才扣。令牌 10 分钟有效,只能用一次。