热点新闻追踪指南
能力说明
通过 gnomic CLI 工具接入今日头条数据源,支持两种使用方式:
- 获取热榜:实时拉取头条热榜 Top 50,含热度值和跳转链接
- 关键词搜索:搜索指定话题的相关新闻,含摘要、媒体来源和分类标签
使用方式
获取今日头条热榜
gnomic news hot
JSON 输出结构:
{
"success": true,
"data": {
"code": 200,
"data": {
"name": "toutiao",
"type": "热榜",
"total": 50,
"updateTime": "2026-04-02 09:49:17",
"link": "https://www.toutiao.com/",
"data": [
{
"index": 0,
"title": "热点标题",
"hot_value": "34480552",
"image_url": "封面图片URL",
"url": "https://www.toutiao.com/trending/xxxxx/",
"mobilUrl": "移动端链接"
}
]
}
}
}
data.data.data 为热榜条目数组,按 index 升序排列(0 = 最热),hot_value 为热度数值字符串,数值越大越热。
关键词搜索新闻
gnomic news search "<关键词>"
示例:
gnomic news search "人工智能"
gnomic news search "A股"
JSON 输出结构:
{
"success": true,
"data": {
"news": [
{
"title": "文章标题",
"summary": "文章摘要",
"media_name": "媒体名称",
"time": "2026-04-02 09:00",
"cover": "封面图片URL",
"url": "文章链接",
"categories": ["news_tech/artificial_intelligence", "news_tech"]
}
]
}
}
data.news 为搜索结果数组,categories 为头条内部分类标签,media_name 为发布媒体。
文本格式输出
gnomic news hot -f text
gnomic news search "关键词" -f text
操作流程
判断使用哪条命令
| 用户意图 | 使用命令 |
|---|
| 看热榜/热搜/今日大事 | gnomic news hot |
| 搜索某个话题/关键词 | gnomic news search "<关键词>" |
获取热榜后的展示方式
从 data.data.data 数组提取条目,推荐格式:
🔥 今日头条热榜(更新时间:updateTime)
1. [标题](url) 热度:hot_value
2. [标题](url) 热度:hot_value
...
index + 1 为排名
hot_value 可格式化展示(如 34,480,552)
- 如需展示封面图,使用

搜索新闻后的展示方式
从 data.news 数组提取条目,推荐格式:
📰 「关键词」相关新闻
标题(来源:media_name|时间:time)
摘要内容...
🔗 url
注意事项
- 热榜数据实时拉取,
updateTime 为最近一次更新时间
- 搜索结果按相关性排序,条数不固定,通常 5~10 条
categories 字段为头条内部分类编码,无需展示给用户
- 请求通常在 2~5 秒内返回
补充:命令不可用时
如果执行 gnomic 命令时提示找不到命令,说明 gnomic-cli 尚未安装,执行以下命令安装:
npm install -g gnomic-cli
gnomic-cli开源地址:https://github.com/huyi9531/gnomic_cli