---
slug: "cn-stock-sim"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/meo9rhsan3492-cell/cn-stock-sim@main/README.md"
repo: "https://github.com/meo9rhsan3492-cell/cn-stock-sim"
source_file: "README.md"
branch: "main"
---
# AI Skills Repository

A collection of AI agent skills for OpenClaw / Claude Code, covering stocks, commodities, and more.

## Skills

### cn-stock-sim
**A股智能交易技能** —— 沪深股票实时行情查询与模拟交易

连接新浪财经真实行情接口，为 AI Agent 提供完整的 A 股投资辅助能力。数据来自沪深交易所实时行情，交易为模拟盘，不涉及真实账户和资金。

**核心功能：**
- 📈 **实时行情查询** — 沪深股票代码查询，支持大盘指数（上证/深证/创业板）
- 💹 **模拟买入/卖出** — 严格遵循 A 股规则（T+1、最小100股单位）
- 📊 **持仓管理** — 实时计算持仓成本、盈亏、收益率
- 🧠 **多因子选股策略** — 政策面 + 资金面 + 技术面三维评估（"慧眼"策略）
- 🎯 **交易历史记录** — 完整买卖记录，可追溯回测

**技术栈：**
- Python 3 + MCP（Model Context Protocol）
- 新浪财经实时行情接口
- Agent-Reach 集成（支持小红书/微信等平台分享策略）

**适用场景：**
- AI Agent 自动盯盘、生成投资建议
- 教学演示、量化策略回测
- 社交媒体（小红书/雪球/微信公众号）内容自动生成

详情见 [cn-stock-sim/SKILL.md](https://github.com/meo9rhsan3492-cell/cn-stock-sim/blob/HEAD/cn-stock-sim/SKILL.md)

---

### gold-copper-trading
**黄金铜交易技能** —— 国际大宗商品模拟交易

连接 OpenCTP 模拟交易所，提供黄金和铜的实时行情查询、模拟买卖和持仓管理。适合大宗商品投资辅助和套利策略演示。

**核心功能：**
- 🥇 **黄金/铜实时行情查询**
- 📊 **金银铜价比分析**
- 💹 **模拟买入/卖出**
- 📊 **持仓管理与损益计算**

详情见 [cn-stock-sim/gold-copper-trading/SKILL.md](https://github.com/meo9rhsan3492-cell/cn-stock-sim/blob/HEAD/cn-stock-sim/gold-copper-trading/SKILL.md)

---

## 安装使用

### 安装技能

```bash
# OpenClaw
openclaw skills install cn-stock-sim

# 或 clone 后手动安装
git clone https://github.com/meo9rhsan3492-cell/cn-stock-sim.git
```

### 快速开始

**1. 查询股票实时价格**
```bash
python3 cn-stock-sim/scripts/get_price.py --code 600519
```

**2. 查询大盘指数**
```bash
python3 cn-stock-sim/scripts/get_price.py --index sh000001
```

**3. 买入股票**
```bash
python3 cn-stock-sim/scripts/trade.py --action buy --code 600519 --shares 100
```

**4. 查看持仓**
```bash
python3 cn-stock-sim/scripts/portfolio.py
```

**5. AI Agent 分析选股**
```bash
# 使用 "慧眼" 多因子策略
# AI 自动搜索政策面、资金面，结合实时行情，输出三维评估
```

---

## 多因子选股策略（"慧眼"策略）

策略同时评估三个维度，任两个维度信号积极即建议买入：

| 因子 | 评估方式 |
|------|---------|
| 政策面 | 搜索产业政策、降准降息、行业利好/利空 |
| 资金面 | 搜索北向资金、成交放量、外资动向 |
| 技术面 | 均线位置、涨跌幅、趋势方向 |

详见 [cn-stock-sim/strategy.md](https://github.com/meo9rhsan3492-cell/cn-stock-sim/blob/HEAD/cn-stock-sim/strategy.md)

---

## 项目结构

```
cn-stock-sim/
├── README.md
├── cn-stock-sim/               # A股智能交易技能
│   ├── SKILL.md               # 技能说明文档
│   ├── strategy.md             # 多因子选股策略
│   └── scripts/
│       ├── get_price.py       # 实时行情查询
│       ├── trade.py           # 模拟买卖
│       └── portfolio.py        # 持仓管理
└── gold-copper-trading/       # 黄金铜交易技能
    ├── SKILL.md
    └── scripts/
        ├── get_price.py
        ├── trade.py
        └── portfolio.py
```

---

## 技术说明

- **行情数据来源**：新浪财经实时接口（真实交易所数据）
- **交易机制**：模拟盘，初始资金 100 万元，T+1 结算
- **数据格式**：JSON，便于 AI Agent 解析和处理
- **合规提示**：本项目仅供教学和研究使用，不构成投资建议