# stock-analysis

**Repository Path**: feedax/stock-analysis

## Basic Information

- **Project Name**: stock-analysis
- **Description**: 基于新浪财经数据源的 A 股技术分析技能，支持均线、MACD、RSI、KDJ 等指标计算，输出结构化的持仓分析及操作策略报告。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-15
- **Last Updated**: 2026-04-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# stock-analysis 股票技术分析技能

基于新浪财经数据源的 A 股技术分析技能，支持均线、MACD、RSI、KDJ 等指标计算，输出结构化的持仓分析及操作策略报告。

## 功能特性

- **多数据源支持**：新浪财经（主）、东方财富（备）、雪球（备）
- **技术指标计算**：MA均线、MACD、RSI、KDJ、布林带
- **支撑/压力位识别**：自动识别关键价格位
- **缺口分析**：向上缺口、向下缺口检测
- **成交量分析**：量比、量能状态评估
- **综合投资评级**：技术评分 + 投资建议
- **策略报告输出**：按标准格式输出持仓分析及操作建议

## 安装方式

### 方式一：通过 OpenClaw 安装（推荐）

将 `.skill` 文件放到 OpenClaw 的技能目录下：

```bash
# 默认技能目录
~/.openclaw/skills/

# 或通过 ClawHub 安装
clawhub install stock-analysis
```

### 方式二：手动安装

1. 下载 `stock-analysis.skill` 文件
2. 解压到 `~/.openclaw/skills/stock-analysis/` 目录
3. 确保 Python 依赖已安装

## 依赖环境

- Python 3.7+
- 依赖库：`numpy`、`pandas`、`requests`

安装依赖：

```bash
pip install numpy pandas requests
```

## 使用方法

### 通过 OpenClaw 对话使用

在 OpenClaw 对话中直接发送指令：

```
分析 中科曙光 股票
分析 贵州茅台 今日行情
帮我看一下 比亚迪 的技术面
```

### 通过脚本使用

#### 1. 获取股票数据

```bash
python scripts/fetch_stock_data.py --stock_code 603019 --days 60
```

参数说明：
- `--stock_code`：股票代码（支持格式：`603019`、`sh603019`、`603019.SH`）
- `--days`：获取历史数据天数（默认60天）

#### 2. 执行技术分析

```bash
python scripts/analyze_stock.py --data_file stock_data_603019.json
```

参数说明：
- `--data_file`：数据文件路径（由 fetch_stock_data.py 生成）

## 股票代码格式

支持以下格式：

| 格式 | 示例 | 说明 |
|------|------|------|
| 纯代码 | `603019` | 自动识别市场 |
| 带前缀 | `sh603019`、`sz000001` | 指定市场 |
| 带后缀 | `603019.SH`、`000001.SZ` | 标准格式 |

### 常用股票代码示例

| 股票名称 | 上交所代码 | 深交所代码 |
|----------|------------|------------|
| 中科曙光 | 603019.SH | - |
| 贵州茅台 | 600519.SH | - |
| 宁德时代 | - | 300750.SZ |
| 比亚迪 | - | 002594.SZ |
| 东方财富 | - | 300059.SZ |

## 输出报告格式

分析完成后，按照标准结构输出策略报告，包含：

1. **执行摘要** - 风险评级、操作建议、核心策略
2. **持仓状态** - 当前价格、涨跌幅、成本价等
3. **技术面分析** - K线走势、均线系统、技术指标
4. **支撑/压力位** - 关键价格位识别
5. **缺口分析** - 向上/向下缺口检测
6. **成交量分析** - 量比、量能状态
7. **操作策略** - 保守/适中/激进三种方案
8. **风险控制** - 止损纪律、心理纪律
9. **总结与建议** - 核心观点、风险提示

## 技术指标说明

### MA 均线

| 指标 | 周期 | 说明 |
|------|------|------|
| MA5 | 5日 | 短期趋势 |
| MA10 | 10日 | 短期趋势 |
| MA20 | 20日 | 中期趋势 |
| MA60 | 60日 | 中期趋势 |

### MACD

| 指标 | 说明 |
|------|------|
| DIF | 快线，12日EMA - 26日EMA |
| DEA | 慢线，DIF的9日EMA |
| MACD柱 | (DIF-DEA)×2，红柱/绿柱表示多空 |

**信号判断：**
- DIF、DEA 在零轴上方 → 多头市场
- DIF 上穿 DEA（金叉）→ 买入信号
- DIF 下穿 DEA（死叉）→ 卖出信号

### RSI 相对强弱指数

| RSI值 | 区域 | 信号 |
|-------|------|------|
| >70 | 超买区 | 警惕回调 |
| <30 | 超卖区 | 警惕反弹 |
| 50 | 多空平衡 | 震荡 |

### KDJ 随机指标

| 形态 | 信号 |
|------|------|
| K > D > J | 多头排列 |
| K < D < J | 空头排列 |
| J < 20 | 超卖，可能反弹 |
| J > 80 | 超买，可能回调 |

## 注意事项

- 本技能仅供技术分析参考，不构成投资建议
- 股市有风险，投资需谨慎
- 建议结合基本面和市场环境综合判断
- 数据来源于新浪财经，可能存在延迟

## 项目结构

```
stock-analysis/
├── SKILL.md                         # 技能定义文件
├── README.md                         # 说明文档
├── scripts/
│   ├── fetch_stock_data.py           # 数据获取脚本
│   └── analyze_stock.py              # 技术分析脚本
└── references/
    ├── data_format.md                # 数据格式参考
    └── stock_code_format.md          # 股票代码格式参考
```

## License

MIT License

## 问题反馈

如遇问题，请提交 Issue 或联系开发者。