cn-funds-mcp 사용 가이드
도구 빠른 참조
펀드 조회
| 도구 | 용도 | 주요 파라미터 |
|---|---|---|
search_fund | 펀드 검색 (이름/코드/병음) | keyword |
get_fund_estimate | 실시간 평가 (장중 추정 순자산가치 및 변동률) | fundCode |
get_fund_batch_info | 여러 펀드 순자산가치 일괄 조회 | fundCodes (쉼표 구분) |
get_fund_info | 펀드 상세 (유형/회사/운용사/규모/순위) | fundCode |
get_fund_valuation_detail | 당일 평가 추이 (일중 시분할) | fundCode |
get_fund_net_value_history | 역사적 순자산가치 추이 | fundCode, range |
get_fund_accumulated_performance | 누적 수익 vs CSI 300 vs 동종 | fundCode, range |
get_fund_position | 보유 종목 상세 | fundCode |
get_fund_manager_list | 역대 운용사 목록 | fundCode |
get_fund_manager_detail | 현임 운용사 약력 | fundCode |
주식/지수
| 도구 | 용도 | 주요 파라미터 |
|---|---|---|
get_stock_trend | 일중 시분할 추이 | secid (예: 1.600519) |
get_stock_quote | 실시간 시세 호가 | secids (쉼표 구분) |
시장/자금
| 도구 | 용도 | 주요 파라미터 |
|---|---|---|
get_market_overview | A주 시장 개요 (상하이/선전) | 없음 |
get_market_capital_flow | 시장 자금 흐름 (주력/대소매) | 없음 |
get_sector_capital_flow | 섹터 자금 순위 | timeType, code |
get_northbound_capital | 후강퉁/선강퉁 자금 흐름 | 없음 |
보유 관리
| 도구 | 용도 | 주요 파라미터 |
|---|---|---|
save_portfolio | 보유 기록 저장/업데이트 | fundCode, shares, costPrice |
remove_portfolio | 보유 기록 삭제 | fundCode |
get_portfolio | 보유 목록 조회 | 없음 |
get_portfolio_profit | 오늘 수익 및 총 수익 한 번에 조회 | 없음 |
정기 알림
| 도구 | 용도 | 주요 파라미터 |
|---|---|---|
set_reminder | 정기 알림 설정 (매 거래일 트리거) | time(HH:MM), type, message |
get_reminders | 모든 알림 설정 조회 | 없음 |
remove_reminder | 특정 알림 삭제 | id |
check_reminders | 만료된 알림 확인 | 없음 |
알림 유형 type:
profit_report— 보유 수익 리포트 (트리거 시get_portfolio_profit조회, 추가/감소 제안)market_report— 시장 현황 리포트 (트리거 시 시장 개요 + 자금 흐름 조회)custom— 사용자 정의 알림 (message파라미터와 함께 사용)
주요 파라미터 설명
펀드 코드 fundCode: 6자리 숫자, 예: 161725 (자오상바이주), 110011 (이팡다 중소판)
증권 ID secid: 형식 시장.코드
| 시장 코드 | 의미 | 예시 |
|---|---|---|
1. | 상해거래소 | 1.000001 (상해 종합 지수), 1.600519 (귀저우마오타이) |
0. | 선전거래소 | 0.399001 (선전 성분 지수), 0.000858 (우량예) |
116. | 홍콩 주식 | 116.01810 (샤오미 그룹) |
시간 범위 range: m=1개월, q=3개월, hy=6개월, y=1년, 2y=2년, 3y=3년, 5y=5년
능동적 행동 (중요)
매 대화 시작 시 check_reminders를 먼저 호출하세요
사용자가 무엇을 말하든, 사용자에게 응답하기 전에 check_reminders를 호출하여 만료된 알림이 있는지 확인합니다. 만료된 알림이 있으면 다음 규칙에 따라 실행합니다:
-
profit_report만료 시:get_portfolio_profit를 호출하여 수익 데이터를 가져옵니다.get_market_overview를 호출하여 시장 배경을 가져옵니다.- 친근한 어조로 오늘의 보유 수익 개요를 사용자에게 알립니다.
- 각 펀드에 대해 조작 제안을 제공합니다:
- 오늘 하락률 > 2%: "적절히 추가 매수하여 원가를 낮추는 것을 고려하세요"라고 제안
- 오늘 상승률 > 3%: "상승 폭이 큽니다. 일부 차익 실현을 고려하세요"라고 제안
- 보유 총 손실 > 10%: "손실이 큽니다. 계속 보유할지 평가해 보세요"라고 제안
- 보유 총 이익 > 20%: "수익이 상당합니다. 분할 차익 실현을 고려하세요"라고 제안
- 마지막으로 사용자에게 보유 종목 조정이 필요한지 묻습니다.
-
market_report만료 시:get_market_overview+get_market_capital_flow+get_northbound_capital호출- 시장 지수, 자금 흐름, 북방 자금 동향을 알립니다.
-
custom만료 시:- 사용자에게 사용자 정의 알림 내용을 표시합니다.
만료된 알림이 없으면 사용자의 요청을 정상적으로 처리합니다.
일반적인 시나리오
사용자가 펀드 코드를 모를 때
먼저 search_fund로 검색한 후, 반환된 code를 사용하여 다른 도구를 호출합니다.
사용자가 "오늘 시장 어떠냐"고 물을 때
get_market_overview + get_market_capital_flow를 차례로 호출하여 시장 지수, 변동, 거래량, 자금 흐름을 종합적으로 알립니다.
사용자가 "오늘 얼마 벌었나"고 물을 때
get_portfolio_profit를 직접 호출하여 각 펀드의 오늘 수익과 요약을 반환합니다. 보유 기록이 없으면 save_portfolio를 사용하여 추가하도록 안내합니다.
사용자가 보유 정보를 알려줄 때
펀드 코드, 보유 수량, 원가를 파싱하여 각 펀드를 save_portfolio로 저장합니다. 이름 파라미터는 생략 가능하며 도구가 자동으로 조회하여 채웁니다.
사용자가 빠르게 보유 종목을 가져오고 싶을 때 (스크린샷 인식)
현재 모델이 이미지 인식(OCR)을 지원하는 경우, 사용자에게 "펀드 앱(예: 티엔톈펀드, 알리페이, 마이차오부 등)의 보유 스크린샷을 직접 업로드하세요. AI가 자동으로 스크린샷에서 펀드 코드, 펀드 이름, 보유 수량, 원가 순자산가치 등을 인식한 후 각 펀드를 save_portfolio로 일괄 가져옵니다. 수동으로 하나씩 입력할 필요가 없습니다."라고 적극적으로 제안합니다.
처리 흐름:
- 스크린샷에서 각 펀드 정보(코드, 수량, 원가)를 인식합니다.
- 불완전한 필드(예: 이름만 있고 코드가 없는 경우)는
search_fund로 펀드 코드를 보충합니다. - 각 펀드를
save_portfolio로 저장합니다. - 저장 완료 후 가져온 보유 목록을 요약하여 보여주고, 누락이나 오류가 있는지 확인하라고 알립니다.
사용자가 특정 펀드에 대한 종합 분석을 요청할 때
get_fund_info + get_fund_estimate + get_fund_position + get_fund_accumulated_performance를 조합하여 호출하여 기본 정보, 평가, 보유 종목, 역사적 수익을 다각도로 분석합니다.
사용자가 "매일 오후에 수익을 알리도록 설정해 줘"라고 말할 때
set_reminder를 호출합니다. 파라미터는 time="14:30", type="profit_report"입니다. 이후 매 거래일 14:30 이후 첫 대화에서 자동으로 수익 리포트와 조작 제안이 트리거됩니다.
알림 트리거 후 리포트 예시
안녕하세요! 지금은 14:30입니다. 오늘의 보유 수익을 알려드립니다:
보유 개요: 3개 펀드, 총 원가 15000.00 위안, 현재 시가 14520.00 위안 오늘 수익: -180.00 위안 | 보유 총 수익: -480.00 위안 (-3.20%)
각 펀드 상세:
- 자오상바이주A (161725): 오늘 -1.22%, 보유 손실 -11.07%, 계속 보유할지 평가 권장
- 이팡다란초 (005827): 오늘 +0.35%, 보유 이익 +5.20%, 계속 보유
- 광파나스닥 (270042): 오늘 +1.80%, 보유 이익 +15.30%, 추이 양호
보유 종목을 조정하시겠습니까?
주의 사항
- 평가 데이터는 A주 거래 시간대(9:30-15:00)에만 업데이트되며, 거래 시간 외에는 종가 데이터가 반환됩니다.
get_fund_estimate는 추정치를 반환하며 최종 순자산가치가 아니므로 사용자에게 알려야 합니다.- 보유 데이터는
data/portfolio.json에 저장되며, 세션 간에도 유지됩니다. - 수익 계산: 오늘 수익 = 보유 수량 × (평가 - 전일 순자산가치), 보유 수익 = 보유 수량 × (평가 - 원가)