OpenAPI
REST 操作、参数、响应与错误。
开发文档
按明确限制开发，而不是依赖暗示的确定性
文档说明请求 schema、响应状态、证据、新鲜度、分页、额度和错误处理。
文档格式
Markdown
精简且便于机器读取的服务文档。
MCP
通过 Streamable HTTP 发现和调用工具。
协议状态：ARD 与 A2A Agent Card 已提供发现链接，但在实现前会有意返回机器可读 404。
推荐接入流程
先查询覆盖，再搜索实体并检查证据；只有任务需要时才使用到访判断或路线规划。研究资料包是确定性导出，不是自动生成的叙事。
- 使用搜索结果中的稳定 ID，不要从显示名称推导 ID。
- 将 complete、partial 和 unknown 当作领域状态。
- 把来源审核年龄与 HTTP 缓存年龄分开。
- 游标报告数据版本冲突时，从第一页重新开始。
错误必须可处理
语法、语义校验、认证、授权、实体未收录、版本冲突、大小限制、额度和依赖故障使用不同 HTTP 状态和稳定错误代码。
首版没有外部动作
六个公开工具只读取已发布记录或据此计算结果，不会购买、修改第三方系统或触发收费上游服务。