제공되는 Tool
불리자 MCP 서버가 제공하는 tool 9개의 입력·출력 명세와 자연어 호출 예시예요. 앞의 4개는 불리자가 계산을 끝낸 결과(점수·랭킹·수출), 뒤의 4개는 당신의 AI가 자기 원칙을 만들 때 쓰는 원재료(재무 스냅샷·밸류 밴드·업종 퍼센타일·가격 시계열)예요. Claude 가 자동으로 적절한 tool 을 선택해 호출하지만, 이 페이지로 어떤 게 가능한지 한 번에 파악할 수 있어요.
get_stock_score
종목 1개의 점수·괴리율·적정가
종목 코드 하나를 받아서 AI 재무진단 점수(0~100), 등급(A+~D), 산식 기반 적정가, 현재가 대비 괴리율(상승여력 %)을 반환해요. KOSPI 6자리 숫자 또는 미국 티커 입력.
| 이름 | 타입 | 설명 |
|---|---|---|
code | string (required) | KOSPI 6자리(005930) 또는 미국 티커(AAPL) |
- "삼성전자 점수 알려줘"
- "AAPL 상승여력 어느 정도야?"
- "하이닉스랑 마이크론 점수 비교해줘"
/api/public/v2/stocks/{code}/scoreget_rankings
괴리율(상승여력) TOP 랭킹
V3 산식(성장×√규모×수급)으로 계산한 점수가 높은 종목을 순위대로 반환해요. 산식 본문과 백테스트 결과도 포함.
| 이름 | 타입 | 설명 |
|---|---|---|
market | string (KR|US|KR,US, 기본 KR) | 대상 시장 |
bands | string (기본 "mega,xlarge,large") | 시총 구간 콤마. mega/xlarge/large/mid/small |
limit | integer (1~100, 기본 10) | 반환 종목 수 |
- "KOSPI 1조+ 상승여력 TOP 10 보여줘"
- "미국 메가캡 점수 상위 5개"
- "한국 중형주 중에 저평가된 종목"
/api/public/v2/rankingsget_trade_total
한국 전체 수출·수입·무역수지 시계열
관세청 OpenAPI Newtrade(산자부 매월 발표값) 기반 한국 공식 수출입 월별 시계열. 1990-01 부터 데이터 있음. 미지정 시 최근 60개월.
| 이름 | 타입 | 설명 |
|---|---|---|
from | string YYYY-MM (선택) | 시작월 |
to | string YYYY-MM (선택) | 종료월 |
- "올해 한국 수출 추세 보여줘"
- "2024년 무역수지 흑자 적자 월별로"
- "코로나 이후 수출 회복 어땠어?"
/api/public/v2/exports/totalget_sector_exports
섹터별 수출 월별 + YoY 증감률
한국 수출을 섹터(반도체·자동차·조선·이차전지 등)별로 집계한 월별 시계열에 전년동월대비(YoY) 증감률을 같이 계산. 24개월 누적 기준 상위 N 섹터.
| 이름 | 타입 | 설명 |
|---|---|---|
from | string YYYY-MM (선택) | 시작월 |
to | string YYYY-MM (선택) | 종료월 |
top | integer (1~50, 기본 10) | 상위 N 섹터 |
- "반도체 수출 살아났어?"
- "올해 가장 잘 나가는 한국 수출 섹터는?"
- "이차전지 수출 작년대비 어때?"
/api/public/v2/exports/sectorsget_stock_snapshot
종목 1개의 재무 스냅샷 (TTM)
밸류에이션(PER·PBR·EV/EBIT)·수익성(ROE·ROIC·영업이익률)·성장성(매출·EPS YoY)·안정성(순부채비율·이자보상배율·유동비율)·현금창출(영업CF·FCF수익률)·이익의 질(CF/NI·CCC)을 한 번에. 모든 값에 단위·기준 분기·공시일·가격 기준일이 붙어요. "좋다/나쁘다"는 말하지 않아요 — 해석은 당신의 AI 몫.
| 이름 | 타입 | 설명 |
|---|---|---|
code | string (required) | KOSPI 6자리(005930) 또는 미국 티커(AAPL) |
- "삼성전자 재무 요약해줘"
- "ROE 15% 이상, 순부채 없는지 확인해줘"
- "AAPL 현금흐름이 순이익보다 큰지 봐줘"
get_valuation_band
과거 자기 자신 대비 밸류에이션 위치
PER·PBR·PSR이 2020년 이후 어떤 범위(하위 5%·중앙값·상위 5%·최소·최대)에서 움직였는지, 연도별 요약, 지금 어디에 있는지. 컨센서스가 아니라 실제 공시 이익(TTM)과 일별 종가로 계산한 그 종목의 역사예요.
| 이름 | 타입 | 설명 |
|---|---|---|
code | string (required) | KOSPI 6자리 또는 미국 티커 |
type | string (per|pbr|psr, 기본 per) | 지표 종류 |
from | string YYYY-MM-DD (기본 2020-01-01) | 시작일 |
- "삼성전자 PER 역사적으로 어디쯤이야?"
- "하이닉스 PBR이 과거 중앙값보다 낮아?"
- "NVDA PER 연도별로 어떻게 변했어?"
get_sector_percentile
같은 업종 안에서 몇 번째인지
17개 재무 지표 각각이 같은 업종(또는 같은 시장) 종목들 사이에서 몇 번째인지 퍼센타일(0~100)로. 코호트 크기와 원값을 같이 줘요. "ROE 12%가 좋은 건가?"는 절대값으로는 답이 없고, 업종 안 위치로만 답이 나와요.
| 이름 | 타입 | 설명 |
|---|---|---|
code | string (required) | KOSPI 6자리 또는 미국 티커 |
cohort | string (sector|market, 기본 sector) | 비교 집단 |
- "삼성전자 수익성이 반도체 업종에서 상위 몇 %야?"
- "이 종목 부채 수준이 업종 평균보다 나빠?"
- "NVDA를 나스닥 전체와 비교하면?"
get_price_history
가격 시계열 (일·주·월봉)
시가·고가·저가·종가·거래량. 기본 최근 260 거래일, 최대 2,600봉. 이동평균·신고가·눌림목 같은 가격 규칙을 AI가 직접 계산하거나 "그때 샀으면"을 확인할 때 써요. KR 원, US 달러.
| 이름 | 타입 | 설명 |
|---|---|---|
code | string (required) | KOSPI 6자리 또는 미국 티커 |
interval | string (day|week|month, 기본 day) | 봉 단위 |
from | string YYYY-MM-DD (선택) | 시작일 |
to | string YYYY-MM-DD (선택) | 종료일 |
limit | integer (1~2600, 기본 260) | 봉 개수 상한 |
- "삼성전자 주봉 1년치 가져와서 20주 이동평균 위에 있는지 봐줘"
- "AAPL 2024년 이후 월봉"
- "최근 60일 중 고점 대비 얼마나 빠졌어?"
health
키 상태 + 사용량 확인
내 API 키가 유효한지, 현재 어떤 플랜(free/paid)인지, 오늘 몇 회 호출했는지 확인.
입력 인자 없음.
- "내 불리자 키 잘 동작해?"
- "오늘 몇 번 썼어?"
/api/public/v2/health직접 호출하기 (디버깅)
MCP 도 결국 JSON-RPC 2.0 over HTTP 라 curl 로 직접 호출할 수 있어요. tool 목록 확인:
curl -X POST https://bulliza.com/api/mcp \
-H "Authorization: Bearer rfk_live_<your-key>" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'삼성전자 점수 조회:
curl -X POST https://bulliza.com/api/mcp \
-H "Authorization: Bearer rfk_live_<your-key>" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc":"2.0","id":2,
"method":"tools/call",
"params":{"name":"get_stock_score","arguments":{"code":"005930"}}
}'