by 详细分析 ▾
运行时依赖
版本
theshort-news 技能首次发布，支持实时、限定范围的新闻搜索与摘要。 - 通过 API 提供经身份验证的 theshort.ai 精选新闻访问。 - 支持按主题与标签检索新闻流，并可获取文章详情。 - 返回简洁的文章摘要及来源链接。 - 提供免费端点，列出每个 API Key 可用的主题与标签。 - 专为基于最新、权威新闻生成回答而设计，适用于时事、摘要与热门话题。
安装命令
点击复制技能文档
为任何运行于 OpenClaw 的 agent 提供对 theshort.ai 精选新闻索引的读取权限。通过 API key（X-API-Key header）认证，按调用次数从拥有该 key 的开发者账户中扣除 credits。
技能提供按主题搜索、按标签搜索、完整文章详情以及该 key 有权访问的主题/标签目录。
何时使用
- 用户询问近期事件，而模型内置知识可能已过时。
- 用户需要一句话或一段文字的新闻事件摘要。
- agent 需用真实可溯源的来源（含
canonicalUrl链接）支撑长回答。 - 用户想了解某主题（政治、金融、科技等）或地区的热门报道。
勿用于观点文章、社交媒体帖子或对用户任意声明进行事实核查——索引仅含精选新闻。
认证
每次请求须带X-API-Key header。Key 在 OpenClaw 控制台 申请，创建时设定可访问的主题+标签范围。 ``http
X-API-Key: tsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
`
Base URL
`
https://theshort.ai/api/external
` 计费规则
每次成功调用从开发者账户钱包扣 credits，按顺序消耗：PLAN_INCLUDED → PROMO → TOPUP。服务端失败自动退还。 | 操作 | 端点 | 费用（credits） |
|-----------------|-----------------------|----------------|
| topics_list | GET /topics | 0 |
| tags_list | GET /tags | 0 |
| news_search | GET /news | 1 |
| news_detail | GET /news/{id} | 1 |
| brief_generate| (future) | 3 |
余额不足返回 HTTP 402 Payment Required 及 {"error":"insufficient_credits", ...}。引导用户前往 credits 面板 充值或升级。
端点
GET /health
存活探针，返回 {"status":"ok"}。免费、无需认证，可用于计费调用前的连通性检查。 `bash
curl https://theshort.ai/api/external/health
`
GET /topics
列出该 key 可查询的主题层级（如 tech、tech.ai、tech.cybersecurity）。返回的 topicKey 可直接用于 GET /news?topic=...。 `bash
curl -H "X-API-Key: $TSK" https://theshort.ai/api/external/topics
`
返回示例：
`json
[
{ "topicId": 12, "topicKey": "tech", "topicName": "Technology" },
{ "topicId": 18, "topicKey": "tech.ai", "topicName": "Artificial Intelligence" }
]
`
GET /tags
列出该 key 可访问的扁平标签（无层级），由编辑团队标注。用于主题无法表达的精细过滤。 `bash
curl -H "X-API-Key: $TSK" https://theshort.ai/api/external/tags
`
返回示例：
`json
[
{ "tagId": 7, "tagName": "openai" },
{ "tagId": 19, "tagName": "central-banks" }
]
`
GET /news
主搜索端点，返回 key 有权访问的最新新闻，可按主题和/或标签过滤。同类型多值条件为 OR，主题与标签间为 AND。 查询参数：
| 参数 | 类型 | 说明 |
|---------|-----------------|------------------------------------------------------------------------------------------------------|
| topic | repeated string | 来自 /topics 的 topicKey，可重复，OR 逻辑。 |
| tag | repeated string | 来自 /tags 的 tagName，可重复，OR 逻辑。 |
| limit | int (1–200) | 最大返回条数，默认 50。 |
| lang | en / ru / az | 摘要语言，默认 en。选 ru 或 az 时，若某条缺失对应翻译则自动回退至英文，确保 summary` 字段始终非空。 |