Whale Data Center 外部文档
外部文档面向数据消费方，说明 Whale 当前覆盖哪些平台、能够获取哪些类型的数据，以及如何通过授权 API 查询和获取数据。这里关注“能查什么、怎么查、结果如何理解”，不展开内部采集、入库和运维实现。
采集器注册、能力声明、任务下发、入库协议、内部 OpenAPI 和运维管理属于受保护的内部工程资料，不在外部站点展示。
推荐阅读路径
| 顺序 | 页面 | 适合角色 | 解决的问题 |
|---|---|---|---|
| 1 | 快速开始 | API 接入方 | 使用应用密钥完成第一个查询 |
| 2 | Portal 与订阅 | 组织管理员、开发者 | 应用如何获得订阅、密钥和访问范围 |
| 3 | 平台覆盖 | 产品、数据使用方、售前 | 当前支持哪些平台、内容类型和字段口径 |
| 4 | 数据获取 | API 接入方、数据工程 | 如何检索、过滤、读取详情、理解版本和快照 |
| 5 | 生产调用规范 | 开发与运维 | 超时、重试、限流和兼容约束 |
| 6 | MCP 接入 | AI 应用开发者 | 将 Whale 检索能力接入 MCP Host |
| 7 | 公开 API Reference | 开发者 | 在线查看消费查询接口和 Schema |
文档模块
| 模块 | 说明 |
|---|---|
| 平台覆盖 | 当前支持的平台、内容类型、通用字段和平台差异映射 |
| Portal 与订阅 | 组织、应用、平台分配订阅、应用密钥和用量 |
| 数据获取 | 应用如何通过 API Key 查询、检索和获取授权数据 |
| 版本与快照 | 正文变更、字幕变更、指标变化如何读取 |
| 统计维度 | 平台、数据集、内容类型、时间窗口、指标口径如何理解 |
外部消费方不需要了解采集器如何注册、任务如何下发、数据如何入库，也不需要直接访问数据库、对象存储、OpenSearch、Milvus 或内部队列。
能力边界
| 能力 | 对外说明 |
|---|---|
| 平台覆盖 | Whale 会按平台枚举返回统一数据，并保留平台特有字段 |
| 关键词检索 | 支持精确词、品牌、人名、URL、话题等确定性召回 |
| 语义检索 | 支持相似语义、跨语言和弱关键词场景 |
| 混合检索 | 推荐默认使用，融合关键词、向量、质量和时效 |
| 详情读取 | 可按 document_id 读取完整内容、版本、片段、事实和快照 |
| 统计观察 | 可按授权范围查看数据量、平台分布、指标趋势和处理状态 |
文档维护边界
- 外部文档只描述平台覆盖、数据获取方式、授权边界和结果语义。
- 外部文档不展示采集器 API key、内部任务、数据库、对象存储、队列或采集排障细节。
- 公开 API Reference 从主 OpenAPI 自动筛选消费读取接口；完整 OpenAPI 仅供内部团队使用。