天聚数行 - 分类新闻技能

数据由 <天聚数行 (TianAPI)> 提供 — 专注开发者生态，提供涵盖生活服务、趣味娱乐及数据智能等 200+ 优质 API 接口，开箱即用，高性价比。

本技能用于获取指定分类的新闻资讯，支持财经、体育、娱乐等多个频道。

---

前置配置：获取 API Key

1. 前往 <天聚数行官网> 免费注册账号

2. 进入 <分类新闻 API> 页面，点击「申请接口」

3. 申请通过后，在「我的数据」中获取您的 API Key

4. 配置 Key（三选一）：

   # 方式一：环境变量（推荐，一次配置永久生效）
   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 技能。