stock-data-collector（股票数据采集器）

股票历史数据整理技能

整理A股和港股指定股票的历史数据，支持批量整理和多周期数据。

支持的市场

• A股：上海证券交易所（600xxx, 688xxx）、深圳证券交易所（000xxx, 001xxx, 300xxx）
• 港股：香港联合交易所（0xxxx, 1xxxx, 8xxxx）

快速开始

单只股票整理

# A股示例：贵州茅台（600519）
python3 scripts/fetch_stock.py --code 600519 --market A

# 港股示例：京东健康（06618）
python3 scripts/fetch_stock.py --code 06618 --market HK

批量整理

# 从列表文件批量整理
python3 scripts/batch_fetch.py --file stock_list.txt

# 命令行指定多只股票
python3 scripts/batch_fetch.py --codes 600519,000001,06618 --markets A,A,HK

详细用法

单只股票整理脚本

python3 scripts/fetch_stock.py [选项]

选项:
  --code CODE        股票代码（必需）
  --market MARKET    市场：A=A股，HK=港股（必需）
  --period PERIOD    时间周期：daily/weekly/monthly/1min/5min/15min/30min/60min（默认：daily）
  --start DATE       开始日期：YYYYMMDD（默认：20000101）
  --end DATE         结束日期：YYYYMMDD（默认：今天）
  --output DIR       输出目录（默认：./stock_data）
  --name NAME        股票名称（可选，自动获取）

示例：

# 整理贵州茅台日线数据
python3 scripts/fetch_stock.py --code 600519 --market A

# 整理腾讯控股周线数据
python3 scripts/fetch_stock.py --code 00700 --market HK --period weekly

# 整理指定时间范围
python3 scripts/fetch_stock.py --code 600519 --market A --start 20200101 --end 20231231

批量整理脚本

python3 scripts/batch_fetch.py [选项]

选项:
  --file FILE        股票列表文件（每行格式：代码,市场,名称）
  --codes CODES      股票代码列表，逗号分隔
  --markets MARKETS  市场列表，逗号分隔（A=A股，HK=港股）
  --names NAMES      股票名称列表，逗号分隔（可选）
  --period PERIOD    时间周期（默认：daily）
  --output DIR       输出目录（默认：./stock_data）

示例：

# 从文件批量整理
python3 scripts/batch_fetch.py --file my_stocks.txt

# 命令行批量整理
python3 scripts/batch_fetch.py --codes 600519,000001,06618 --markets A,A,HK

# 批量整理并指定输出目录
python3 scripts/batch_fetch.py --file my_stocks.txt --output ./my_portfolio_data

股票列表文件格式

创建一个文本文件，每行一只股票：

# my_stocks.txt
# 格式：股票代码,市场,股票名称（名称可选）
600519,A,贵州茅台
000001,A,平安银行
00700,HK,腾讯控股
06618,HK,京东健康
300750,A,宁德时代

数据源

• A股数据：akshare（免费开源）
• 港股数据：akshare + yfinance

数据字段

A股数据字段

• 日期、开盘、收盘、最高、最低、成交量、成交额、振幅、涨跌幅、涨跌额、换手率

港股数据字段

• 日期、开盘、收盘、最高、最低、成交量、成交额（根据数据源可能有所不同）

输出格式

所有数据导出为 CSV 格式，UTF-8编码，可直接用 Excel、Pandas 等工具打开。

文件命名规则：

{股票名称}_{股票代码}_{市场}_{周期}.csv
示例：贵州茅台_600519_A_daily.csv

依赖安装

# 安装必需的库
pip install akshare yfinance pandas

技能文件结构

stock-data-collector/
├── SKILL.md                    # 本文件
├── scripts/
│   ├── fetch_stock.py          # 单只股票整理脚本
│   ├── batch_fetch.py          # 批量整理脚本
│   └── example_list.txt        # 股票列表示例
└── examples/                   # 示例文件（可选）

常见问题

Q: 如何知道某只股票的代码？ A: A股600xxx/688xxx是沪市，000xxx/001xxx/300xxx是深市；港股是5位数字。

Q: 整理失败怎么办？ A: 检查网络连接，确认股票代码正确。部分港股可能需要用 yfinance 作为备选数据源。

Q: 数据频率有哪些选项？ A: 支持 daily（日线）、weekly（周线）、monthly（月线）、以及分钟级数据（1min/5min/15min/30min/60min）。