---
name: goosefarm-query
description: 배당주, 아파트, 금, 환율, M2, 암호화폐 등 자산 데이터를 GooseFarm API에서 조회하여 답변
runtime:
  kind: external_http
  service_url_env: GOOSEFARM_API_URL
---

# goosefarm-query

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`)