| name | ths-stock-themes |
| description | 获取同花顺个股题材/概念板块和人气排名数据。使用场景：(1) 查询单只股票在同花顺的题材/概念分类，(2) 获取同花顺个股人气排名榜单，(3) 生成包含题材和人气信息的 Markdown 报告。 |
Ths Stock Themes - 同花顺股票题材与人气
概述
本技能用于从同花顺网站获取个股的题材/概念板块信息和人气排名数据，输出结构化的 Markdown 报告。
核心功能
1. 获取个股题材/概念
从同花顺个股详情页获取股票所属的题材/概念板块。
数据源：https://stockpage.10jqka.com.cn/[股票代码]/
提取字段：
- 股票名称
- 股票代码
- 涉及概念/题材（如"高股息精选，跨境支付 (CIPS)..."）
- 所属地域
- 主营业务
2. 获取个股人气排名
从同花顺问财获取个股人气排名榜单。
数据源：https://www.iwencai.com/unifiedwap/result?w=个股人气排名
提取字段：
- 排名
- 股票代码
- 股票简称
- 现价（元）
- 涨跌幅（%）
- 个股热度排名
- 个股热度值
使用方法
查询单只股票题材
查询 [股票代码/名称] 的题材和概念
示例：
- "查询 000001 的题材"
- "平安银行属于什么概念板块"
- "获取 600519 的题材信息"
获取人气排名榜单
获取同花顺人气排名前 N 的股票
示例：
- "获取人气排名前 20 的股票"
- "今天人气最高的股票有哪些"
- "同花顺人气排名榜单"
生成综合报告
生成 [股票代码/名称] 的题材人气报告
示例：
- "生成 000001 的题材人气报告"
- "为贵州茅台生成题材和人气分析"
执行流程
获取个股题材（使用 browser 工具）
- 导航到
https://stockpage.10jqka.com.cn/[股票代码]/
- 等待页面加载完成
- 使用
snapshot 获取页面结构（refs="aria"）
- 定位"涉及概念"区域（term: "涉及概念"）
- 提取 definition 区域的文本内容
- 同时提取"所属地域"、"主营业务"等信息
获取人气排名（使用 browser 工具）
- 导航到
https://www.iwencai.com/unifiedwap/result?w=个股人气排名
- 等待页面加载完成
- 使用
snapshot 获取页面结构（refs="aria"）
- 定位表格区域（table ref）
- 遍历行（rowgroup > row）提取数据
- 解析每行的单元格数据
输出格式
个股题材报告模板
# [股票名称] ([股票代码]) - 题材概念分析
## 基本信息
- **所属地域**：xxx
- **主营业务**：xxx
## 涉及概念
1. 概念 1
2. 概念 2
3. 概念 3
...
## 人气排名
- **当前排名**：第 X 名
- **个股热度**：XXX
人气排名榜单模板
# 同花顺个股人气排名 TOP20
**数据日期**：YYYY-MM-DD HH:MM
| 排名 | 股票代码 | 股票简称 | 现价 (元) | 涨跌幅 (%) | 热度排名 | 热度值 |
|------|----------|----------|-----------|------------|----------|--------|
| 1 | 600396 | 华电辽能 | 6.26 | +10.02 | 1 | 16.79 万 |
| 2 | 002310 | 东方新能 | 3.48 | +10.13 | 2 | 14.08 万 |
...
注意事项
- 数据时效性：人气排名数据实时变化，建议在报告中注明数据获取时间
- 页面结构：同花顺页面可能更新，需定期检查 selector 是否有效
- 反爬机制：避免高频请求，建议添加适当延迟
- ST 股票：如需排除 ST 股票，在提取后过滤名称包含"ST"的股票
脚本说明
fetch_themes.py
获取单只股票的题材/概念信息。
python3 scripts/fetch_themes.py [股票代码]
输出 JSON 格式数据。
fetch_popularity.py
获取人气排名榜单。
python3 scripts/fetch_popularity.py [--limit 20]
参数：
输出 JSON 格式数据。
错误处理
- 页面加载失败：重试 3 次，每次间隔 2 秒
- 数据解析失败：返回错误信息，提示检查页面结构
- 股票代码无效：提示"未找到该股票信息"
