常见问题
空结果、连接失败、时间和数据完整性。
为什么没有搜到某条新闻？
先检查覆盖范围和新鲜度，再换短关键词、语言和时间窗口。未收录不代表没有发生，参见检索技巧。
REST 需要登录吗？
公开 GET 无需 token。MCP 使用 OAuth 授权；管理同步不是公开功能。遇到 429 请等待 Retry-After 指定时间。
MCP 连接失败？
确认地址是站点的 /mcp，不是 /api/search。未登录时 /mcp 返回 401，这是正常的 OAuth 发现流程，客户端会引导你登录。授权过期或 token 交换失败时，在客户端里断开后重新连接。OAuth 必须使用同一个站点域名。
Skill 能代替 MCP 吗？
Skill 提供方法，MCP 提供工具。Skill 的 REST 脚本需要客户端支持 shell 和 curl；仅上传指令不会增加网络权限。
时间用哪个时区？
API 输出 UTC ISO8601。无时区的查询时间按 UTC 解析；展示或回答时换算用户时区并注明（中文用户通常用北京时间 UTC+8）。
能得到公告全文或付费正文吗？
公告只有标题级别元数据与 PDF 链接；付费或截断内容标记 is_partial。不完整材料不能支撑没有出处的额外结论。
健康状态怎么看？
consecutive_failures 大于 0 时看 last_error；last_success_at 为空表示从未成功。gap / possible_gap 涉及目标时间时，应提醒可能缺漏。ok_empty 表示上游返回了合法空结果，不等于解析失败。