SFC 主题库数据查询 (sfc-theme)
概述
本模块提供南方财经 (SFC) 主题库数据查询能力，支持查询主题/概念相关数据，包括主题成分股、主题资讯、主题基金、财务对比等。
文件输出规则
所有本技能生成的文件统一保存到 ~/.openclaw/workspace/nancai/ 目录下。
文件命名规范：{类型}_{主题}_{日期}.md 或 {类型}_{主题}_{日期}.png
触发条件
当用户询问以下内容时，使用本模块：
| 用户问题类型 | 典型问法 |
|---|---|
| 主题/概念查询 | "XX 概念有哪些股票"、"芯片主题成分股"、"新能源概念" |
| 主题资讯 | "XX 主题最新消息"、"光伏概念新闻" |
| 主题基金 | "投资 XX 主题的基金"、"半导体概念基金" |
| 主题行情 | "今天哪个板块涨幅最大"、"热门主题排行" |
| 主题对比 | "XX 概念股票财务对比" |
| 主题搜索 | "有哪些 AI 相关的主题"、"搜索碳中和概念" |
配置
与 sfc-quote 模块共用 config.json 配置：
{
"token": "你的 SFC API Token"
}
核心功能
1. 推荐主题列表
获取今日关注、风口板块、潜伏日历等推荐主题。
# 今日关注
python call.py -a recommend -t 2 -n 10
# 风口板块
python call.py -a recommend -t 3 -n 10
# 潜伏日历
python call.py -a recommend -t 4 -n 10
2. 主题列表
获取所有主题列表（分页）。
python call.py -a list -n 30
3. 主题详情
获取特定主题的详细信息。
# 通过主题 ID
python call.py -a detail --theme-id 11010001
# 通过主题名称
python call.py -a detail -n "3D 玻璃"
4. 主题成分股
获取主题/概念的成分股列表。
# 获取所有成分股
python call.py -a stocks --theme-id 11010001 -n 30
# 只获取龙头股
python call.py -a stocks --theme-id 11010001 --leader
📋 输出格式规范（重要）
概念成分股统一输出格式包含以下模块：
1️⃣ 成分股行情表格
| 列名 | 说明 |
|---|---|
| # | 序号 |
| 股票名称 | 加粗 + 标记（涨停🚀/跌停💀） |
| 代码 | 6 位代码 |
| 最新价 | 保留 2 位小数 |
| 涨跌幅 | 带符号百分比 |
| 成交额 | 亿为单位 |
| 换手率 | 百分比 |
| 概念关联 | 简短说明与概念的关联 |
2️⃣ 📊 成分股表现统计
- 上涨/下跌股票数量
- 涨停股数量
- 总成交额
- 平均涨幅
3️⃣ 🔍 重点成分股
- 涨跌幅最大股（涨停/领涨）
- 成交额最高股
- 包含：涨跌幅、最新价、成交额、概念关联
4️⃣ 💡 产业链分布
| 环节 | 代表公司 | 数量 |
|---|---|---|
| 设备 | 公司 A、公司 B | X 家 |
| 材料 | 公司 C、公司 D | X 家 |
5️⃣ 📌 核心逻辑
- 龙头股说明
- 技术路线/产品关联
- 市场地位
示例输出：
## 🔋 BC 电池概念成分股
**数据时间**: 2026-04-17 11:15 | **共 13 只成分股**
### 📊 成分股行情一览
| # | 股票名称 | 代码 | 最新价 | 涨跌幅 | ... |
|:-:|---------|------|--------|:------:|-----|
| 1 | **帝尔激光** 🚀 | 300776 | 99.36 | +20.00% | ... |
...
### 📈 成分股表现统计
| 指标 | 数值 |
|------|------|
| **上涨股票** | 7 只 |
...
5. 主题产业链
获取主题的产业链结构。
python call.py -a industry --theme-id 11010001
6. 主题大事件
获取主题相关的重要事件。
python call.py -a events --theme-id 11010001 -n 20
7. 主题资讯
获取主题相关的新闻资讯。
python call.py -a news -n "3D 玻璃" -p 20
8. 主题基金
获取与主题相关的基金。
python call.py -a fund --theme-id 11010001 -p 10
9. 成分股财务对比
对比主题内成分股的财务数据。
python call.py -a property --theme-id 11010001 -d 2025-12-31 -p 20
10. 主题搜索
搜索相关主题。
python call.py -a search -k "新能源" -n 10
11. 主题产业链目录
获取主题的产业链目录结构。
python call.py -a directory --theme-id 11010001
API 接口列表
| 接口 | 功能 | 主要参数 |
|---|---|---|
/rest/theme/recomend |
推荐主题 | type(2/3/4), pageSize |
/rest/theme/list |
主题列表 | id(分页), pageSize |
/rest/theme/detail |
主题详情 | themeId 或 themeName |
/rest/theme/stocks/list |
成分股 | themeId, leader_yn, pageSize |
/rest/theme/stocks/industrylist |
产业链 | themeId, leader_yn |
/rest/theme/stocks/article/list |
大事件 | themeId, time(分页), pageSize |
/rest/theme/stocks/news/list |
资讯 | themeName, time(分页), pageSize |
/rest/theme/fund/list |
主题基金 | themeId, pageNo, pageSize, sort |
/rest/theme/property/compare |
财务对比 | themeId, date, pageNo, type, sort |
/rest/theme/search |
主题搜索 | keyword, pageSize |
/rest/theme/stocks/directory |
产业链目录 | themeId |
/rest/theme/content/toimg |
内容转图片 | themeId |
/rest/theme/content/img/share |
图片分享 | themeId |
/rest/theme/article/list |
新闻相关主题 | articleId |
使用示例
示例 1：查询光伏概念成分股
# 先搜索主题
python call.py -a search -k "光伏" -n 5
# 获取成分股 (假设主题 ID 为 11020005)
python call.py -a stocks --theme-id 11020005 -n 20
示例 2：查询热门主题今日表现
# 获取今日关注主题
python call.py -a recommend -t 2 -n 10
示例 3：查询主题资讯
# 查询 AI 主题最新资讯
python call.py -a news -n "人工智能" -p 10
示例 4：成分股财务对比
# 对比芯片主题成分股 2025 年财务数据
python call.py -a property --theme-id 11010005 -d 2025-12-31 -p 15
输出格式规范
面向用户展示，不暴露技术细节：
✅ 应该展示
- 清晰的主题名称和成分股列表
- 股票代码和名称
- 加入主题的理由（如有）
- 相关资讯标题和摘要
- 财务对比数据（表格形式）
❌ 不要展示
- API 接口地址和参数
- 原始 JSON 数据结构
- 脚本文件名和路径
- 技术术语如 theme_id、pageSize 等
与其他模块的配合
结合行情查询
查询主题成分股后，可结合 sfc-quote 查询实时行情：
# 1. 获取成分股
python call.py -a stocks --theme-id 11010001 -n 10
# 2. 查询成分股实时行情
python ../sfc-quote/query_quote.py quote 300724
结合资讯查询
查询主题资讯后，可结合 sfc-news 获取更详细的新闻内容：
# 1. 获取主题资讯
python call.py -a news -n "新能源" -p 5
# 2. 搜索相关新闻
python ../sfc-news/call.py -a search -k "新能源" -n 10
注意事项
- 主题 ID 获取：大部分接口需要主题 ID，可通过
search或list接口先获取 - 分页处理：大数据量时需要处理分页，使用
last_id、time等参数 - 龙头股筛选：使用
--leader参数可只返回龙头股 - 日期格式：财务对比接口需要
YYYY-MM-DD格式日期 - Token 配置：与 sfc-data 其他模块共用同一 token
典型应用场景
- 概念炒作分析：查询热门概念的成分股和资讯
- 主题投资研究：分析主题内成分股的财务表现
- 板块轮动跟踪：监控风口板块和潜伏日历
- 产业链研究：通过产业链目录了解上下游关系
- 基金配置参考：查询主题相关基金的持仓情况
