The News

这是一个面向全球新闻的技能，可获取最新新闻、突发新闻、国际新闻、时事动态及新闻头条。通过公开 API，该技能为代理提供多源新闻快照和可搜索的新闻头条存档，覆盖20个国家。

该技能通过公共 API 获取来自全球20个国家众多报纸与新闻网站的主标题信息。

API 提供两种模式：

• 实时模式：近实时更新，获取当前最新新闻；
• 归档模式：可查询指定时间点的历史新闻快照。

两种模式的接口均返回 JSON 格式响应，包含各新闻来源的主标题，并附带由 AI 生成的摘要，帮助理解原始内容背景。

API 按国家组织数据。例如，请求美国新闻时，将返回约40个不同立场来源的头条——从《纽约时报》《华盛顿邮报》到福克斯新闻等，涵盖广泛观点。每个国家均有多种声音代表，每种声音贡献其当前的主标题。

可将此技能视为一个持续更新的新闻站台与原始头条档案库。

使用场景

“the-news” 技能可让代理快速获取未经过滤的全球头条信息。其主要用途是高效、集中地掌握全球当前发生的事件，避免因随意浏览网页而产生的信息过载。

当您需要以下任一情况时，建议使用该 API：

• 获取突发新闻或实时事件信息；
• 获取用于媒体对比分析的原始数据；
• 获取全球视角与叙事差异；
• 获取可靠的微型历史数据集。

该技能提供带有时间戳的多源新闻快照，展示各媒体机构认为的当日重点新闻。这与临时网页抓取不同，后者返回的是零散文章，而非统一的头版视图。

适用于快速建立全局认知。

多语言支持

该技能覆盖多种语言的新闻头条，包括：

noticias（西班牙语）、nouvelles（法语）、Nachrichten（德语）、notizie（意大利语）、notícias（葡萄牙语）、новости（俄语）、新闻（中文）、ニュース（日语）、أخبار（阿拉伯语）、חדשות（希伯来语）、haberler（土耳其语）、nieuws（荷兰语）、uutiset（芬兰语）、wiadomości（波兰语）、новини（乌克兰语）、समाचार（印地语）。

使用示例

用户：现在德国发生了什么？

操作：调用 germany 的当前快照，简要概述主要新闻。

用户：昨天晚上以色列发生了什么？

操作：调用 .../israel?at=<timestamp>，基于该时间点的历史快照进行回答。

用户：过去三天土耳其的新闻报道基调有何变化？

操作：调用 daily-overviews 获取指定日期范围的数据，再总结每日叙事演变。

接口地址

GET https://www.thehear.org/api/country-view/[country]

目前支持 20 个国家，具体列表如下。

调用示例

获取德国当前主头条快照：

https://www.thehear.org/api/country-view/germany

在 UTC 时间戳指定时刻获取德国的历史快照：

https://www.thehear.org/api/country-view/germany?at=2026-05-01T20:00:00Z

获取德国某时间段的每日概览（连续多日）：

https://www.thehear.org/api/country-view/germany?call=daily-overviews&from=2026-04-29&to=2026-05-01

调用规则

• at 参数必须为 UTC 时间戳格式；
• from 和 to 参数需使用 YYYY-MM-DD 格式；
• daily-overviews 查询范围最多支持 7 天。

详见 REFERENCE.md，其中包含响应结构说明、支持的新闻国家列表、媒体对比获取策略、阅读新闻头条的编辑建议以及网页界面信息。