docs/TUSHARE_STOCK_LIST_GUIDE.md
从 Tushare Pro 获取 A股、港股、美股列表信息，保存为 CSV 文件到本地。
在项目根目录的 .env 文件中添加 Tushare Token：
TUSHARE_TOKEN=你的tushare_token
获取 Token：访问 Tushare Pro 注册并获取
python3 scripts/fetch_tushare_stock_list.py
数据将保存到 data/ 目录：
data/
├── stock_list_a.csv # A股列表
├── stock_list_hk.csv # 港股列表
├── stock_list_us.csv # 美股列表
└── README_stock_list.md # 数据说明文档
✅ 自动分页：美股数据自动分页读取（每页5000条） ✅ 智能限流：每次请求之间随机休息5-10秒 ✅ 错误处理：单个市场失败不影响其他市场 ✅ 进度提示：实时显示读取进度 ✅ 自动文档：生成详细的数据说明文档
| 市场 | 接口 | 积分要求 | 数据量 |
|---|---|---|---|
| A股 | stock_basic | 2000积分 | ~5000只 |
| 港股 | hk_basic | 2000积分 | ~2000只 |
| 美股 | us_basic | 120试用/5000正式 | ~10000只 |
ts_code,symbol,name,area,industry,market,exchange,list_date,...
000001.SZ,000001,平安银行,深圳,银行,主板,SZSE,19910403,...
600519.SH,600519,贵州茅台,贵州,白酒,主板,SSE,20010827,...
ts_code,name,fullname,market,list_date,trade_unit,curr_type,...
00700.HK,腾讯控股,腾讯控股有限公司,主板,20040616,100,HKD,...
00005.HK,汇丰控股,汇丰控股有限公司,主板,19750401,100,HKD,...
ts_code,name,enname,classify,list_date,...
AAPL,苹果,Apple Inc.,EQT,19801212,...
TSLA,特斯拉,Tesla Inc.,EQT,20100629,...
BABA,阿里巴巴,Alibaba Group,ADR,20140919,...
import pandas as pd
# 读取 A股
a_stocks = pd.read_csv('data/stock_list_a.csv')
print(f"A股数量: {len(a_stocks)}")
# 筛选主板股票
main_board = a_stocks[a_stocks['market'] == '主板']
print(f"主板数量: {len(main_board)}")
# 查找特定股票
stock = a_stocks[a_stocks['ts_code'] == '600519.SH']
print(stock[['name', 'industry', 'list_date']])
获取数据后，可以更新自动补全索引：
# 将 Tushare CSV 数据生成为前端自动补全索引
python3 scripts/generate_index_from_csv.py --test # 先测试
python3 scripts/generate_index_from_csv.py # 确认后生成
A: 请在 .env 文件中配置 TUSHARE_TOKEN=你的token
A:
A:
A: 建议每月更新一次，或根据需求调整