SKILL.md
AKShare 金融数据获取
任务目标
- 本 Skill 用于：通过 AKShare 接口获取全品类金融市场数据
- 能力包含：股票、期货、期权、基金、外汇、债券、指数、加密货币、宏观经济等数据
- 触发条件：用户提及 AKShare 或需要获取各类金融数据时
前置准备
- 依赖说明：安装 akshare 库（已包含在 dependency 中）
- 凭证配置：AKShare 无需注册或 API Key，直接调用即可使用
- 环境要求：Python 3.9+，建议定期更新
pip install akshare --upgrade
操作步骤
- 标准流程：
1. 确定数据需求 — 智能体理解用户意图（股票/期货/基金/外汇等） 2. 调用对应脚本 — 根据数据类型选择脚本 3. 解析结果 — 智能体分析返回的 JSON 格式数据
- 脚本调用映射：
- 股票数据 → python scripts/stockdata.py --type hist --symbol 000001 --start 20240101 --end 20240131 - 期货数据 → python scripts/futuresdata.py --type daily --exchange CFFEX --start 20240101 --end 20240131 - 基金数据 → python scripts/funddata.py --type etf --symbol 510300 - 外汇数据 → python scripts/forexdata.py --type spot --symbol usd - 宏观经济 → python scripts/macrodata.py --type gdp - 加密货币 → python scripts/cryptodata.py --type price --symbol BTC/USDT
- 可选分支：
- 当需要多只标的：使用逗号分隔多个代码 - 当需要指定周期：使用 --period 参数（daily/weekly/monthly） - 当需要复权数据：使用 --adjust 参数（qfq/hfq/空值）
使用示例
- 示例1：获取股票历史K线
- 场景/输入：用户说"获取贵州茅台2024年的日K线数据" - 预期产出：返回日期、开盘价、最高价、最低价、收盘价、成交量等OHLCV数据 - 关键要点：调用 python scripts/stock_data.py --type hist --symbol 600519 --start 20240101 --end 20241231 --period daily --adjust qfq
- 示例2：获取期货数据
- 场景/输入：用户说"查看沪深300股指期货数据" - 预期产出：返回期货合约的K线数据、持仓量、成交量等信息 - 关键要点：调用 python scripts/futures_data.py --type daily --symbol IF2406 --start 20240101 --end 20240131
- 示例3：获取基金数据
- 场景/输入：用户说"查询沪深300ETF的行情" - 预期产出：返回ETF的实时行情或历史净值数据 - 关键要点：调用 python scripts/fund_data.py --type etf --symbol 510300
- 示例4：获取宏观经济数据
- 场景/输入：用户说"查看中国GDP数据" - 预期产出：返回GDP历史数据和最新值 - 关键要点：调用 python scripts/macro_data.py --type gdp
数据分类详解
完整的 API 函数清单（70+ 个接口，覆盖股票/期货/基金/期权/债券/外汇/指数/加密货币/宏观经济/特色数据）见 [references/api-catalog.md](references/api-catalog.md)。
快速索引：
- 股票 →
ak.stockzhahist(),ak.stockzhaspot_em() - 期货 →
ak.futureszhspot(),ak.getfuturesdaily() - 基金 →
ak.fundetfspotem(),ak.fundetfhistem() - 宏观 →
ak.macrochinagdp(),ak.macrousacpi_monthly() - 特色 →
ak.stocklhbdetailem()（龙虎榜）,ak.stockhsgthistem()（北向资金）
资源索引
脚本：
- [scripts/stockdata.py](scripts/stockdata.py)（用途与参数：获取股票K线/行情/财务数据，支持 --type/--symbol/--start/--end/--period/--adjust）
- [scripts/futuresdata.py](scripts/futuresdata.py)（用途与参数：获取期货数据，支持 --type/--symbol/--exchange/--start/--end）
- [scripts/funddata.py](scripts/funddata.py)（用途与参数：获取基金数据，支持 --type/--symbol/--start/--end）
- [scripts/forexdata.py](scripts/forexdata.py)（用途与参数：获取外汇贵金属数据，支持 --type/--symbol）
- [scripts/macrodata.py](scripts/macrodata.py)（用途与参数：获取宏观经济数据，支持 --type）
- [scripts/cryptodata.py](scripts/cryptodata.py)（用途与参数：获取加密货币数据，支持 --type/--symbol/--period）
- [scripts/indexdata.py](scripts/indexdata.py)（用途与参数：获取指数数据，支持 --type/--symbol/--start/--end）
- [scripts/optiondata.py](scripts/optiondata.py)（用途与参数：获取期权数据，支持 --type/--symbol）
- [scripts/bonddata.py](scripts/bonddata.py)（用途与参数：获取债券数据，支持 --type/--symbol）
- [scripts/specialdata.py](scripts/specialdata.py)（用途与参数：获取龙虎榜/融资融券/北向资金等特色数据，支持 --type/--symbol/--start/--end）
参考文档：
- [API 函数速查表](references/api-catalog.md)（何时读取：需要查看完整 AKShare API 函数清单时）
- [股票数据文档](references/stock.md)（何时读取：需要查看股票相关API参数说明时）
- [期货数据文档](references/futures.md)（何时读取：需要查看期货相关API参数说明时）
- [基金数据文档](references/fund.md)（何时读取：需要查看基金相关API参数说明时）
- [宏观经济文档](references/macro.md)（何时读取：需要查看宏观数据API参数说明时）
- AKShare官方文档（何时读取：需要查看最新API文档时）
注意事项
- AKShare 无需注册或 API Key，直接调用即可使用
- A股股票代码格式：纯数字代码（如 000001、600519），不带市场前缀
- 港股股票代码格式：纯数字代码（如 00700）
- 美股股票代码格式：英文代码（如 AAPL、TSLA）
- 数据列名：A股数据为中文列名，美股/港股数据为英文列名
- 建议定期更新AKShare版本：
pip install akshare --upgrade - 由于上游数据源变化，接口更新频繁，遇到错误时可先尝试更新版本
- 脚本返回 JSON 格式数据，智能体负责解析并转换为用户友好的展示
- 非Python用户可使用 AKTools HTTP API封装
- 数据仅供学术研究使用，不构成投资建议
快速参考
函数命名规则
{asset_type}_{market}_{data_type}_{data_source}- Asset type:
stock（股票）,futures（期货）,fund（基金）,bond（债券）,forex（外汇）,option（期权）,macro（宏观）,index（指数） - Market:
zh（中国）,us（美国）,hk（香港）, 或交易所代码 - Data type:
spot（实时）,hist（历史）,daily（日线）,minute（分钟） - Data source:
em（东方财富）,sina（新浪财经）, 交易所缩写
复权类型
""- 不复权"qfq"- 前复权"hfq"- 后复权
周期类型
"daily"- 日线"weekly"- 周线"monthly"- 月线"1","5","15","30","60"- 分钟线