期货品种全景分析 · futures-product-analysis

输入「分析<期货品种>」，自动获取行情、资讯与基本面，生成突出操作建议的图文 HTML 分析报告。

功能特性

🔍 品种识别：支持中文名（沪银/螺纹钢/沪金/原油/豆粕…）、连续合约代码（AG0）自动归一化，覆盖上期所/大商所/郑商所/中金所/上期能源五大交易所 60+ 品种。
📈 主力合约判定：实时全合约中按持仓量最大识别主力，并解析交割月份（如 AG2610 → 2026年10月）。
📊 行情与技术指标：实时报价、近一年日线 K 线、MA5/10/20/60、RSI14、年化波动率、60 日区间位置、趋势结构。
📰 资讯与基本面：WebSearch 检索最新市场资讯与分品类基本面要点，标注来源与时间。
🎯 操作建议：综合技术面 / 基本面 / 资讯情绪给出方向（做多/做空/观望）、入场、止损、目标、仓位、逻辑与风险。
🖼️ 图文报告：自包含 HTML（内联 SVG K 线图 + 实时行情卡 + 高亮操作建议横幅），涨红跌绿，浏览器直接打开；无需 JavaScript、无需联网 CDN。

前置条件 / Prerequisites

本技能在运行时自动安装所需依赖，你基本无需任何手动预处理。

Python 3.8+：fetch_market.py / build_report.py 的运行环境。
可访问互联网：
- 首次运行 fetch_market.py 会调用内置的 ensure_akshare()，自动执行 pip install akshare（只需保证 pip 能访问 PyPI，无需你手动预装）；
- 行情数据来自 akshare / 新浪财经公开接口，需联网拉取（断网将如实报错或降级为日线快照，不会编造数字）。
（推荐）已安装 futures-data-fetcher 技能：品种中文名 → 合约代码的映射会优先复用它；缺失时回退内嵌副本（覆盖常见品种，但范围较小）。
查看报告需浏览器：报告为自包含 HTML（内联 SVG K 线图，无 JS / 无 CDN），任意浏览器原生打开即可。

使用方式

直接对 Agent 说：

分析沪银
分析螺纹钢
分析沪金
分析原油

Agent 会自动走完「解析 → 抓行情 → 搜资讯 → 研判 → 生成 HTML 报告 → 预览」全流程。

目录结构

futures-product-analysis/
├── SKILL.md                      # 触发词 / 七步流程 / 依赖与注意事项
├── README.md                     # 本文件
├── LICENSE.md                    # MIT 许可证
├── scripts/
│   ├── fetch_market.py           # 主力合约 + 实时报价 + 日线 K 线 + 技术指标（首次运行自动装 akshare）
│   └── build_report.py           # 渲染图文 HTML 报告（内联 SVG K 线图）
└── references/
    └── fundamentals_guide.md     # 分品种基本面研究要点

注：assets/cover.png 为本地封面图，仅用于本地预览，不纳入发布包（skillhub 服务端仅放行文本类文件）。

快速验证（命令行）

# 1) 抓取市场数据（沪银示例）—— 首次运行会自动 pip install akshare
python scripts/fetch_market.py --name 沪银 --output market.json

# 2) 在 market.json 基础上补充 technical_summary / fundamentals / news / recommendation，
#    另存为 analysis.json

# 3) 生成报告
python scripts/build_report.py --input analysis.json --output 沪银_分析报告.html

注意事项

数据来源：新浪财经 / akshare 公开接口，行情为延迟快照，非逐笔实时。
报告含免责声明：本报告由 AI 自动生成，仅供研究参考，不构成投资建议。
网络受限（akshare 不可达）时，工具会如实告知数据获取失败，不会编造行情数字。

License

MIT