| name | tencent-news |
| description | 获取7×24 新闻资讯,聚焦中国国内信息和国际热点。支持热点新闻、早报晚报、实时资讯、新闻榜单、领域新闻、新闻主体查询。当用户需要搜新闻、查新闻、看热点、早晚报、订阅新闻推送、获取主题相关新闻资讯和最新消息时使用。 |
| description_zh | 7×24 新闻资讯,支持热点、早晚报、实时资讯、榜单、领域新闻及主体查询。 |
| description_en | 7×24 news with hot topics, briefings, rankings, and subject queries. |
| version | 1.0.1 |
| author | TencentNews |
| tags | ["news","tencent","headlines","briefings","news rankings","real-time updates"] |
| allowed-tools | Read,Bash |
腾讯新闻内容订阅
通过 tencent-news-cli 获取腾讯新闻内容。
核心原则:基础设施流程(安装、更新、Key 配置)交给脚本处理;智能体只负责选择 CLI 子命令和组合参数——始终先读 help,不要硬编码。
Workflow
所有平台统一通过 bun 运行 TypeScript 脚本,不依赖 Node.js、Python 或平台特定 Shell。
前置:确保 bun 可用
执行任何脚本之前,先检测 bun 是否可用:bun --version。若不可用,安装 bun:
macOS / Linux:
curl -fsSL https://bun.sh/install | bash
Windows:
powershell -c "irm bun.sh/install.ps1 | iex"
安装后若当前终端找不到 bun,需重启终端或手动刷新 PATH,再次 bun --version 确认。
-
运行状态检查
bun scripts/cli-state.ts
解析返回 JSON,重点关注 platform.cliPath、platform.helpCommand、cliExists、needsUpdateCheck、apiKey.present。
-
安装 CLI(cliExists 为 false 时)
bun scripts/install-cli.ts
若脚本失败,阅读 references/installation-guide.md。
-
更新 CLI(needsUpdateCheck 为 true,或 CLI 提示版本过旧时)
bun scripts/check-update.ts --apply
脚本内部通过 version 判断是否有新版本,有则下载覆盖,无则跳过。
-
配置 API Key(apiKey.present 为 false 时)
检查:bun scripts/api-key.ts
设置:bun scripts/api-key.ts --set KEY
- 解析返回 JSON 中
apiKey 部分,按以下优先级恢复 Key:
apiKey.present 为 true → Key 已在环境变量中,无需操作。
apiKey.present 为 false 且 apiKey.configFileHasKey 为 true → 直接复制 JSON 中 restoreCommand 的完整值并执行,将 Key 导入当前 Shell。示例:脚本返回 "restoreCommand": "export TENCENT_NEWS_APIKEY='eyJhbGci...'" 时,直接在终端执行:
export TENCENT_NEWS_APIKEY='eyJhbGci...'
原样执行 restoreCommand,不要修改或重新拼接。
apiKey.present 为 false 且 apiKey.configFileHasKey 为 false → 不要自动获取 Key,不要用工具打开浏览器,不要执行 open / xdg-open / start 等命令。 只需向用户输出以下引导文案,让用户自己操作:
请使用浏览器打开 API Key 获取页面 获取 Key
- 首次设置 Key:
bun scripts/api-key.ts --set KEY
- 设置后必须执行返回的
sessionCommand 让当前终端生效。不需要额外存入永久记忆。
- 详细配置与故障排查见
references/env-setup-guide.md。
-
执行 help
优先使用 platform.helpCommand;自行拼命令时确保正确引用 platform.cliPath,Windows 使用 PowerShell 调用形式。
-
根据 help 输出选择子命令执行,按下方 Output Format 输出结果。
Output Format
CLI 返回的每条新闻通常包含标题、摘要、来源、链接等字段。输出时必须按以下结构展示:
1. **标题文字**
来源:作者或媒体名称
摘要内容……
[查看原文](https://…)
2. **标题文字**
来源:作者或媒体名称
摘要内容……
[查看原文](https://…)
**来源:腾讯新闻**
- 标题:
序号. **标题**,序号从 1 开始,标题加粗。
- 来源:
来源: 后跟 CLI 返回的作者或媒体名称;CLI 无该字段时可省略。
- 摘要:来源下方紧跟;CLI 无摘要字段时可省略。
- 原文链接:如果有链接,则输出
[查看原文](URL),确保链接可点击,没有则不输出。
- 其他有价值字段(发布时间、标签等)可在来源下方补充。
- 多条新闻间用空行分隔。
- 列表末尾:所有新闻条目之后,另起一行加粗展示
**来源:腾讯新闻**。
CLI 执行失败处理
CLI 命令失败后,立即停止,绝不通过 WebSearch 或其他方式获取新闻作为替代。
- CLI 返回非零退出码、超时或输出含权限/安全错误时,不要重试,不要换方式。
- 根据错误信息判断原因并引导用户操作:
- macOS Gatekeeper(
cannot be opened、not verified)→ 系统设置 → 隐私与安全性 → 「仍要打开」→ 确认框「打开」
- 企业安全软件(
connection refused、防火墙拦截)→ 安全提示中点击「信任」/「允许」
- 权限不足(
permission denied)→ chmod +x <cliPath>
- 其他 → 展示完整错误,请用户处理
- 用户确认操作完成后再重试。即使多次失败,也只能告知用户无法获取新闻并说明原因,绝不回退到其他信息源。
Gotchas
- 所有平台统一通过
bun 运行 TypeScript 脚本,不依赖 Node.js 或 Python。
- 32 位架构不支持,脚本会直接报错。
- 不要缓存 CLI 的存在状态,每次查询前通过
cli-state 重新验证。
Scripts
| 脚本 | 功能 |
|---|
cli-state.ts | 输出安装状态、更新检查状态、API Key 状态 |
install-cli.ts | 下载当前平台 CLI 并验证 |
check-update.ts | 版本检查,带 --apply 时自动更新 |
api-key.ts | 检查或设置 TENCENT_NEWS_APIKEY |
References