---
name: goosefarm-query
description: GooseFarm Investing 백엔드(배당·금·부동산·환율·암호화폐·M2) 데이터 조회. "배당 귀족주", "금 시세 분석", "서울 부동산 워터플로우", "환율", "비트코인 지표", "M2 통화량" 등 GooseFarm 도메인 질의 시 사용.
---

# goosefarm-query

rb8001 `GooseFarmQueryService`가 `GOOSEFARM_API_URL`(기본 `http://192.168.0.100:8200`)로 HTTP 조회합니다.

## Trigger

- `query_dividends`: 배당 귀족주 목록 또는 티커별 배당 이력
- `query_gold`: 금(GOLD) 종합 분석
- `query_realestate`: 지역별 부동산 워터플로우(기본 seoul)
- `query_forex`: 주요 환율 목록
- `query_crypto`: 암호화폐 자산·지표 목록
- `query_m2`: M2 국가별 목록 또는 국가별 분석

## Do

- 환경변수 `GOOSEFARM_API_URL`로 베이스 URL 오버라이드
- 타임아웃 30초, 실패 시 로그 후 빈 객체 반환(상위에서 처리)

## Do Not

- GooseFarm DB에 직접 접속하지 않음(HTTP API만)

## API (GooseFarm 측)

- `GET /api/dividends/aristocrats`, `GET /api/dividends/{ticker}/history`
- `GET /api/gold/GOLD/analysis`
- `GET /api/realestate/{region}/waterflow`
- `GET /api/market/forex/list`
- `GET /api/crypto/assets`
- `GET /api/market/m2/list`, `GET /api/market/m2/{country}/analysis`