detect-freight-led-inflation-turn

<essential_principles>

CASS Freight Index 由 Cass Information Systems 編制，追蹤北美地區的貨運出貨量與支出：

指標	說明	用途
Shipments Index	出貨量指數	衡量實體經濟需求強度
Expenditures Index	運費支出指數	衡量物流成本壓力
Shipments YoY	出貨量年增率	偵測週期轉折（主要分析指標）
Expenditures YoY	支出年增率	驗證成本傳導

數據來源：MacroMicro (透過 Highcharts 爬取)

核心邏輯：

• 貨運量 ≈ 實體經濟需求強度
• 出貨量下降 → 終端需求減弱 → 定價能力下降
• 歷史上 CASS 指標對 CPI 具有約 4-6 個月的領先性

關鍵訊號不是單月變化，而是「週期轉折」：

• 年增率轉負 (turned negative)
• 創週期新低 (new cycle low)

當偵測到 CASS 週期轉折：

• 結論是「通膨壓力緩解」而非「通縮」
• 屬於 inflation easing / disinflation regime
• 支持市場對降息或政策轉向的預期

這是跨週期關係辨識：「物流需求動能 → 通膨方向」

建議同時觀察四個 CASS 指標：

1. Shipments YoY（主要）：需求端訊號
2. Expenditures YoY：成本端訊號
3. Shipments Index：絕對水準
4. Expenditures Index：運費壓力

當 Shipments 和 Expenditures 同時轉負，訊號更為可靠。

</essential_principles>

輸出三層訊號：

1. Freight Status: CASS 各指標狀態與週期位置
2. Lead Alignment: 與 CPI YoY 的領先對齊分析
3. Signal Assessment: 通膨緩解訊號判斷與信心水準

<quick_start>

最快的方式：使用 Chrome CDP 抓取數據

Step 1：安裝依賴

pip install requests websocket-client pandas numpy

Step 2：啟動 Chrome 調試模式

# Windows
"C:\Program Files\Google\Chrome\Application\chrome.exe" ^
  --remote-debugging-port=9222 ^
  --remote-allow-origins=* ^
  --user-data-dir="%USERPROFILE%\.chrome-debug-profile" ^
  "https://www.macromicro.me/charts/46877/cass-freight-index"

Step 3：等待頁面完全載入（圖表顯示），然後執行

cd scripts
python fetch_cass_freight.py --cdp

Step 4：執行通膨訊號分析

python freight_inflation_detector.py --quick

Step 5：生成視覺化圖表

python visualize_freight_cpi.py \
  --cache cache/cass_freight_cdp.json \
  --output ../../output/freight_cpi_$(date +%Y-%m-%d).png \
  --start 1995-01-01

輸出範例：

• JSON 分析結果：

{
  "signal": "inflation_easing",
  "confidence": "high",
  "freight_yoy": -7.46,
  "cycle_status": "negative",
  "indicator": "shipments_yoy",
  "macro_implication": "通膨壓力正在放緩，未來 CPI 下行風險上升"
}

• 視覺化圖表：output/freight_cpi_2026-01-23.png

備選方法（Selenium）：

pip install selenium webdriver-manager
python scripts/fetch_cass_freight.py --selenium --no-headless

</quick_start>

1. 快速檢查 - 查看最新的 CASS 指標與通膨先行訊號
2. 完整分析 - 執行完整的週期轉折偵測與領先性分析
3. 方法論學習 - 了解 CASS 指標與通膨的領先關係

請選擇或直接提供分析參數。

路由後，閱讀對應文件並執行。

<directory_structure>

detect-freight-led-inflation-turn/
├── SKILL.md                           # 本文件（路由器）
├── skill.yaml                         # 前端展示元數據
├── manifest.json                      # 技能元資料
├── workflows/
│   ├── analyze.md                     # 完整分析工作流
│   └── quick-check.md                 # 快速檢查工作流
├── references/
│   ├── data-sources.md                # CASS 數據來源與爬蟲說明
│   ├── methodology.md                 # 領先性方法論解析
│   └── historical-episodes.md         # 歷史案例對照
├── templates/
│   ├── output-json.md                 # JSON 輸出模板
│   └── output-markdown.md             # Markdown 報告模板
├── scripts/
│   ├── fetch_cass_freight.py          # MacroMicro CASS 爬蟲
│   ├── fetch_via_cdp.py               # Chrome CDP 爬蟲模組
│   ├── freight_inflation_detector.py  # 主分析腳本
│   └── visualize_freight_cpi.py       # CASS vs CPI 領先性視覺化
└── examples/
    └── sample_output.json             # 範例輸出

</directory_structure>