Communitygithub.com

cn-funds-mcp - 중국 펀드/주식 데이터 도우미

중국 펀드 및 주식 데이터를 조회하는 도우미입니다. (무료 API, API 키 불필요) 펀드 평가, 순자산가치(NAV), 보유 종목, 운용사 정보, 주식/지수 시세, 시장 자금 흐름, 섹터 순위, 북방 자본을 조회하고 사용자 펀드 포트폴리오를 관리하며 수익을 계산합니다.

주식 데이터 도우미란 무엇인가요?

이 스킬은 중국 펀드와 주식 데이터를 조회하고 관리하는 에이전트 도구(cn-funds-mcp)입니다. 무료 API를 사용하며 API 키가 필요 없습니다. 사용자는 이 도구를 통해 펀드 검색, 실시간 평가, 순자산가치, 보유 종목, 운용사 정보 등을 확인할 수 있습니다. 또한 주식/지수 시세, 시장 자금 흐름, 섹터 순위, 북방 자본 데이터를 제공합니다. 사용자 펀드 포트폴리오를 저장하고 수익을 계산하는 기능도 포함되어 있어 개인 투자자가 포트폴리오를 관리하는 데 유용합니다. 주요 지원 플랫폼은 A주와 홍콩 주식 시장이며, Claude Code, Cursor, Codex 등 다양한 AI 에이전트에서 사용할 수 있습니다. 이 스킬은 사용자 요청에 따라 적절한 도구를 조합하여 호출하는 방식으로 작동하며, 특히 펀드, 주식, 시장 현황 등을 물어볼 때 자동으로 활성화됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add smallke/cn-funds-mcp

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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_overviewA주 시장 개요 (상하이/선전)없음
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를 호출하여 만료된 알림이 있는지 확인합니다. 만료된 알림이 있으면 다음 규칙에 따라 실행합니다:

  1. profit_report 만료 시:

    • get_portfolio_profit를 호출하여 수익 데이터를 가져옵니다.
    • get_market_overview를 호출하여 시장 배경을 가져옵니다.
    • 친근한 어조로 오늘의 보유 수익 개요를 사용자에게 알립니다.
    • 각 펀드에 대해 조작 제안을 제공합니다:
      • 오늘 하락률 > 2%: "적절히 추가 매수하여 원가를 낮추는 것을 고려하세요"라고 제안
      • 오늘 상승률 > 3%: "상승 폭이 큽니다. 일부 차익 실현을 고려하세요"라고 제안
      • 보유 총 손실 > 10%: "손실이 큽니다. 계속 보유할지 평가해 보세요"라고 제안
      • 보유 총 이익 > 20%: "수익이 상당합니다. 분할 차익 실현을 고려하세요"라고 제안
    • 마지막으로 사용자에게 보유 종목 조정이 필요한지 묻습니다.
  2. market_report 만료 시:

    • get_market_overview + get_market_capital_flow + get_northbound_capital 호출
    • 시장 지수, 자금 흐름, 북방 자금 동향을 알립니다.
  3. custom 만료 시:

    • 사용자에게 사용자 정의 알림 내용을 표시합니다.

만료된 알림이 없으면 사용자의 요청을 정상적으로 처리합니다.

일반적인 시나리오

사용자가 펀드 코드를 모를 때

먼저 search_fund로 검색한 후, 반환된 code를 사용하여 다른 도구를 호출합니다.

사용자가 "오늘 시장 어떠냐"고 물을 때

get_market_overview + get_market_capital_flow를 차례로 호출하여 시장 지수, 변동, 거래량, 자금 흐름을 종합적으로 알립니다.

사용자가 "오늘 얼마 벌었나"고 물을 때

get_portfolio_profit를 직접 호출하여 각 펀드의 오늘 수익과 요약을 반환합니다. 보유 기록이 없으면 save_portfolio를 사용하여 추가하도록 안내합니다.

사용자가 보유 정보를 알려줄 때

펀드 코드, 보유 수량, 원가를 파싱하여 각 펀드를 save_portfolio로 저장합니다. 이름 파라미터는 생략 가능하며 도구가 자동으로 조회하여 채웁니다.

사용자가 빠르게 보유 종목을 가져오고 싶을 때 (스크린샷 인식)

현재 모델이 이미지 인식(OCR)을 지원하는 경우, 사용자에게 "펀드 앱(예: 티엔톈펀드, 알리페이, 마이차오부 등)의 보유 스크린샷을 직접 업로드하세요. AI가 자동으로 스크린샷에서 펀드 코드, 펀드 이름, 보유 수량, 원가 순자산가치 등을 인식한 후 각 펀드를 save_portfolio로 일괄 가져옵니다. 수동으로 하나씩 입력할 필요가 없습니다."라고 적극적으로 제안합니다.

처리 흐름:

  1. 스크린샷에서 각 펀드 정보(코드, 수량, 원가)를 인식합니다.
  2. 불완전한 필드(예: 이름만 있고 코드가 없는 경우)는 search_fund로 펀드 코드를 보충합니다.
  3. 각 펀드를 save_portfolio로 저장합니다.
  4. 저장 완료 후 가져온 보유 목록을 요약하여 보여주고, 누락이나 오류가 있는지 확인하라고 알립니다.

사용자가 특정 펀드에 대한 종합 분석을 요청할 때

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에 저장되며, 세션 간에도 유지됩니다.
  • 수익 계산: 오늘 수익 = 보유 수량 × (평가 - 전일 순자산가치), 보유 수익 = 보유 수량 × (평가 - 원가)

저자

smallke | [email protected]

관련 스킬