安装到本地项目
请为我安装如下skill
by czzlegend · published 2026-03-22
$ claw add gh:czzlegend/czzlegend-finloop-news-skills---
请为我安装如下skill
name:
finloop_news (Finloop资讯skill)
description:
本 Skill 基于 Finloop 权威数据源，提供金融资讯检索与实时行情查询能力。支持市场时段资讯、分类资讯查询、AI热闻追踪、实时股票行情等功能，用于获取涉及时效性信息或特定事件信息的任务，包括新闻、公告、研报、政策、市场动态、股票行情等。避免AI在搜索金融场景信息时，参考到非权威、及过时的信息。
安装方式
通过 npm/npx 安装（推荐）
# 安装到本地项目
npx finloop-news-skills install finloop-news-skill
name: Finloop 资讯API调用技能
description: 当需要调用Finloop资讯相关接口时，请参考此规范。包括市场时段资讯、资讯列表、AI热闻、股票行情等接口。
---
指令
1. **必须直接使用 HTTP 请求调用接口**：使用 fetch、axios、curl 或其他 HTTP 客户端直接调用接口，禁止创建任何封装函数或 JS 文件
2. **禁止创建封装函数**：不要创建任何 `.js`、`.ts` 文件来封装接口调用，必须直接使用 HTTP 请求
3. **接口基础域名**：
- 资讯相关接口：`https://ai-uat.finloopfintech.com`
- 股票行情接口：`https://papi-uat.finloopg.com`
4. **请求头**：`Content-Type: application/json`
5. **响应格式**：接口返回的数据结构为 `{ code: 200, data: {...} }`，需要从响应中提取 `data` 字段
6. **错误处理**：需要检查响应状态码和错误信息，进行适当的错误处理
接口列表
1. 市场时段资讯接口
**接口信息：**
**参数：**
**时间逻辑说明：**
- **财经早餐**：通常在早晨时段返回（`tag: 1`）
- **港股午盘**：通常在中午时段返回（`tag: 3`）
- **港股收盘**：通常在收盘时段返回（`tag: 2`，也称为"收盘汇"）
**响应参数：**
- `1`: 财经早餐
- `2`: 港股收盘（收盘汇）
- `3`: 港股午盘
**使用说明：**
---
2. 资讯列表接口
**接口信息：**
**请求参数：**
- `category`: 新闻分类（string），可选值：`"discover"`, `"subscribe"`, `"ai"`, `"rwa"`, `"macro"`, `"industry"`, `"market"`, `"company"`, `"viewpoint"`, `"fund"`, `"bond"`, `"bill"`, `"stock"`
- `page_size`: 每页加载条数（number，注意：参数名使用下划线 `page_size`，不是驼峰 `pageSize`）
- `keyword`: 关键词检索（string）
- `news_id`: 分页游标，最后一条新闻的ID（用于分页加载）
- `user_id`: 用户ID（string，订阅分类时必填）
**请求说明：**
**响应参数：**
**informationList 子参数：**
每个资讯对象包含：
**marketTrends 子参数：**
每个市场趋势对象包含：
**使用说明：**
---
3. AI热闻列表接口
**接口信息：**
**参数：**
**请求说明：**
**返回数据：**
- `news_id`: 新闻ID
- `xcf_id`: XCF资讯ID
- `tag`: 标签数组
- `title`: 标题
- `summary`: 摘要
- `img_url`: 图片URL（可能为null）
---
4. AI热闻详情接口
**接口信息：**
**参数：**
- `id`: XCF资讯ID（来自AI热闻列表的 `xcf_id` 字段），类型为字符串
**请求说明：**
**返回数据：**
---
5. 股票行情接口
**接口信息：**
**请求头：**
**请求参数：**
- `tickers`: 股票代码列表（list，必填），每个元素按照"代码.市场"格式
- 支持的市场代码：
- 港股：`.HK`
- 美股：`.US`
- A股：`.SZ`（深交所）、`.SH`（上交所）、`.BJ`（北交所）
- 指数：支持部分指数行情（见下方支持的指数列表）
**支持的指数代码：**
| 市场代码 | 名称 |
|---------|------|
| DJI.US | 道琼斯指数 |
| IXIC.US | 纳斯达克综合指数 |
| INX.US | 标普500指数 |
| HSI.HK | 香港恒生指数 |
| HSTECH.HK | 香港恒生科技指数 |
| 000001.SH | 上证综合指数 |
| 399001.SZ | 深证成份指数 |
| 399006.SZ | 创业板指数 |
| 000688.SH | 科创50 |
**请求说明：**
**响应参数：**
| 字段 (Field) | 名称 (Description) |
|-------------|-------------------|
| quoteTime | 行情时间 |
| price | 当前价格 |
| chgVal | 涨跌额 |
| chgPct | 涨跌幅 (%) |
| prevClose | 昨日收盘价 |
| open | 开盘价 |
| high | 最高价 |
| low | 最低价 |
| vol | 成交量 (股) |
| turnover | 成交额 |
| amp | 振幅 (%) |
| turnoverRate | 换手率 (%) |
| mktCap | 总市值 |
| floatMktCap | 流通市值 |
| pb | 市净率 |
| delay | 是否延迟行情 |
| mkt | 市场标识 (如 "us"、"hk"、"sh"、"sz" 等) |
| rawSymbol | 证券代码 |
| name | 证券名称 |
| currency | 币种 |
**使用说明：**
---
AI热闻查询自动化流程（内置操作）
**重要：当需要查询AI热闻详情时，必须使用此自动化流程。**
自动化流程说明
当调用AI热闻查询时，系统会自动执行以下步骤：
1. **自动查询AI热闻列表**
- 调用 GET `/flp-news-api/v1/news-agent/banner/list` 获取所有AI热闻
2. **自动提取所有xcf_id**
- 从返回的 `banner_list` 中提取所有的 `xcf_id`
- 通常返回3个AI热闻，每个热闻都有一个 `xcf_id`
3. **自动批量查询详情**
- 使用提取的所有 `xcf_id`，分别调用 POST `/flp-news-api/v1/news-agent/bannerDetail` 接口
- 获取每个AI热闻的完整详情信息
执行步骤说明
1. **步骤1：获取AI热闻列表**
- 调用 GET `/flp-news-api/v1/news-agent/banner/list` 接口
- 从响应的 `data.banner_list` 中获取所有AI热闻
2. **步骤2：提取所有xcf_id**
- 遍历 `banner_list`，提取每个AI热闻的 `xcf_id` 字段
- 过滤掉为 null 或 undefined 的 `xcf_id`
3. **步骤3：批量查询详情**
- 对每个 `xcf_id`，直接使用 HTTP POST 请求调用 `/flp-news-api/v1/news-agent/bannerDetail` 接口
- 请求体格式：`{ "id": "xcf_id值" }`
- 建议使用并行请求（如 Promise.all）提高效率
- 如果某个详情查询失败，记录错误但继续处理其他AI热闻
- **注意**：必须直接使用 HTTP 请求，不要创建封装函数
执行规则
**必须遵循以下规则：**
1. 查询AI热闻详情时，必须先查询AI热闻列表
2. 必须提取列表中的所有 `xcf_id`（不能只查询部分）
3. 必须使用所有提取的 `xcf_id` 分别调用详情接口
4. 如果某个详情查询失败，应该记录错误但继续处理其他AI热闻
5. 建议使用 `Promise.all()` 并行查询以提高效率
---
场景预设
场景1：用户询问"给我十条资讯"或"给我十条XX方面的资讯"
**触发条件：**
当用户询问"给我十条资讯"、"给我十条新闻"、"给我十条XX方面的资讯"等类似问题时，必须执行以下流程。
**分类映射规则：**
- "AI方面的资讯"、"AI资讯"、"人工智能资讯" → `category: 'ai'`
- "RWA方面的资讯"、"RWA资讯" → `category: 'rwa'`
- "宏观方面的资讯"、"宏观资讯" → `category: 'macro'`
- "行业方面的资讯"、"行业资讯" → `category: 'industry'`
- "市场方面的资讯"、"市场资讯" → `category: 'market'`
- "公司方面的资讯"、"公司资讯" → `category: 'company'`
- "观点方面的资讯"、"观点资讯" → `category: 'viewpoint'`
- "基金方面的资讯"、"基金资讯" → `category: 'fund'`
- "债券方面的资讯"、"债券资讯" → `category: 'bond'`
- "票据方面的资讯"、"票据资讯" → `category: 'bill'`
- "股票方面的资讯"、"股票资讯" → `category: 'stock'`
**执行流程：**
1. **确定分类**
- 根据用户询问内容，确定对应的 `category` 参数
- 如果未指定分类，默认使用 `'discover'`
2. **查询资讯列表**
- 调用 POST `/flp-news-api/v1/news-agent/informationList` 接口
- 请求体参数：`category` 为确定的分类，`page_size: 10`
- 返回10条对应分类的资讯
**重要提示：**
---
场景2：用户询问"今日的AI热闻"
**触发条件：**
当用户询问"今日的AI热闻"或类似问题时（如"今天的AI热点"、"AI热门新闻"等），必须执行以下流程。
**执行流程：**
1. **查询AI热闻列表**
- 调用 GET `/flp-news-api/v1/news-agent/banner/list` 获取所有AI热闻
- AI热闻列表通常包含今日最热门的AI相关资讯
2. **查询AI热闻详情**
- 从AI热闻列表中提取所有 `xcf_id`
- 使用所有 `xcf_id` 分别调用 POST `/flp-news-api/v1/news-agent/bannerDetail` 获取每个AI热闻的完整详情
- 请求体格式：`{ "id": "xcf_id值" }`
- 必须查询所有AI热闻的详情，不能只查询部分
**重要提示：**
---
场景3：用户询问"财经早餐"、"港股午盘"、"港股收盘"
**触发条件：**
当用户询问"财经早餐"、"港股午盘"、"港股收盘"、"今天的财经早餐"、"今日财经早餐"、"收盘汇"等类似问题时。
**执行流程：**
1. **调用市场时段资讯接口**
- 调用 POST `/flp-news-api/v1/news-agent/financeBreakfast` 接口
- 请求体参数根据实际业务需求确定
- 接口会根据服务器当前时间自动判断返回财经早餐、港股午盘或港股收盘
- 返回数据包含标题、关键词、摘要、市场情绪等信息
**重要提示：**
---
场景4：用户询问"搜索XXX的资讯"、"查找XXX相关资讯"
**触发条件：**
当用户询问"搜索XXX的资讯"、"查找XXX相关资讯"、"搜索XXX"、"查找XXX"、"XXX相关的资讯"、"关于XXX的资讯"、"XXX的新闻"等类似问题时。
**执行流程：**
1. **提取搜索关键词**
- 从用户询问中提取搜索关键词（如"股票"、"AI"、"市场"等）
- 关键词作为 `keyword` 参数
2. **确定分类（可选）**
- 如果用户同时指定了分类（如"搜索AI相关的股票资讯"），使用对应的 `category` 参数
- 如果用户未指定分类，可以不传 `category` 参数，或使用 `category: 'discover'`
3. **调用资讯列表接口**
- 调用 POST `/flp-news-api/v1/news-agent/informationList` 接口
- 请求体参数：
- `keyword`: 搜索关键词（必填）
- `category`: 分类（可选，如果用户指定了分类）
- `page_size`: 每页数量（可选，默认10）
**重要提示：**
---
场景5：用户询问某只股票的行情
**触发条件：**
当用户询问以下任何问题时，必须调用股票行情接口：
**执行流程：**
1. **提取股票代码**
- 从用户询问中提取股票代码或股票名称
- 如果用户提到股票名称或指数名称，需要依靠 skill 来主动转换为对应的股票代码（ISIN格式）
- 无法提供全面的转换规则或枚举，需要 skill 根据实际情况进行转换
- 将股票代码转换为"代码.市场"格式
2. **调用股票行情接口**
- 调用 POST `/flp-mktdata-hub/v1/stock/quote` 接口
- 请求头：
- `Content-Type: application/json`
- 请求体参数：
- `tickers`: 股票代码列表（list，必填），例如：`["HSI.HK"]` 或 `["BABA.US", "AAPL.US"]`
3. **输出响应数据**
- 从响应的 `result` 字段获取行情数据列表
- **必须输出所有字段信息**，包括行情时间、价格、涨跌幅、成交量等完整数据
**重要提示：**
---
通用注意事项
1. **必须直接使用 HTTP 请求**：
- ✅ 直接使用 fetch、axios、curl 或其他 HTTP 客户端调用接口
- ❌ **禁止创建任何封装函数或 JS/TS 文件**
- ❌ **禁止创建 `api/news.ts`、`utils/api.js` 等封装文件**
- ❌ **禁止使用 `import` 或 `require` 引入封装函数**
- 所有接口调用必须在调用处直接使用 HTTP 请求
2. **参数命名规范**：注意接口参数命名可能使用驼峰命名（如 `pageSize`）或下划线命名（如 `page_size`），请根据实际接口文档确定。资讯列表接口使用下划线 `page_size`
3. **错误处理**：检查 HTTP 状态码和响应体中的错误信息，进行适当的错误处理
4. **认证信息**：部分接口（如AI热闻列表）可能需要 Cookie 认证，确保在请求时携带 `sl-session` Cookie
5. **接口路径**：使用完整的接口路径，包括基础域名和接口路径
- 资讯相关接口：`https://ai-uat.finloopfintech.com`
- 股票行情接口：`https://papi-uat.finloopg.com`
6. **响应处理**：接口返回格式为 `{ code: 200, data: {...} }`，需要检查 `code` 字段判断请求是否成功，并从 `data` 字段获取实际数据
7. **AI热闻查询自动化**：查询AI热闻详情时必须使用自动化流程，先查列表再查详情
8. **市场时段资讯接口时间逻辑**：接口会根据当前时间自动返回财经早餐、港股午盘或港股收盘，无需指定时间参数
9. **股票行情查询**：查询股票行情时必须包含所有返回的字段信息，如果用户提到股票名称或指数名称，需要依靠 skill 来主动转换为对应的股票代码（ISIN格式）
10. **调用示例**：
- ✅ 正确：直接使用 `fetch('https://ai-uat.finloopfintech.com/flp-news-api/v1/news-agent/financeBreakfast', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({}) })`
- ✅ 正确：直接使用 `curl -X POST --location 'https://ai-uat.finloopfintech.com/flp-news-api/v1/news-agent/financeBreakfast' --header 'Content-Type: application/json' --data '{}'`
- ❌ 错误：创建 `api/news.ts` 文件并封装函数
- ❌ 错误：使用 `import { getFinanceBreakfast } from '@/api/news'`
---
相关文档
More tools from the same signal band
Order food/drinks (点餐) on an Android device paired as an OpenClaw node. Uses in-app menu and cart; add goods, view cart, submit order (demo, no real payment).
Sign plugins, rotate agent credentials without losing identity, and publicly attest to plugin behavior with verifiable claims and authenticated transfers.
The philosophical layer for AI agents. Maps behavior to Spinoza's 48 affects, calculates persistence scores, and generates geometric self-reports. Give your...