Ths Stock Themes

## 核心功能

### 1. 获取个股题材/概念

从同花顺个股详情页获取股票所属的题材/概念板块。

**数据源**：`https://stockpage.10jqka.com.cn/[股票代码]/`

**提取字段**：
- 股票名称
- 股票代码
- 涉及概念/题材（如"高股息精选，跨境支付 (CIPS)..."）
- 所属地域
- 主营业务

### 2. 获取个股人气排名

从同花顺问财获取个股人气排名榜单。

**数据源**：`https://www.iwencai.com/unifiedwap/result?w=个股人气排名`

**提取字段**：
- 排名
- 股票代码
- 股票简称
- 现价（元）
- 涨跌幅（%）
- 个股热度排名
- 个股热度值

## 使用方法

### 查询单只股票题材

```
查询 [股票代码/名称] 的题材和概念
```

示例：
- "查询 000001 的题材"
- "平安银行属于什么概念板块"
- "获取 600519 的题材信息"

### 获取人气排名榜单

```
获取同花顺人气排名前 N 的股票
```

示例：
- "获取人气排名前 20 的股票"
- "今天人气最高的股票有哪些"
- "同花顺人气排名榜单"

### 生成综合报告

```
生成 [股票代码/名称] 的题材人气报告
```

示例：
- "生成 000001 的题材人气报告"
- "为贵州茅台生成题材和人气分析"

## 执行流程

### 获取个股题材（使用 browser 工具）

1. 导航到 `https://stockpage.10jqka.com.cn/[股票代码]/`
2. 等待页面加载完成
3. 使用 `snapshot` 获取页面结构（refs="aria"）
4. 定位"涉及概念"区域（term: "涉及概念"）
5. 提取 definition 区域的文本内容
6. 同时提取"所属地域"、"主营业务"等信息

### 获取人气排名（使用 browser 工具）

1. 导航到 `https://www.iwencai.com/unifiedwap/result?w=个股人气排名`
2. 等待页面加载完成
3. 使用 `snapshot` 获取页面结构（refs="aria"）
4. 定位表格区域（table ref）
5. 遍历行（rowgroup > row）提取数据
6. 解析每行的单元格数据

## 输出格式

### 个股题材报告模板

```markdown
# [股票名称] ([股票代码]) - 题材概念分析

## 基本信息
- **所属地域**：xxx
- **主营业务**：xxx

## 涉及概念
1. 概念 1
2. 概念 2
3. 概念 3
...

## 人气排名
- **当前排名**：第 X 名
- **个股热度**：XXX
```

### 人气排名榜单模板

```markdown
# 同花顺个股人气排名 TOP20

**数据日期**：YYYY-MM-DD HH:MM

| 排名 | 股票代码 | 股票简称 | 现价 (元) | 涨跌幅 (%) | 热度排名 | 热度值 |
|------|----------|----------|-----------|------------|----------|--------|
| 1 | 600396 | 华电辽能 | 6.26 | +10.02 | 1 | 16.79 万 |
| 2 | 002310 | 东方新能 | 3.48 | +10.13 | 2 | 14.08 万 |
...
```

## 注意事项

1. **数据时效性**：人气排名数据实时变化，建议在报告中注明数据获取时间
2. **页面结构**：同花顺页面可能更新，需定期检查 selector 是否有效
3. **反爬机制**：避免高频请求，建议添加适当延迟
4. **ST 股票**：如需排除 ST 股票，在提取后过滤名称包含"ST"的股票

## 脚本说明

### fetch_themes.py

获取单只股票的题材/概念信息。

```bash
python3 scripts/fetch_themes.py [股票代码]
```

输出 JSON 格式数据。

### fetch_popularity.py

获取人气排名榜单。

```bash
python3 scripts/fetch_popularity.py [--limit 20]
```

参数：
- `--limit`: 获取前 N 名（默认 20）

输出 JSON 格式数据。

## 错误处理

- **页面加载失败**：重试 3 次，每次间隔 2 秒
- **数据解析失败**：返回错误信息，提示检查页面结构
- **股票代码无效**：提示"未找到该股票信息"