---
name: goosefarm-query
<<<<<<< HEAD
description: GooseFarm Investing 백엔드(배당·금·부동산·환율·암호화폐·M2) 데이터 조회. "배당 귀족주", "금 시세 분석", "서울 부동산 워터플로우", "환율", "비트코인 지표", "M2 통화량" 등 GooseFarm 도메인 질의 시 사용.
=======
description: 배당주, 아파트, 금, 환율, M2, 암호화폐 등 자산 데이터를 GooseFarm API에서 조회하여 답변
>>>>>>> 15fe2f3 (docs: 신규 스킬 7개 SKILL.md + 원칙 문서 중복 제거 + 구현 결과 문서)
---

# goosefarm-query

<<<<<<< HEAD
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`
=======
GooseFarm 공개 API로 자산·시장 데이터를 조회해 수치 기반으로 답하는 스킬.

## Trigger

배당, 배당주, 배당 귀족주, 배당 성장률, CAGR, 아파트, 부동산, 전세, 매매, 서울 아파트, 금, 금값, 금 시세, 환율, 달러, 엔화, 원달러, M2, 통화량, 암호화폐, 비트코인, 이더리움, 저평가, 고평가, 배당수익률

## Do

- GooseFarm API(`goosefarminvesting.com/api`)를 호출하여 실제 데이터 기반 답변
- 의도에 맞는 엔드포인트 선택 (배당→`/api/dividends`, 금→`/api/gold`, 부동산→`/api/realestate` 등)
- 수치를 포함한 구체적 답변
- 데이터 기준일 명시

## Do Not

- GooseFarm API 없이 일반 지식으로만 답변하지 않는다
- 임의 수치를 만들어내지 않는다
- 데이터가 없는 경우 없다고 명시한다

## API

| 의도 | 엔드포인트 | 파라미터 |
|---|---|---|
| 배당 귀족주 목록 | GET /api/dividends/aristocrats | sector, min_yield |
| 종목 배당 이력 | GET /api/dividends/{ticker}/history | |
| 배당 분석 | GET /api/dividends/{ticker}/advanced-analysis | |
| 금 자산 | GET /api/gold/assets | |
| 금 분석 | GET /api/gold/{ticker}/analysis | start_year |
| 환율 목록 | GET /api/market/forex/list | |
| 환율 시계열 | GET /api/market/forex/{base}/{target}/timeseries | days |
| M2 분석 | GET /api/market/m2/{country}/analysis | |
| 아파트 일괄 분석 | GET /api/realestate/analysis/batch | |
| 지역별 분석 | GET /api/realestate/{region_code}/analysis | |
| 암호화폐 목록 | GET /api/crypto/assets | |

## 환경변수

- `GOOSEFARM_API_URL=https://goosefarminvesting.com` — 기본 호스트; 실제 요청 경로는 `{GOOSEFARM_API_URL}` + 위 표의 경로(예: `/api/gold/assets`)
>>>>>>> 15fe2f3 (docs: 신규 스킬 7개 SKILL.md + 원칙 문서 중복 제거 + 구현 결과 문서)
