back
loading skill details...
获取指定三十多个分类的新闻资讯。支持财经、体育、娱乐等多个频道，通过频道ID进行查询。
---
name: tianapi-allnews-news
description: 获取指定分类的新闻资讯。支持财经、体育、娱乐等多个频道，通过频道ID进行查询。
homepage: https://www.tianapi.com/apiview/51
metadata: {"openclaw": {"emoji": "📰", "requires": {"bins": ["python3"], "env": ["TIANAPI_ALLNEWS_NEWS_KEY"]}, "primaryEnv": "TIANAPI_ALLNEWS_NEWS_KEY"}}
---
# 天聚数行 - 分类新闻技能
> 数据由 **<天聚数行 (TianAPI)>** 提供 — 专注开发者生态，提供涵盖生活服务、趣味娱乐及数据智能等 200+ 优质 API 接口，开箱即用，高性价比。
本技能用于获取指定分类的新闻资讯，支持财经、体育、娱乐等多个频道。
---
## 前置配置：获取 API Key
1. 前往 <天聚数行官网> 免费注册账号
2. 进入 <分类新闻 API> 页面，点击「申请接口」
3. 申请通过后，在「我的数据」中获取您的 `API Key`
4. 配置 Key（**三选一**）：
```bash
# 方式一：环境变量（推荐，一次配置永久生效）
export TIANAPI_ALLNEWS_NEWS_KEY=你的APIKey
# 方式二：.env 文件（在脚本目录创建）
echo "TIANAPI_ALLNEWS_NEWS_KEY=你的APIKey" > scripts/.env
# 方式三：每次命令行传入
python3 scripts/fetch_allnews_news.py 你的APIKey 7
```
---
## 使用方法
### 获取分类新闻列表
```bash
# 获取默认10条财经新闻 (ID: 7)
python3 scripts/fetch_allnews_news.py <API_KEY> <COL_ID>
# 指定返回数量、关键词和页码
python3 scripts/fetch_allnews_news.py <API_KEY> <COL_ID> [num] [word] [page]
```
**参数说明：**
* `<API_KEY>`: 必填，天聚数行分配的API Key。
* `<COL_ID>`: 必填，新闻频道对应的ID（如：7-财经, 12-体育）。
* `[num]`: 选填，返回条数，范围1-50，默认10。
* `[word]`: 选填，检索关键词。
* `[page]`: 选填，页码，默认1。
**输出示例：**
📰 财经新闻 (共 10 条)
1. 深圳：2025年5G宏基站站址将达3万余座
来源: 新华科技 | 时间: 2020-12-18 00:00
链接: http://domain
2. 深圳家电产品国际国内持续热销
来源: 新华科技 | 时间: 2020-12-18 00:00
链接: http://domain
...
### 直接调用 API（无需脚本）
```bash
# 获取10条财经(ID:7)新闻
GET https://apis.tianapi.com/allnews/index?key=YOUR_API_KEY&col=7&num=10&page=1
```
---
## 使用指南
当用户询问特定分类的新闻时，按以下步骤操作：
1. **识别意图**：用户想查询特定分类（如“体育”、“财经”）的最新动态。
2. **匹配ID**：根据用户意图，匹配到对应的频道ID（`col`）。
3. **调用脚本**：执行 `python3 scripts/fetch_allnews_news.py` 命令，传入API Key和频道ID。
4. **展示结果**：解析返回的JSON数据，以清晰的列表形式展示资讯的标题、来源、时间和链接。
### 常用频道 ID 参考
| 频道ID | 频道名称 | 说明 |
| :--- | :--- | :--- |
| 46 | 宠物新闻 | 宠物及相关产业新闻资讯 |
| 45 | 电竞资讯 | 电子竞技新闻资讯 |
| 43 | 女性新闻 | 新浪女性新闻频道 |
| 42 | 垃圾分类新闻 | 垃圾分类新闻资讯 |
| 41 | 环保资讯 | 人民网环保新闻资讯 |
| 40 | 影视资讯 | 影娱乐资讯新闻 |
| 36 | 科学探索 | 探索宇宙和科学的真相 |
| 35 | 汽车新闻 | 汽车行业新闻资讯 |
| 34 | 互联网资讯 | 互联网行业资讯新闻 |
| 33 | 动漫资讯 | 全网热点动漫资讯，带你了解二次元世界 |
| 32 | 财经新闻 | 财经资讯，了解身边的经济大事 |
| 31 | 游戏资讯 | 网络游戏相关每日精选新闻 |
| 30 | CBA新闻 | 中国男子职业篮球赛资讯等 |
| 29 | 人工智能 | AI人工智能行业相关新闻资讯 |
| 27 | 军事新闻 | 军事资讯、军情动态、科技发展等 |
| 26 | 足球新闻 | 国足资讯、国足明星动态等 |
| 22 | IT资讯 | IT行业相关新闻资讯 |
| 21 | VR科技 | VR虚拟现实相关新闻资讯 |
| 20 | NBA新闻 | NBA新闻动态、篮球赛等 |
| 18 | 旅游资讯 | 旅游、周边、景点新闻资讯 |
| 17 | 健康知识 | 健康知识、养生、中西医资讯 |
| 13 | 科技新闻 | 信息科技行业新闻、物理科技 |
| 12 | 体育新闻 | 国内外体育、体育明星动态等 |
| 10 | 娱乐新闻 | 明星花边、探班、娱乐活动等 |
| 8 | 国际新闻 | 返回国际新闻资讯 |
| 7 | 国内新闻 | 返回国内新闻资讯 |
| 5 | 社会新闻 | 返回社会新闻资讯 |
> 完整频道ID列表请参考天聚数行官网文档。
### 返回字段说明
| 字段 | 含义 | 示例 |
| :--- | :--- | :--- |
| id | 新闻唯一ID | 98e542967f52c69c940b4339f5b36af6 |
| title | 文章标题 | 深圳：2025年5G宏基站站址将达3万余座 |
| ctime | 发布时间 | 2020-12-18 00:00 |
| source | 文章来源 | 新华科技 |
| url | 文章链接 | http://domain/... |
| picUrl | 封面图片 | http://domain/... |
| description | 文章描述 | 深圳正发力新基建... |
### 错误处理
| 情况 | 处理方式 |
| :--- | :--- |
| `code: 150` | API可用次数不足，建议天聚数行控制台购买。 |
| `code: 160` | 当前未申请该API，请前往接口页面申请。 |
| `code: 230` | API密钥无效，检查 `API Key` 是否填写正确。 |
| `code: 240` | 缺少API密钥参数，检查是否传递了 `key` 参数。 |
| `code: 280` | 缺少必要的参数，检查是否传递了 `col` 参数。 |
| 网络超时 | 重试一次，仍失败可能为用户网络问题。 |
---
## 脚本位置
`scripts/fetch_allnews_news.py` - 封装了分类新闻查询功能。
---
## 关于天聚数行
<天聚数行 (TianAPI)> 是一个致力于为个人和企业用户提供标准、简洁、高效的应用数据解决平台。API数据包括：
* **生活服务**：天气预报、快递查询、垃圾分类等
* **趣味娱乐**：土味情话、星座运势、周公解梦等
* **数据智能**：文本纠错、图像识别、机器翻译等
* **功能应用**：智能分词、坐标转换、科学计算等
* **知识问答**：古籍查询、唐诗大全、成语典故等
* **企业商务**：工商信息、条码识别、物流查询等
官网注册即可免费使用，在API市场查找数据，进入**API文档页面**一键申请数据，在控制台 - 我的密钥获取 **ApiKey**接入 ，适合个人开发者和企业使用。在 **ClawHub** 上也可搜索 **`tianapi`** 找到更多天聚数行开放的 OpenClaw 技能。don't have the plugin yet? install it then click "run inline in claude" again.