kansoku-trade/kansoku

fred

Antwortsprache: der Benutzereingabe entsprechend (zh-CN / zh-TW / en).

Verwendungshinweise

Auslösephrasen:

• CPI / Kern-CPI / PCE / PPI / Inflation / 通胀 / 核心通胀
• BIP / 国内生产总值
• Arbeitslosigkeit / 失业率 / U-3 / U-6 / Nonfarm / 非农
• Fed Funds / 联储利率 / SOFR
• 2Y / 10Y Rendite / Zinskurve / 美债利率 / 收益率曲线
• M1 / M2 / Geldmenge / 货币供应
• DXY / 美元指数 / USD index
• VIX / 10Y Breakeven / Inflationserwartung / 通胀预期
• WTI / Brent / Ölpreis / Gold
• Verbrauchervertrauen / 消费者信心 / Wohnungsbaubeginne / Einzelhandelsumsätze

Arbeitsablauf

1. Auflösen der Benutzerformulierung zu einer FRED-Serien-ID – zuerst über aliases.json (kuratiert), dann über search.py, falls kein Alias passt.
2. Ausführen von series.py <SERIES_ID|alias> für Beobachtungen + Metadaten.
3. Synthetisieren einer Antwort in natürlicher Sprache mit Einheiten, Häufigkeit und letztem Aktualisierungsdatum; Quellenangabe: „Quelle: St. Louis Fed (FRED)“.

Die Umgebung wird beim Import des Skripts automatisch aus der .env-Datei im Projektstammverzeichnis (oder als Fallback aus ~/.config/market-intel/env) geladen – kein manuelles source erforderlich.

CLI-Beispiele

# Die letzten 60 monatlichen CPI-Beobachtungen
python3 .claude/skills/fred/scripts/series.py CPI

# 2J-Rendite, die letzten 30 täglichen Beobachtungen
python3 .claude/skills/fred/scripts/series.py "2Y yield" --limit 30

# 10-jährige Breakeven-Inflation, benutzerdefiniertes Fenster, aufsteigend
python3 .claude/skills/fred/scripts/series.py T10YIE --start 2024-01-01 --order asc

# Serien-IDs entdecken
python3 .claude/skills/fred/scripts/search.py "consumer price index" --limit 10

# Cache umgehen
python3 .claude/skills/fred/scripts/series.py CPI --fresh

Ausgabeformat

{
  "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"
  }
}

Verfügbare Aliase

Siehe aliases.json für die kuratierte CN/EN → Serien-ID-Zuordnung. Die häufigsten sind:

Alias	Serien-ID
CPI	CPIAUCSL
core CPI / 核心 CPI	CPILFESL
PCE	PCEPI
GDP	GDPC1
unemployment / 失业率	UNRATE
nonfarm / 非农	PAYEMS
Fed funds / 联储利率	DFF
10Y yield / 美债 10 年	DGS10
yield curve	T10Y2Y
DXY / 美元指数	DTWEXBGS
M2	M2SL
VIX	VIXCLS
10Y breakeven / 通胀预期	T10YIE

Wenn die Phrase des Benutzers nicht in der Karte enthalten ist, greifen Sie auf search.py "<Abfrage>" zurück und wählen Sie das Ergebnis mit der höchsten Popularität, das nicht eingestellt ist.

Fehlerbehandlung

Exit-Code	Bedeutung	LLM-Aktion
0	Erfolg	Analysieren Sie data, berichten Sie.
2	Fehlender FRED_API_KEY	Teilen Sie dem Benutzer mit, dass er sich unter https://fred.stlouisfed.org/docs/api/api_key.html registrieren und den Schlüssel in die .env-Datei im Projektstammverzeichnis einfügen soll.
3	HTTP 4xx oder nicht-JSON	Den Fehler aus hint anzeigen.
4	Netzwerk	Wiederholung vorschlagen.

Bekannte Einschränkungen

• Tägliche Serien können Wochenend-/Feiertagslücken aufweisen (FRED gibt NaN als . zurück; wir normalisieren zu null).
• „Eingestellte“ Serien werden in search.py standardmäßig gefiltert – mit --include-discontinued überschreiben.
• Cache-TTL für Serienmetadaten: 24 h; Cache-TTL für Beobachtungen: 1 h. Verwenden Sie --fresh für die aktuellsten Daten.

Verwandte Skills

• longbridge-quote für Live-Aktienkurse.
• gdelt für Narrative / Stimmungskontext.
• sec-edgar für Einzelunternehmenseinreichungen.