核心用法
metal-price 是一款面向 AI Agent 的有色金属日频行情监测技能，通过定时任务（OpenClaw Cron 或本地 cron）驱动数据采集→分析→推送的完整闭环。用户仅需配置 Telegram Bot Token 与 Chat ID，即可在每日 14:00 CST 自动获取覆盖铜、锌、镍、钴、镁、铋六大品种的六板块投研报告。
执行路径：运行 daily-report.mjs → 调用 fetch-all-data.mjs 聚合多源数据（~5秒）→ 生成技术分析与基本面推理 → Telegram 推送结构化报告。支持 DRY_RUN 模式安全预览，避免误发。
---
显著优点
1. 多源交叉验证，零 API 成本
整合 Yahoo Finance（美元计价）、CCMN 长江有色、SMM 上海有色、Westmetall（LME 数据）四大免费数据源，通过同一品种多平台比价实现交叉验证，规避单源故障或数据操纵风险。全程无需付费 API 密钥。
2. 六板块专业投研框架
报告采用机构级结构：行情快照 → 行业指数（XME/COPX/申万有色 A/H 分化）→ 技术面（支撑/阻力/远期曲线 Backwardation/Contango 判断）→ 基本面（LME 库存+去库累库信号）→ 市场情绪（高盛/摩根/花旗观点中文提炼）→ 四维交叉推理（宏观×库存×结构×情绪）+ 具体操作价位建议。非泛泛而谈，具备实操参考价值。
3. 智能时效与抗重复机制
新闻模块强制 48 小时时效过滤，过期条目自动剔除；机构观点采用「今日新增」模式，对比昨日差异输出，无新增时明示「第七部分无新增」，有效抑制大模型幻觉与内容重复。
4. 渐进式功能演进
从 v1.1 到 v1.3，持续迭代 LME 库存、期货远期曲线、进口盈亏/到岸成本、四维信号打分、宏观风险温度计（DXY/VIX/CRB/10Y 占位）等模块，框架预留扩展接口。
---
潜在缺点与局限性
数据源脆弱性：核心依赖 CCMN、SMM、Westmetall 等第三方免费站点，无 SLA 保障。对方反爬升级或页面改版可能导致采集失败；LME 官方已被 Cloudflare 封锁，目前依赖 Westmetall 替代，存在单点风险。
覆盖品种受限：明确排除铝（Al），镁、钴、铋等小众品种的中文数据源深度不及铜锌镍，可能导致分析维度不均衡。
汇率与单位换算盲区：USD/CNY 报价并存但未显式展示实时汇率换算，跨市场套利信号需用户自行计算。
Telegram 单通道依赖：推送渠道仅支持 Telegram，无邮件/企业微信/钉钉等多端适配，企业内网环境可能受限。
机构观点提炼质量波动：依赖大模型对英文研报的中文摘要，存在过度简化或语义偏移风险，且无法追溯原始报告全文核对。
---
适合人群
- 大宗商品量化研究员：需要低成本、结构化的日频金属数据馈送
- 期货/期权个人交易者：关注 LME 与内盘价差、期限结构、库存信号
- 产业投资者（铜锌镍钴镁铋产业链）：跟踪现货报价与宏观情绪交叉验证
- AI Agent 开发者：作为 OpenClaw 定时任务编排的标杆案例，学习多源数据聚合与报告生成模式
---
常规风险
- 数据延迟风险：免费源更新频率不一，极端行情下可能出现分钟级延迟，不适合高频交易决策
- 采集失败静默风险：若数据源全量失效，脚本可能输出缺字段的残缺报告，需关注前置自检提示
- 模型幻觉风险：情绪分析、机构观点提炼环节存在大模型生成不实信息的可能，v1.3.1+ 虽已加「无新增明示」机制，仍需人工复核关键结论
- 合规风险：部分数据源（如 TradingEconomics）通过爬虫获取，需用户自行评估当地数据使用法规与网站 ToS