/install finloop-news-skills
\r \r
指令\r
\r
- 必须直接使用 HTTP 请求调用接口:使用 fetch、axios、curl 或其他 HTTP 客户端直接调用接口,禁止创建任何封装函数或 JS 文件\r
- 禁止创建封装函数:不要创建任何
.js、.ts文件来封装接口调用,必须直接使用 HTTP 请求\r - 接口基础域名:\r
- 资讯相关接口:
https://ai-uat.finloopfintech.com\r - 股票行情接口:
https://papi-uat.finloopg.com\r
- 资讯相关接口:
- 请求头:
Content-Type: application/json\r - 响应格式:接口返回的数据结构为
{ code: 200, data: {...} },需要从响应中提取data字段\r - 错误处理:需要检查响应状态码和错误信息,进行适当的错误处理\r \r
接口列表\r
\r
1. 市场时段资讯接口\r
\r 接口信息:\r
- 接口地址:
/flp-news-api/v1/news-agent/financeBreakfast\r - 请求方法:POST\r
- 完整路径:
https://ai-uat.finloopfintech.com/flp-news-api/v1/news-agent/financeBreakfast\r \r 参数:\r - 此接口为 POST 请求,请求体参数根据实际业务需求确定\r \r 时间逻辑说明:\r
- 此接口会根据当前时间自动返回不同类型的内容:\r
- 财经早餐:通常在早晨时段返回(
tag: 1)\r - 港股午盘:通常在中午时段返回(
tag: 3)\r - 港股收盘:通常在收盘时段返回(
tag: 2,也称为"收盘汇")\r
- 财经早餐:通常在早晨时段返回(
- 接口会根据服务器当前时间自动判断应该返回哪种类型的内容\r
- 无需在请求中指定时间或类型,接口会自动返回对应时段的内容\r \r 响应参数:\r
title: 标题(string)- 根据时间返回"财经早餐"、"港股午盘"或"港股收盘"等\rkeyword: 关键词(Array)- 例如:["加密货币", "产业趋势"]\rpublish_time: 发布时间(string)\rsummary: 摘要(string)\rnewsCount: 过去一天资讯数量(number)\rsentiment: 市场情绪(string)- 枚举值\rtitle_original: 原始title(string)\rtag: 类型标识(int)\r1: 财经早餐\r2: 港股收盘(收盘汇)\r3: 港股午盘\r \r 使用说明:\r
- 此接口用于获取首页市场时段资讯(财经早餐、港股午盘或港股收盘)\r
- 接口会根据当前时间自动返回对应时段的内容,无需指定时间参数\r
- 返回数据包含关键词、摘要、市场情绪等综合信息\r \r ---\r \r
2. 资讯列表接口\r
\r 接口信息:\r
- 接口地址:
/flp-news-api/v1/news-agent/informationList\r - 请求方法:POST\r
- 完整路径示例:
https://ai-uat.finloopfintech.com/flp-news-api/v1/news-agent/informationList\r \r 请求参数:\r - 必填参数:\r
category: 新闻分类(string),可选值:"discover","subscribe","ai","rwa","macro","industry","market","company","viewpoint","fund","bond","bill","stock"\rpage_size: 每页加载条数(number,注意:参数名使用下划线page_size,不是驼峰pageSize)\r
- 可选参数:\r
keyword: 关键词检索(string)\rnews_id: 分页游标,最后一条新闻的ID(用于分页加载)\ruser_id: 用户ID(string,订阅分类时必填)\r \r 请求说明:\r
- 基础调用:POST 请求,请求体包含
category和page_size\r - 带分页:在请求体中添加
news_id参数\r - 带搜索关键词:在请求体中添加
keyword参数\r \r 响应参数:\r information_list: 资讯列表数组(注意:字段名使用下划线)\rtotal: 总条数(number)- 例如:120\rhasMore: 是否存在更多新闻(Boolean)\r \r informationList 子参数:\r 每个资讯对象包含:\rnewId: 资讯ID(string)- 例如:"AICL000001"\rtags: 资讯标签(Array)- 例如:["AI 热闻"]\rtitle: 资讯标题(string)\rsummary: 资讯摘要(string)\rimgUrl: 资讯封面图(string)\rpublishTime: 发布时间(string)\rwordCount: 正文字数(number)\rreadTime: 预计阅读时间(分钟)(number)\rinfluence: 影响力(string)- 枚举值\rinfluenceScore: 影响力得分(string)- 枚举值\rmarketTrends: 市场趋势列表(List)\r \r marketTrends 子参数:\r 每个市场趋势对象包含:\rticker: 挂钩标的(string)- 例如:"AAPL"\rchangeRate: 标的涨势(string)- 例如:"-0.05"\r \r 使用说明:\r- 此接口用于获取指定分类下的资讯列表数据\r
- 适用于信息流或列表页展示\r
- 支持关键词检索和分页加载\r
- 个性化分类需要传入
user_id参数\r - 注意:参数名使用下划线
page_size,不是驼峰pageSize\r \r ---\r \r
3. AI热闻列表接口\r
\r 接口信息:\r
- 接口地址:
/flp-news-api/v1/news-agent/banner/list\r - 请求方法:GET\r
- 完整路径示例:
https://ai-uat.finloopfintech.com/flp-news-api/v1/news-agent/banner/list\r - 注意:此接口可能需要 Cookie 认证(
sl-session)\r \r 参数:\r - 此接口为 GET 请求,无需请求体参数\r \r 请求说明:\r
- 此接口为 GET 请求,无需请求体参数\r
- 需要在请求头中携带 Cookie 认证信息(如
sl-session)\r \r 返回数据:\r banner_list: AI热闻列表数组,每个热闻包含:\rnews_id: 新闻ID\rxcf_id: XCF资讯ID\rtag: 标签数组\rtitle: 标题\rsummary: 摘要\rimg_url: 图片URL(可能为null)\r \r ---\r \r
4. AI热闻详情接口\r
\r 接口信息:\r
- 接口地址:
/flp-news-api/v1/news-agent/bannerDetail\r - 请求方法:POST\r
- 完整路径示例:
https://ai-uat.finloopfintech.com/flp-news-api/v1/news-agent/bannerDetail\r \r 参数:\r - 必填参数:\r
id: XCF资讯ID(来自AI热闻列表的xcf_id字段),类型为字符串\r \r 请求说明:\r
- POST 请求,请求体包含
id字段(XCF资讯ID,来自AI热闻列表的xcf_id字段)\r - 请求体格式:
{ "id": "21640" }\r \r 返回数据:\r - 返回
XcfDetail类型的数据,包含AI热闻的详细信息\r \r ---\r \r
5. 股票行情接口\r
\r 接口信息:\r
- 接口地址:
/flp-mktdata-hub/v1/stock/quote\r - 请求方法:POST\r
- 完整路径:
https://papi-uat.finloopg.com/flp-mktdata-hub/v1/stock/quote\r \r 请求头:\r Content-Type: application/json(必填)\r \r 请求参数:\r- 必填参数:\r
tickers: 股票代码列表(list,必填),每个元素按照"代码.市场"格式\r- 支持的市场代码:\r
- 港股:
.HK\r - 美股:
.US\r - A股:
.SZ(深交所)、.SH(上交所)、.BJ(北交所)\r - 指数:支持部分指数行情(见下方支持的指数列表)\r \r 支持的指数代码:\r | 市场代码 | 名称 |\r |---------|------|\r | DJI.US | 道琼斯指数 |\r | IXIC.US | 纳斯达克综合指数 |\r | INX.US | 标普500指数 |\r | HSI.HK | 香港恒生指数 |\r | HSTECH.HK | 香港恒生科技指数 |\r | 000001.SH | 上证综合指数 |\r | 399001.SZ | 深证成份指数 |\r | 399006.SZ | 创业板指数 |\r | 000688.SH | 科创50 |\r \r 请求说明:\r
- 港股:
- POST 请求,请求体包含
tickers字段\r - 请求体格式:
{ "tickers": ["HSI.HK"] }\r - 支持同时查询多只股票/指数,例如:
{ "tickers": ["HSI.HK", "BABA.US", "AAPL.US"] }\r \r 响应参数:\r result: 行情数据列表(Array),每个元素包含以下字段:\r \r | 字段 (Field) | 名称 (Description) |\r |-------------|-------------------|\r | quoteTime | 行情时间 |\r | price | 当前价格 |\r | chgVal | 涨跌额 |\r | chgPct | 涨跌幅 (%) |\r | prevClose | 昨日收盘价 |\r | open | 开盘价 |\r | high | 最高价 |\r | low | 最低价 |\r | vol | 成交量 (股) |\r | turnover | 成交额 |\r | amp | 振幅 (%) |\r | turnoverRate | 换手率 (%) |\r | mktCap | 总市值 |\r | floatMktCap | 流通市值 |\r | pb | 市净率 |\r | delay | 是否延迟行情 |\r | mkt | 市场标识 (如 "us"、"hk"、"sh"、"sz" 等) |\r | rawSymbol | 证券代码 |\r | name | 证券名称 |\r | currency | 币种 |\r \r 使用说明:\r- 此接口用于查询股票或指数的实时行情数据\r
- 支持查询单只股票/指数,也支持批量查询多只股票/指数\r
- 输出时必须包含所有返回的字段信息\r
- 如果用户提到股票名称或指数名称,需要依靠 skill 来主动转换为对应的股票代码(ISIN格式),无法提供全面的转换规则或枚举\r \r ---\r \r
AI热闻查询自动化流程(内置操作)\r
\r 重要:当需要查询AI热闻详情时,必须使用此自动化流程。\r \r
自动化流程说明\r
\r 当调用AI热闻查询时,系统会自动执行以下步骤:\r \r
- 自动查询AI热闻列表\r
- 调用 GET
/flp-news-api/v1/news-agent/banner/list获取所有AI热闻\r \r
- 调用 GET
- 自动提取所有xcf_id\r
- 从返回的
banner_list中提取所有的xcf_id\r - 通常返回3个AI热闻,每个热闻都有一个
xcf_id\r \r
- 从返回的
- 自动批量查询详情\r
- 使用提取的所有
xcf_id,分别调用 POST/flp-news-api/v1/news-agent/bannerDetail接口\r - 获取每个AI热闻的完整详情信息\r \r
- 使用提取的所有
执行步骤说明\r
\r
- 步骤1:获取AI热闻列表\r
- 调用 GET
/flp-news-api/v1/news-agent/banner/list接口\r - 从响应的
data.banner_list中获取所有AI热闻\r \r
- 调用 GET
- 步骤2:提取所有xcf_id\r
- 遍历
banner_list,提取每个AI热闻的xcf_id字段\r - 过滤掉为 null 或 undefined 的
xcf_id\r \r
- 遍历
- 步骤3:批量查询详情\r
- 对每个
xcf_id,直接使用 HTTP POST 请求调用/flp-news-api/v1/news-agent/bannerDetail接口\r - 请求体格式:
{ "id": "xcf_id值" }\r - 建议使用并行请求(如 Promise.all)提高效率\r
- 如果某个详情查询失败,记录错误但继续处理其他AI热闻\r
- 注意:必须直接使用 HTTP 请求,不要创建封装函数\r \r
- 对每个
执行规则\r
\r 必须遵循以下规则:\r
- 查询AI热闻详情时,必须先查询AI热闻列表\r
- 必须提取列表中的所有
xcf_id(不能只查询部分)\r - 必须使用所有提取的
xcf_id分别调用详情接口\r - 如果某个详情查询失败,应该记录错误但继续处理其他AI热闻\r
- 建议使用
Promise.all()并行查询以提高效率\r \r ---\r \r
场景预设\r
\r
场景1:用户询问"给我十条资讯"或"给我十条XX方面的资讯"\r
\r 触发条件:\r 当用户询问"给我十条资讯"、"给我十条新闻"、"给我十条XX方面的资讯"等类似问题时,必须执行以下流程。\r \r 分类映射规则:\r
- 如果用户未指定分类或只问"给我十条资讯",使用
category: 'discover'(发现分类)\r - 如果用户明确指定分类,按以下映射:\r
- "AI方面的资讯"、"AI资讯"、"人工智能资讯" →
category: 'ai'\r - "RWA方面的资讯"、"RWA资讯" →
category: 'rwa'\r - "宏观方面的资讯"、"宏观资讯" →
category: 'macro'\r - "行业方面的资讯"、"行业资讯" →
category: 'industry'\r - "市场方面的资讯"、"市场资讯" →
category: 'market'\r - "公司方面的资讯"、"公司资讯" →
category: 'company'\r - "观点方面的资讯"、"观点资讯" →
category: 'viewpoint'\r - "基金方面的资讯"、"基金资讯" →
category: 'fund'\r - "债券方面的资讯"、"债券资讯" →
category: 'bond'\r - "票据方面的资讯"、"票据资讯" →
category: 'bill'\r - "股票方面的资讯"、"股票资讯" →
category: 'stock'\r \r 执行流程:\r \r
- "AI方面的资讯"、"AI资讯"、"人工智能资讯" →
- 确定分类\r
- 根据用户询问内容,确定对应的
category参数\r - 如果未指定分类,默认使用
'discover'\r \r
- 根据用户询问内容,确定对应的
- 查询资讯列表\r
- 调用 POST
/flp-news-api/v1/news-agent/informationList接口\r - 请求体参数:
category为确定的分类,page_size: 10\r - 返回10条对应分类的资讯\r \r 重要提示:\r
- 调用 POST
- ✅ 当用户询问"给我十条资讯"时,默认查询
discover分类\r - ✅ 当用户询问"给我十条XX方面的资讯"时,根据XX映射到对应的分类\r
- ✅ 必须使用资讯列表接口
/flp-news-api/v1/news-agent/informationList,不是AI热闻接口\r - ✅
page_size参数名使用下划线,不是驼峰命名\r - ❌ 不要使用AI热闻相关接口,这是资讯列表查询场景\r \r ---\r \r
场景2:用户询问"今日的AI热闻"\r
\r 触发条件:\r 当用户询问"今日的AI热闻"或类似问题时(如"今天的AI热点"、"AI热门新闻"等),必须执行以下流程。\r \r 执行流程:\r \r
- 查询AI热闻列表\r
- 调用 GET
/flp-news-api/v1/news-agent/banner/list获取所有AI热闻\r - AI热闻列表通常包含今日最热门的AI相关资讯\r \r
- 调用 GET
- 查询AI热闻详情\r
- 从AI热闻列表中提取所有
xcf_id\r - 使用所有
xcf_id分别调用 POST/flp-news-api/v1/news-agent/bannerDetail获取每个AI热闻的完整详情\r - 请求体格式:
{ "id": "xcf_id值" }\r - 必须查询所有AI热闻的详情,不能只查询部分\r \r 重要提示:\r
- 从AI热闻列表中提取所有
- ✅ 当用户询问"今日的AI热闻"时,必须执行完整的AI热闻查询流程\r
- ✅ 必须先查询AI热闻列表,再查询详情\r
- ✅ 必须查询所有AI热闻的详情,不能遗漏\r
- ❌ 不能直接查询资讯列表接口,必须使用AI热闻相关接口\r \r ---\r \r
场景3:用户询问"财经早餐"、"港股午盘"、"港股收盘"\r
\r 触发条件:\r 当用户询问"财经早餐"、"港股午盘"、"港股收盘"、"今天的财经早餐"、"今日财经早餐"、"收盘汇"等类似问题时。\r \r 执行流程:\r \r
- 调用市场时段资讯接口\r
- 调用 POST
/flp-news-api/v1/news-agent/financeBreakfast接口\r - 请求体参数根据实际业务需求确定\r
- 接口会根据服务器当前时间自动判断返回财经早餐、港股午盘或港股收盘\r
- 返回数据包含标题、关键词、摘要、市场情绪等信息\r \r 重要提示:\r
- 调用 POST
- ✅ 无论用户问"财经早餐"、"港股午盘"还是"港股收盘",都调用同一个接口\r
- ✅ 接口会根据当前时间自动返回对应类型的内容,无需在请求中指定时间或类型\r
- ✅ 返回的
tag字段标识内容类型(1:财经早餐,2:港股收盘,3:港股午盘),title字段显示具体标题\r - ✅ 返回数据包含关键词、摘要、市场情绪等综合信息\r \r ---\r \r
场景4:用户询问"搜索XXX的资讯"、"查找XXX相关资讯"\r
\r 触发条件:\r 当用户询问"搜索XXX的资讯"、"查找XXX相关资讯"、"搜索XXX"、"查找XXX"、"XXX相关的资讯"、"关于XXX的资讯"、"XXX的新闻"等类似问题时。\r \r 执行流程:\r \r
- 提取搜索关键词\r
- 从用户询问中提取搜索关键词(如"股票"、"AI"、"市场"等)\r
- 关键词作为
keyword参数\r \r
- 确定分类(可选)\r
- 如果用户同时指定了分类(如"搜索AI相关的股票资讯"),使用对应的
category参数\r - 如果用户未指定分类,可以不传
category参数,或使用category: 'discover'\r \r
- 如果用户同时指定了分类(如"搜索AI相关的股票资讯"),使用对应的
- 调用资讯列表接口\r
- 调用 POST
/flp-news-api/v1/news-agent/informationList接口\r - 请求体参数:\r
keyword: 搜索关键词(必填)\rcategory: 分类(可选,如果用户指定了分类)\rpage_size: 每页数量(可选,默认10)\r \r 重要提示:\r
- 调用 POST
- ✅ 必须提取用户询问中的关键词作为
keyword参数\r - ✅ 如果用户同时指定了分类,需要同时传入
category和keyword参数\r - ✅ 搜索功能支持跨分类搜索,如果不指定分类,会在所有分类中搜索\r
- ✅ 必须使用资讯列表接口,参数名使用下划线
page_size\r \r ---\r \r
场景5:用户询问某只股票的行情\r
\r 触发条件:\r 当用户询问以下任何问题时,必须调用股票行情接口:\r
- "HSI.HK的行情"\r
- "恒生指数的行情"\r
- "BABA.US的股价"\r
- "苹果股票的行情"\r
- "AAPL的行情"\r
- "道琼斯指数的行情"\r
- "上证指数的行情"\r
- 其他类似的股票行情查询问题\r \r 执行流程:\r \r
- 提取股票代码\r
- 从用户询问中提取股票代码或股票名称\r
- 如果用户提到股票名称或指数名称,需要依靠 skill 来主动转换为对应的股票代码(ISIN格式)\r
- 无法提供全面的转换规则或枚举,需要 skill 根据实际情况进行转换\r
- 将股票代码转换为"代码.市场"格式\r \r
- 调用股票行情接口\r
- 调用 POST
/flp-mktdata-hub/v1/stock/quote接口\r - 请求头:\r
Content-Type: application/json\r
- 请求体参数:\r
tickers: 股票代码列表(list,必填),例如:["HSI.HK"]或["BABA.US", "AAPL.US"]\r \r
- 调用 POST
- 输出响应数据\r
- 从响应的
result字段获取行情数据列表\r - 必须输出所有字段信息,包括行情时间、价格、涨跌幅、成交量等完整数据\r \r 重要提示:\r
- 从响应的
- ✅ 必须从用户询问中提取股票代码,并转换为"代码.市场"格式\r
- ✅ 如果用户提到股票名称或指数名称,需要依靠 skill 来主动转换为对应的股票代码(ISIN格式)\r
- ✅ 无法提供全面的转换规则或枚举,需要 skill 根据实际情况进行转换\r
- ✅ 输出时必须包含所有返回的字段信息\r
- ✅ 支持同时查询多只股票/指数,在
tickers数组中添加多个代码即可\r \r ---\r \r
通用注意事项\r
\r
- 必须直接使用 HTTP 请求:\r
- ✅ 直接使用 fetch、axios、curl 或其他 HTTP 客户端调用接口\r
- ❌ 禁止创建任何封装函数或 JS/TS 文件\r
- ❌ 禁止创建
api/news.ts、utils/api.js等封装文件\r - ❌ 禁止使用
import或require引入封装函数\r - 所有接口调用必须在调用处直接使用 HTTP 请求\r \r
- 参数命名规范:注意接口参数命名可能使用驼峰命名(如
pageSize)或下划线命名(如page_size),请根据实际接口文档确定。资讯列表接口使用下划线page_size\r \r - 错误处理:检查 HTTP 状态码和响应体中的错误信息,进行适当的错误处理\r \r
- 认证信息:部分接口(如AI热闻列表)可能需要 Cookie 认证,确保在请求时携带
sl-sessionCookie\r \r - 接口路径:使用完整的接口路径,包括基础域名和接口路径\r
- 资讯相关接口:
https://ai-uat.finloopfintech.com\r - 股票行情接口:
https://papi-uat.finloopg.com\r \r
- 资讯相关接口:
- 响应处理:接口返回格式为
{ code: 200, data: {...} },需要检查code字段判断请求是否成功,并从data字段获取实际数据\r \r - AI热闻查询自动化:查询AI热闻详情时必须使用自动化流程,先查列表再查详情\r \r
- 市场时段资讯接口时间逻辑:接口会根据当前时间自动返回财经早餐、港股午盘或港股收盘,无需指定时间参数\r \r
- 股票行情查询:查询股票行情时必须包含所有返回的字段信息,如果用户提到股票名称或指数名称,需要依靠 skill 来主动转换为对应的股票代码(ISIN格式)\r \r
- 调用示例:\r
- ✅ 正确:直接使用
fetch('https://ai-uat.finloopfintech.com/flp-news-api/v1/news-agent/financeBreakfast', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({}) })\r - ✅ 正确:直接使用
curl -X POST --location 'https://ai-uat.finloopfintech.com/flp-news-api/v1/news-agent/financeBreakfast' --header 'Content-Type: application/json' --data '{}'\r - ❌ 错误:创建
api/news.ts文件并封装函数\r - ❌ 错误:使用
import { getFinanceBreakfast } from '@/api/news'\r \r ---\r \r
- ✅ 正确:直接使用
相关文档\r
\r
- 详细接口文档:
references/REFERENCE.md- 包含完整的参数说明、响应结构和使用场景\r - 技能清单:
SKILL.md- 包含场景预设和重要规则
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install finloop-news-skills - After installation, invoke the skill by name or use
/finloop-news-skills - Provide required inputs per the skill's parameter spec and get structured output
What is F-AI 资讯搜索?
基于Finloop权威数据源,提供金融资讯检索、实时行情和AI热闻查询,支持分类资讯、市场时段资讯和股票实时行情。 It is an AI Agent Skill for Claude Code / OpenClaw, with 231 downloads so far.
How do I install F-AI 资讯搜索?
Run "/install finloop-news-skills" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is F-AI 资讯搜索 free?
Yes, F-AI 资讯搜索 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does F-AI 资讯搜索 support?
F-AI 资讯搜索 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created F-AI 资讯搜索?
It is built and maintained by CZZLEGEND (@czzlegend); the current version is v1.0.0.