API v2.5.0只读
知识库 API 与 MCP
面向 AI 智能体与开发者的机器可读接口。无需 API 密钥即可搜索经核实的访客问答。
概览
Bonanza 知识库提供 REST JSON 与 MCP 工具描述。权威内容仅通过本站 canonical URL 发布；第三方来源不暴露在 API 中。
- 基础 URL:
https://caterkingdimsum.com - 文章数: 150 （10 类）
- MCP:
search_knowledge,get_article
快速开始
- 阅读发现索引： llms-knowledge.txt
- 搜索文章：
curl "https://caterkingdimsum.com/api/knowledge?q=parking&lang=en" - 获取单篇 Markdown：
curl "https://caterkingdimsum.com/api/knowledge/tour-bus-rv-parking?format=md&lang=en"
身份验证
公开只读端点，无需 API 密钥。请遵守合理使用频率（见下方 Rate limits）。
REST 端点
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/knowledge | 全文或 ?q= 搜索 |
| GET | /api/knowledge/{id} | JSON 文章 |
| GET | /api/knowledge/{id}?format=md | Markdown export |
| GET | /api/knowledge/mcp | MCP descriptor |
参数： q, lang (en|zh), format (md)
MCP 工具
服务器卡片： /.well-known/mcp/server-card.json
search_knowledge
按关键词搜索 KB（停车、营业时间、邮寄等）。
get_article
按 id 获取单篇 JSON 或 Markdown。
发现链
速率限制
请保持每秒不超过约 2 次请求，并为缓存响应留出间隔。批量任务请使用异步模式并避免高峰时段。
错误
- 200 — OK
- 404 — 未知文章 id