fred
응답 언어: 사용자 입력과 일치 (zh-CN / zh-TW / en).
사용 시기
트리거 구문:
- CPI / 근원 CPI / PCE / PPI / 인플레이션 / 通胀 / 核心通胀
- GDP / 国内生产总值
- 실업률 / 失业率 / U-3 / U-6 / 비농업 고용 / 非农
- 연방 기금 금리 / 联储利率 / SOFR
- 2년물 / 10년물 수익률 / 수익률 곡선 / 美债利率 / 收益率曲线
- M1 / M2 / 통화 공급 / 货币供应
- DXY / 달러 인덱스 / 美元指数 / USD index
- VIX / 10년물 손익분기 인플레이션 / 通胀预期
- WTI / Brent / 원유 가격 / 油价 / 금
- 소비자 심리 / 消费者信心 / 주택 착공 / 소매 판매
워크플로우
- 사용자의 표현을 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": "모든 도시 소비자를 위한 소비자 물가 지수: 전체 품목",
"units": "지수 1982-1984=100",
"frequency": "월간",
"seasonal_adjustment": "계절 조정",
"last_updated": "2026-05-13 07:36:01-05",
"count_returned": 60,
"alias_resolved": "CPI"
}
}
사용 가능한 별칭
aliases.json에서 큐레이트된 중문/영문 → 시리즈 ID 매핑을 확인하세요. 일반적인 것:
| 별칭 | 시리즈 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 |
사용자의 표현이 매핑에 없으면 search.py "<query>"로 폴백하여 가장 인기 있고 중단되지 않은 결과를 선택합니다.
오류 처리
| 종료 코드 | 의미 | 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: 개별 기업 공시용.