akshare-stock-analysis

# AKShare Stock Analysis Skill 基于 AKShare 实现股票/基金/期货数据查询、技术指标计算、持仓诊断等能力，通过命令行（CLI）快速调用，输出结构化 JSON 结果。 ## 环境依赖 使用本技能前需确保已安装 akshare： ```bash pip install akshare --upgrade pip install pandas numpy ``` 验证安装： ```bash python -c "import akshare as ak; print(ak.__version__)" ``` ## 核心 CLI 脚本 本技能封装了 `scripts/akshare_cli.py` CLI 工具，支持以下命令： ### 1. 实时行情查询 ```bash python scripts/akshare_cli.py spot [--code 股票代码] ``` - 不带 `--code`：返回全市场行情（前100条） - 带 `--code`：返回指定股票行情 **输出字段**：代码、名称、最新价、涨跌幅、涨跌额、成交量、成交额、换手率、市盈率、市净率 ### 2. 技术指标分析 ```bash python scripts/akshare_cli.py tech --code 股票代码 --start 开始日期 --end 结束日期 ``` **示例**： ```bash python scripts/akshare_cli.py tech --code 600000 --start 20240101 --end 20241231 ``` **输出指标**：日期、收盘价、MA5/MA10/MA20、DIF、DEA、MACD、RSI ### 3. 持仓诊断 ```bash python scripts/akshare_cli.py diagnose --holdings '持仓JSON字符串' ``` **示例**： ```bash python scripts/akshare_cli.py diagnose --holdings '[{"code":"600000","name":"浦发银行","cost":8.5,"shares":1000}]' ``` **输出**：总盈亏、各持仓明细（成本、现价、盈亏金额、盈亏比例、风险等级） ### 4. 热点板块 ```bash python scripts/akshare_cli.py plates ``` **输出**：涨幅前10的板块（板块名称、涨跌幅、换手率、成交额） ### 5. 财经数据汇总 ```bash python scripts/akshare_cli.py summary ``` **输出**：大盘指数（上证/深证/创业板）、涨跌家数、北向资金 ### 6. 个股详情 ```bash python scripts/akshare_cli.py detail --code 股票代码 ``` **输出**：个股完整行情数据（最新价、涨跌幅、成交量、成交额、换手率、市盈率、市净率、总市值、流通市值等） ### 7. 历史K线 ```bash python scripts/akshare_cli.py kline --code 股票代码 --start 开始日期 --end 结束日期 [--period 周期] ``` **周期参数**：daily（日线，默认）、weekly（周线）、monthly（月线） ### 8. 北向资金 ```bash python scripts/akshare_cli.py northbound ``` **输出**：近期北向资金净流入数据 ## 使用场景示例 ### 场景1：查询今日行情 用户说："今天大盘怎么样？"、"看看今日行情" → 调用 `python scripts/akshare_cli.py summary` ### 场景2：分析个股技术指标 用户说："分析一下600000的技术指标"、"帮我看看浦发银行的MACD" → 调用 `python scripts/akshare_cli.py tech --code 600000 --start 20240101 --end 20241231` （日期范围根据当前日期自动推算近一年） ### 场景3：持仓诊断 用户说："帮我诊断一下持仓"、"我的股票收益怎么样" → 询问用户持仓信息，构建 JSON 后调用 `diagnose` 命令 ### 场景4：热点板块 用户说："今天哪些板块涨得好？"、"热点板块有哪些？" → 调用 `python scripts/akshare_cli.py plates` ### 场景5：查询单只股票 用户说："600000现在多少钱？"、"浦发银行今天涨了没？" → 调用 `python scripts/akshare_cli.py spot --code 600000` ## 数据输出格式 所有命令输出均为 JSON 格式，便于解析和展示。 ### 实时行情示例 ```json [ { "代码": "600000", "名称": "浦发银行", "最新价": 8.62, "涨跌幅": 0.23, "涨跌额": 0.02, "成交量": 12345678, "成交额": 106432156.96, "换手率": 0.08, "市盈率": 6.23, "市净率": 0.45 } ] ``` ### 技术指标示例 ```json [ { "日期": "2024-12-30", "收盘": 8.62, "MA5": 8.58, "MA10": 8.55, "MA20": 8.51, "DIF": 0.05, "DEA": 0.04, "MACD": 0.02, "RSI": 58.23 } ] ``` ### 持仓诊断示例 ```json { "总盈亏": 740.0, "明细": [ { "代码": "600000", "名称": "浦发银行", "成本": 8.5, "现价": 8.62, "盈亏": 120.0, "盈亏率(%)": 1.41, "风险等级": "低" } ] } ``` ## 错误处理 - 数据获取失败时返回 `{"error": "错误信息", "code": "DATA_GET_FAILED"}` - 股票代码不存在时返回空数组或错误提示 - 网络超时默认10秒，可在脚本中调整 ## 注意事项 1. **调用频率**：避免高频调用，建议接口间隔 ≥1秒 2. **数据来源**：主要来自东方财富、同花顺等公开数据源 3. **股票代码格式**：使用6位纯数字（如 600000、000858、300750） 4. **交易时间**：实时数据仅交易时间更新，非交易时间为收盘数据