# marketsync_tracker

**Repository Path**: dgtg77/marketsync_tracker

## Basic Information

- **Project Name**: marketsync_tracker
- **Description**: 市场跟踪系统
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-24
- **Last Updated**: 2026-03-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 大宗商品价格监控追踪器

一个用于监控大宗商品价格并根据自定义规则发送告警的通知系统。

## 功能特性

- **多数据源支持**：支持 AlphaVantage 和 Yahoo Finance 等数据源
- **灵活告警规则**：可根据价格条件（高于/低于阈值）创建自定义告警规则
- **多种通知方式**：支持控制台输出和邮件通知
- **实时监控**：持续监控商品价格并触发相应告警
- **交互式管理**：提供命令行交互界面管理告警规则

## 项目结构

```
.
├── config/
│   ├── commodities.json    # 大宗商品配置
│   ├── init.py
│   └── settings.py         # 系统设置
├── src/
│   ├── alerts/
│   │   ├── engine.py       # 告警引擎
│   │   ├── rules.py        # 告警规则
│   │   └── init.py
│   ├── fetchers/
│   │   ├── base.py         # 基础数据获取器
│   │   ├── alpha_vantage.py
│   │   ├── yahoo_finance.py
│   │   └── init.py
│   ├── notifiers/
│   │   ├── base.py         # 基础通知器
│   │   ├── console.py      # 控制台通知
│   │   ├── email.py        # 邮件通知
│   │   └── init.py
│   ├── utils/
│   │   ├── logger.py
│   │   └── init.py
│   ├── main.py             # 主程序逻辑
│   └── init.py
├── run.py                  # 入口文件
├── requirements.txt        # 依赖
└── .env.example           # 环境变量示例
```

## 安装

1. 克隆项目：

```bash
git clone https://gitee.com/dgtg77/marketsync_tracker.git
cd marketsync_tracker
```

2. 安装依赖：

```bash
pip install -r requirements.txt
```

3. 配置环境变量：

```bash
cp .env.example .env
# 编辑 .env 文件，配置相关参数
```

## 配置

### 大宗商品配置 (config/commodities.json)

配置需要监控的大宗商品及其数据源：

```json
{
    "GOLD": {
        "source": "alpha_vantage",
        "symbol": "XAU/USD",
        "name": "黄金"
    },
    "OIL": {
        "source": "alpha_vantage",
        "symbol": "CL/USD",
        "name": "原油"
    }
}
```

### 告警规则

支持以下条件类型：
- `above`：价格高于阈值时触发
- `below`：价格低于阈值时触发

支持配置冷却时间（cooldown），避免重复告警。

## 使用方法

### 启动监控

```bash
python run.py
```

### 命令行操作

- `start` - 启动监控
- `stop` - 停止监控
- `status` - 查看监控状态
- `add` - 添加新的告警规则
- `list` - 列出所有告警规则
- `help` - 显示帮助信息

### 添加告警规则示例

```
输入商品名称: GOLD
输入条件 (above/below): above
输入阈值: 2000
输入规则名称: Gold Price Alert
```

## 依赖

- Python 3.7+
- requests
- python-dotenv

## 许可证

MIT License