核心用法
metal-price 是一款專為 AI Agent 設計的每日有色金屬行情監測與投研報告自動化工具。用戶僅需配置 Telegram Bot Token 與 Chat ID，即可在每日 14:00 CST（上午盤收盤後）自動觸發：從 Yahoo Finance、CCMN 長江有色、SMM 上海有色、Westmetall 等多個免費數據源採集銅、鋅、鎳、鈷、鉍、鎂六大品種的實時價格、LME 庫存、遠期曲線結構及市場新聞，經四交叉推理（宏觀×庫存×期貨結構×情緒）生成六板塊專業投研報告，並通過 Telegram 推送。
技術實現採用 Node.js 腳本化架構，支持 OpenClaw Cron 定時調度，核心腳本分離為數據採集（fetch-all-data.mjs，約 5 秒完成）、日報生成（daily-report.mjs）與消息推送（send-telegram.mjs）三個模組。報告格式嚴格遵循機構投研標準：行情快照、行業指數（XME/COPX/申萬有色）、技術面（支撐阻力/趨勢/遠期結構）、基本面（LME 庫存/去累庫信號）、市場情緒（機構觀點提煉）、四維推理與操作參考。
顯著優點
1. 多源交叉驗證：同一品種同時抓取 USD（國際）與 CNY（國內）報價，CCMN 與 SMM 雙源交叉，降低單點數據失真風險
2. 零付費門檻：完全基於公開可爬取的免費數據源（Yahoo Finance、Westmetall、CCMN、SMM、Google News RSS 等），無需訂閱 LME、Bloomberg 或 Wind 等付費終端
3. 機構級輸出格式：六板塊結構涵蓋技術面遠期曲線（Spot/+2M/+6M）、Backwardation/Contango 結構判斷、具體價位操作建議（支撐/阻力/止損），非泛泛情緒描述
4. 自動化閉環：從採集、分析到推送全鏈條無人值守，支持 OpenClaw Cron 定時觸發，適合量化團隊與商品研究員的日報工作流
5. 時效性過濾：新聞模組嚴格執行 48 小時時效過濾，避免過期資訊干擾決策；機構觀點自動提煉中文結論，不堆原始鏈接
潛在缺點與局限性
1. 數據源穩定性風險：依賴網頁抓取（Yahoo Finance、CCMN、SMM、TradingEconomics 等），目標網站反爬策略變更或結構調整可能導致採集失敗；LME 官方庫存已被 Cloudflare 封鎖，目前以 Westmetall 替代，存在單點依賴
2. 品種覆蓋有限：明確排除鋁（Al），僅覆蓋 Cu/Zn/Ni/Co/Bi/Mg 六個品種，對於需要鋁、鉛、錫、貴金屬或能源金屬（鋰）的用戶需額外擴展
3. 無歷史數據存儲：設計為「日報生成即發送」模式，未提及本地數據庫持久化，無法直接支持長時間序列回測或趨勢比較
4. 情緒指標相對簡陋：Reddit r/Commodities 與 Google News 的情緒提取屬於淺層 NLP，缺乏專業的社交情緒加權模型或資金流向數據
5. 操作建議免責缺失：雖提供具體價位建議，但未見風險提示或免責聲明模組，機構合規場景需自行補充
適合人群
- 商品期貨量化交易員：需要每日盤後快速獲取多品種技術面與基本面交叉分析的系統化交易者
- 有色金屬產業研究員：覆蓋銅、鋅、鎳、鈷等工業金屬的券商/期貨公司研究所分析師，用於日報底稿自動生成
- 跨市場套利策略師：關注 LME/COMEX 與上海期貨市場價差、進口盈虧、保稅庫存變化的套利團隊
- AI Agent 開發者：需要集成現成、無 API 成本的商品數據採集模組，構建自動化投研工作流的技術團隊
常規風險
1. 數據滯後與錯誤：免費數據源可能存在 15 分鐘至數小時延遲，極端行情下網站更新頻率下降；網頁結構變更導致解析錯誤，可能輸出過期或錯誤價格
2. 網絡與執行失敗：腳本依賴境外數據源（Yahoo、Westmetall、Reddit），國內部署需考慮代理穩定性；單次執行超時設置為 90 秒，複雜網絡環境下可能中斷
3. 合規與版權：抓取 CCMN、SMM 等商業網站數據用於自動化分發，需關注目標網站的 Terms of Service；機構內部使用建議確認數據二次分發的合規邊界
4. Telegram 依賴：推送依賴 Telegram Bot API，對於無法訪問 Telegram 的網絡環境或企業內網，需額外配置消息中轉或改用其他通道
5. 模型幻覺風險：「四維交叉推理」與「機構觀點提煉」涉及 AI 生成內容，可能存在邏輯跳躍或過度解讀，建議關鍵決策前人工复核原始數據