tgmeng-news-skill不是一个给普通用户直接浏览新闻的网站，也不是传统意义上的新闻客户端。它更像是一份给智能体读取的“接口说明书+调用规范”，作用是把糖果梦站内的新闻、热点、指数和日报数据，包装成外部Agent可以稳定调用的Skill。

从仓库说明看，这个项目面向龙虾、Hermes以及其他支持工具调用的智能体。它本身不保存业务数据，也不保存用户密钥，而是把糖果梦搜索接口整理成标准、清晰、稳定的调用契约。对开发者来说，它的重点不是“看新闻”，而是让AI工具能按规则查新闻。

tgmeng.webp

它解决的是接入问题

很多热点站点都有自己的数据、分类和接口，但外部智能体要真正调用这些能力，不能只靠一句“去查一下”。它需要知道接口地址、请求方法、参数格式、分类取值、分页规则、错误处理方式，以及什么时候应该调用哪一个能力。

tgmeng-news-skill做的就是这件事。它把糖果梦的热榜搜索、糖果指数、日报查询等能力写成Skill说明，并提供OpenAPI定义和中文接口契约。这样智能体在执行任务时，不是临时猜参数，而是按文档组织请求。

三个核心能力

仓库README中把当前Skill的核心能力分成三类。第一类是热榜数据搜索，可以按密钥、关键词数组、查询模式、时间窗口和根分类检索糖果梦站内新闻与热点数据。第二类是糖果指数查询，可以按关键词和分类查看对应热点榜单。第三类是日报数据查询，可以按日期、日期范围和分类读取已经生成好的糖果梦日报，并可返回正文Markdown。

这三类能力覆盖了不同使用场景。想看最新热点，用实时热榜；想看某个主题的热度变化，用糖果指数；想整理某天的新闻摘要或内容素材，用日报查询。对智能体来说，这比直接抓网页更稳定，也更容易控制返回结构。

查询模式分得很细

热榜搜索接口里有三个查询模式：REALTIME、TODAY和HISTORY。REALTIME用于实时数据，关键词可以传空数组来获取当前全量热榜；TODAY用于今日持久化历史数据；HISTORY用于长期历史数据查询。

这种设计比较适合Agent场景。用户说“现在有什么热点”，和用户说“查一下上个月OpenAI相关热点”，背后不是同一个查询逻辑。Skill把模式区分清楚，可以减少智能体误用接口，也能让返回结果更贴近用户问题。

关键词不是简单匹配

tgmeng-news-skill的关键词设计比较灵活。多个关键词项之间是OR关系，例如同时查“AI”和“OpenAI”；单个关键词项内部还支持轻量表达式，比如用+、&表示必须包含，用-、!表示排除。

这对新闻检索很实用。热点标题常常很短，如果只能简单搜一个词，结果容易太宽。比如查“黄金+伊朗-足球”，就能要求标题同时包含黄金和伊朗，并排除足球相关内容。智能体在整理新闻时，可以用这种方式把噪音先筛掉一部分。

分类适合做专题

README里列出了热榜根分类，包括新闻、羊毛、媒体、电视、生活、社区、财经、股讯、体育、科技、设计、影音、游戏、健康、教育、期货、AI、副业等。调用时可以通过rootCategories缩小范围。

这让它不只是一个泛泛的热榜查询Skill。比如做AI日报，可以筛AI分类；做财经观察，可以筛财经或股讯；做内容选题，可以关注副业、科技、生活等分类。对于站内文章、公众号选题、短视频脚本和信息流选题来说，分类过滤比全量热榜更容易落地。

糖果指数看热度

糖果指数接口用于查询综合热点、分类热点和对应热度指数。返回结果中包含标题、分类、更新时间和hotScore等字段，数值越大表示热度越高。

这类能力适合做“今天什么最热”“某个分类里哪些话题更值得看”这样的判断。热榜搜索更像原始新闻检索，糖果指数更像热度排序入口。两者结合起来，智能体既能找到内容，也能判断优先级。

日报接口更像素材库

日报数据查询接口可以按日期、日期范围和分类查询已经生成好的糖果梦日报。如果需要正文，可以通过withContent返回Markdown内容；如果只看列表或元数据，也可以不返回正文。

这个能力适合内容整理和复盘。比如用户想看某一天的科技日报、AI日报，或者想把一段时间内的热点做成学习材料，日报接口比一条条查热榜更省事。对Agent来说，Markdown正文也更适合后续改写、摘要、归档或二次排版。

图床接口是额外补充

README后半部分还写了图床上传API，用于给PicGo、三方客户端、脚本或智能体上传图片和文件，并返回公开链接、Markdown、HTML和批量结果。它要求通过请求头传入糖果梦通用密钥，并使用稳定机器码做设备绑定。

这部分不属于最开头列出的三项核心新闻能力，但对内容工作流有补充价值。新闻日报、热点汇总、图文发布，经常会遇到图片托管和Markdown外链问题。把图床上传也写进Skill契约里，说明这个项目并不只考虑数据查询，也在考虑内容生产后的发布链路。

它对密钥很谨慎

项目说明中多次强调：Skill不保存、不写死用户密钥，外部智能体应通过运行时参数、环境变量或用户输入传入密钥。没有密钥时，可以引导用户前往糖果梦相关页面获取通用密钥。

这点很重要。新闻接口看起来不像支付接口那么敏感，但密钥仍然代表调用权限。尤其是TODAY、HISTORY、图床上传等能力，可能涉及更高权限或设备绑定。如果智能体把密钥写进日志、回复或仓库，就会带来不必要的风险。

版本检查很细

tgmeng-news-skill还设计了远程版本检查机制。SKILL.md中声明了版本号和远程版本清单地址，智能体执行前如果网络可用，应读取远程清单，比较本地版本是否落后，并在需要时提醒用户更新。

这类细节说明它不是随便写的一份提示词，而是按长期维护的Skill包来设计。接口字段、分类值、权限规则、错误提示都会变化，如果没有版本检查，Agent很容易拿着旧说明去调用新接口，最后报错还不知道原因。

使用时要看清边界

tgmeng-news-skill适合给智能体接入新闻、热点、日报和图床能力，不适合被理解成“自动新闻发布系统”。它负责查询和返回结构化数据，后续怎么筛选、怎么判断真实性、怎么写成文章、怎么发布，还需要调用方自己处理。

新闻和热点内容尤其需要人工判断。热点不等于事实完整，热度高也不等于值得传播。如果用它做站内文章、公众号日报或选题推荐，最好增加来源核对、事实检查和人工审核，不要把接口返回直接当成最终内容发布。

适合谁来接入

这个Skill更适合已经在做Agent工作流的人，比如AI助手开发者、内容自动化系统、新闻监控工具、日报生成工具、热点选题工具，以及需要把糖果梦数据接进内部流程的团队。

如果只是普通用户偶尔看看新闻，直接访问对应网站可能更简单。如果你的需求是“让AI定期查热点、按分类整理日报、根据关键词检索历史新闻、再生成摘要或选题建议”，tgmeng-news-skill就更有意义。它的价值在于把新闻数据从网页浏览变成可调用能力。

参考资料来源

本文参考了tgmeng-news-skill的GitHub仓库README、SKILL.md说明、接口参数、能力选择建议和安全要求。由于Skill版本、接口分类、权限规则和返回字段可能持续变化，实际接入时建议以官方仓库页面为准。

GitHub仓库：https://github.com/tgmeng-com/tgmeng-news-skill

README页面：https://github.com/tgmeng-com/tgmeng-news-skill/blob/main/README.md

SKILL.md源码：https://github.com/tgmeng-com/tgmeng-news-skill/blob/main/SKILL.md

OpenAPI契约：https://github.com/tgmeng-com/tgmeng-news-skill/blob/main/references/openapi.yaml