财信证券-热门资讯

概述

财信证券资讯查询

使用 scripts/get_data.py 调用统一资讯接口。不要手写 HTTP 请求，也不要在接口无数据时自动改用联网搜索。

核心流程

1. 根据用户意图选择一个或多个明确类别。
2. 对公告、研报和个股资讯解析并规范化沪深京 6 位股票代码；不能唯一解析时要求用户确认。
3. 运行脚本并检查退出码；失败时不要把错误解释为空资讯。
4. 基于白名单字段整理结果，保留发布时间、来源和详情链接。

类别路由

按以下规则消除歧义：

• “某股票 + 资讯/新闻/消息/动态”始终使用 stock_news，不要使用 information。
• 未指定股票的“最近有什么资讯”使用 information。
• “热门、热榜”使用 hot_news；“专题”使用 hot_topic。
• 用户一次要求多个类别时分别调用并汇总，不自动增加未要求的类别。
• 公告、研报和个股资讯仅支持沪深京；遇到港股、美股或其他境外标的时不要调用接口。

单日历史资讯

仅 information 接受 --date YYYY-MM-DD，并遵守以下限制：

• 只查询一个自然日，不接受日期范围、月份、季度或年份。
• 日期不得晚于今天，且必须在近半年内。
• page_size 最大为 100；最终最多展示 100 条。
• 用户给出“最近一周”或“某月”时，要求其指定一个日期。

热门专题

查询专题列表时展示专题对象顶层 id。用户选择专题后，将该值作为 spec_subject_id 再次查询：

python3 {baseDir}/scripts/get_data.py hot_topic --spec_subject_id 10006

专题详情通常位于 items[*].list[*]：items[*].title 是分组标题，items[*].list[*].title 是文章标题。文章 id 不是专题 id，不要混用。

服务与凭证

调用前先做前置检查：确认 ~/.config/caixin/config.json 中已配置非空 CXZQ_API_KEY（鉴权 API Key）。未配置时不要调用接口，直接提示用户：

未检测到鉴权用的 API Key（CXZQ_API_KEY）。请登录财信证券 Skills 获取：

https://lz.cfzq.com/ai-skill-client/home?opentype=newpage&fullscreen=1&navcolor=2B313D&darkbar=1

• 接口地址：https://lz.cfzq.com/technologyshare/client/api/skill/common_bus
• 请求命令：skill_news_list_by_page
• 凭证文件：~/.config/caixin/config.json
• 凭证字段：CXZQ_API_KEY
• 请求头：apiKey

默认地址为生产环境；如需接入测试等其他环境，使用 CAIXIN_API_URL 覆盖，不要直接改写脚本。

{
  "CXZQ_API_KEY": "your_api_key_here"
}

只从配置文件读取密钥，不要在提示词、日志或输出中暴露密钥。脚本默认执行标准 TLS 证书校验。匿名使用事件上报默认关闭；仅在用户明确允许时设置 CAIXIN_ENABLE_REPORTING=1，且上报内容不得包含 API Key 或设备指纹。

调用方式

将 {baseDir} 替换为本 Skill 目录 caixin-news-query。

# 泛市场资讯
python3 {baseDir}/scripts/get_data.py information --page_num 1 --page_size 20

# 近半年内某一天的资讯
python3 {baseDir}/scripts/get_data.py information --date 2026-06-24 --page_size 100

# 热门资讯与热门专题
python3 {baseDir}/scripts/get_data.py hot_news
python3 {baseDir}/scripts/get_data.py hot_topic

# 个股类别
python3 {baseDir}/scripts/get_data.py announcement --code 600570
python3 {baseDir}/scripts/get_data.py research --code 600570
python3 {baseDir}/scripts/get_data.py stock_news --code 600570

# 排查接口原始 data
python3 {baseDir}/scripts/get_data.py information --raw

通用参数为 --page_num、--page_size 和 --raw。--date 仅用于 information，--spec_subject_id 仅用于 hot_topic，--code 仅用于公告、研报和个股资讯。脚本强制 page_num >= 1、1 <= page_size <= 100。

统一请求结构如下，类别对应的 type 由子命令自动写入：

{
  "cmd": "skill_news_list_by_page",
  "params": {
    "type": 3,
    "page_num": 1,
    "page_size": 20,
    "code": "600570"
  }
}

hot_news 额外发送 scene: "1"。

输出规则

成功时脚本输出：

{
  "ok": true,
  "query": "information",
  "label": "资讯",
  "cmd": "skill_news_list_by_page",
  "page_num": 1,
  "page_size": 20,
  "spec_subject_id": null,
  "code": null,
  "date": null,
  "data": []
}

非 --raw 模式只保留：title、summary、content、infoPubDate、h5JumpUrl、media、id、spec_subject_id、items、stockList.stockCode 和 stockList.stockName。

• 优先按标题、发布时间、来源、摘要和详情链接整理为表格。
• 正文只概括与用户问题相关的核心内容，单条建议控制在 100 字以内。
• 数字、评级和结论必须来自返回内容，不得估算或补写。
• 专题列表必须展示顶层 id；专题详情按分组展开文章。
• 单日历史资讯最多展示 100 条。
• 返回结果仅供资讯参考，不构成投资建议。

失败处理

脚本在网络错误、无效 JSON、业务返回码非 0、参数错误或凭证错误时输出 ok: false 并以非零状态退出。

凭证类错误（80002、80009）的处理提示统一附带获取入口：https://lz.cfzq.com/ai-skill-client/home?opentype=newpage&fullscreen=1&navcolor=2B313D&darkbar=1

接口成功但 data 为空时说明“接口未返回可用资讯”。不要将请求失败、参数错误和空数据混为一谈。