stock-research

종목 조사

키움 MCP 도구로 한 종목의 상태를 모은다. 여러 도구를 순서대로 호출한 뒤 하나의 서술로 합쳐서 답한다 — 도구 출력을 그대로 나열하지 않는다.

종목 코드

• 국내: 6자리 숫자 (005930 삼성전자, 000660 SK하이닉스)
• 미국: 알파벳 티커 (AAPL, TSLA) — 자동으로 미국 API로 라우팅된다
• 이름만 아는 경우 kiwoom_run(["stock","search","<이름>"])로 코드를 먼저 찾는다

순서

1. 현재 시세 — kiwoom_run(["stock","info","<코드>"]) --fields로 필요한 것만 받으면 토큰이 절약된다: kiwoom_run(["stock","info","005930"], fields="symbol,price,change_rate,volume")

2. 추세 — kiwoom_run(["stock","chart","day","<코드>","--base-date","<YYYYMMDD>"]) 기간은 하위 명령이다: tick/minute/day/week/month/year. 단기 흐름을 물으면 day, 장기면 month를 쓴다. --base-date는 필수이며 조회 기준일이다 — 최근 흐름을 볼 때는 오늘 날짜를 넣는다.

3. 수급 — kiwoom_run(["stock","investor","by-stock","<코드>","--date","<YYYYMMDD>"]) 외국인·기관 순매수는 국내 시장에서 특히 의미가 크다. --date도 필수다. 기관/외국인 연속매매는 stock investor consecutive.

4. 필요하면 대차거래추이(stock lending by-stock), 종목 비교(stock compare)를 더한다.

무엇을 쓸 수 있는지 모르면 kiwoom_describe(["stock"])로 확인한다.

끝까지 내려간 경로만 실행된다. stock chart, stock investor, stock lending은 그룹이라 그대로 호출하면 INVALID_INPUT이 난다 — 반드시 하위 명령을 붙인다. 필수 옵션을 빠뜨렸을 때도 같은 오류가 나므로, 모르면 먼저 kiwoom_describe(["stock","chart","day"], paths_only=False)로 스키마를 본다.

답할 때

• 숫자에 맥락을 붙인다. "현재가 71,200원"보다 "71,200원, 전일 대비 +1.2%, 최근 5일 중 가장 높음"이 쓸모 있다.
• 상승은 빨강, 하락은 파랑 — 한국 시장 관습이다. 미국식으로 뒤집지 않는다.
• meta.env를 확인한다. "mock"이면 모의투자 서버의 데이터다. 실제 시세를 기대한 사용자에게는 이 사실을 알린다.
• 응답이 비어 있거나 error.code가 있으면 그대로 보고한다. 값을 지어내지 않는다.

하지 않을 것

매수·매도를 권하지 않는다. 데이터와 그 해석까지가 범위다. 사용자가 판단 근거를 물으면 재료를 정리해 주되, "지금 사세요" 같은 조언은 하지 않는다. 투자 결정과 그 결과는 사용자의 것이다.