fred
回覆語言：符合使用者輸入（zh-CN / zh-TW / en）。
使用時機
觸發詞：
- CPI / 核心 CPI / PCE / PPI / 通膨 / 核心通膨
- GDP / 國內生產總值
- 失業率 / U-3 / U-6 / 非農就業
- 聯邦基金利率 / 聯準會利率 / SOFR
- 2Y / 10Y 收益率 / 收益率曲線 / 美債利率 / 收益率曲線
- M1 / M2 / 貨幣供應量
- DXY / 美元指數 / USD index
- VIX / 10Y 平衡通膨率 / 通膨預期
- WTI / Brent / 油價 / gold
- 消費者信心 / 消費者信心指數 / 房屋開工 / 零售銷售
工作流程
- 將使用者措辭解析為 FRED 系列 ID — 首先透過
aliases.json（精選對應），若無別名匹配則使用search.py。 - 執行
series.py <SERIES_ID|alias>以獲取觀測值與元數據。 - 合成自然語言回覆，包含單位、頻率與最後更新日期；署名「資料來源：聖路易斯聯邦儲備銀行 (FRED)」。
環境變數會在腳本匯入時從專案根目錄的 .env 自動載入（或備用路徑 ~/.config/market-intel/env），無需手動執行 source。
CLI 範例
# 最新 60 筆月 CPI 觀測值
python3 .claude/skills/fred/scripts/series.py CPI
# 2 年期公債收益率，最近 30 筆日觀測值
python3 .claude/skills/fred/scripts/series.py "2Y yield" --limit 30
# 10 年平衡通膨率，自訂區間，升序
python3 .claude/skills/fred/scripts/series.py T10YIE --start 2024-01-01 --order asc
# 查詢系列 ID
python3 .claude/skills/fred/scripts/search.py "consumer price index" --limit 10
# 略過快取
python3 .claude/skills/fred/scripts/series.py CPI --fresh
輸出格式
{
"ok": true,
"data": [{"date": "2026-04-01", "value": 314.2}, ...],
"meta": {
"series_id": "CPIAUCSL",
"title": "Consumer Price Index for All Urban Consumers: All Items",
"units": "Index 1982-1984=100",
"frequency": "Monthly",
"seasonal_adjustment": "SA",
"last_updated": "2026-05-13 07:36:01-05",
"count_returned": 60,
"alias_resolved": "CPI"
}
}
可用別名
請參閱 aliases.json 以取得精選的中/英文 → 系列 ID 對應表。常見範例如下：
| 別名 | 系列 ID |
|---|---|
| CPI | CPIAUCSL |
| 核心 CPI / core CPI | CPILFESL |
| PCE | PCEPI |
| GDP | GDPC1 |
| 失業率 / unemployment | UNRATE |
| 非農 / nonfarm | PAYEMS |
| 聯邦基金利率 / Fed funds | DFF |
| 美債 10 年 / 10Y yield | DGS10 |
| 收益率曲線 / yield curve | T10Y2Y |
| 美元指數 / DXY | DTWEXBGS |
| M2 | M2SL |
| VIX | VIXCLS |
| 通膨預期 / 10Y breakeven | T10YIE |
若使用者的措辭不在對應表中，則回退至 search.py "<查詢>" 並選取人氣最高且非停用的結果。
錯誤處理
| 退出碼 | 意義 | LLM 行動 |
|---|---|---|
| 0 | 成功 | 解析 data，進行說明。 |
| 2 | 缺少 FRED_API_KEY | 告知使用者前往 https://fred.stlouisfed.org/docs/api/api_key.html 註冊，並在專案根目錄的 .env 中加入。 |
| 3 | HTTP 4xx 或非 JSON 回應 | 根據 hint 顯示錯誤資訊。 |
| 4 | 網路錯誤 | 建議使用者重試。 |
已知限制
- 日資料系列可能因週末或假日而出現空缺（FRED 將 NaN 回傳為
.；我們會正規化為null）。 search.py預設會過濾「已停用」的系列 — 使用--include-discontinued可覆蓋此設定。- 系列元資料快取 TTL 為 24 小時；觀測值快取 TTL 為 1 小時。使用
--fresh可取得最新資料。
相關技能
longbridge-quote：提供即時股票報價。gdelt：提供敘事 / 情緒背景。sec-edgar：提供個別公司申報文件。