Lsopenapi MCP server

한글 · English

mcp-lsopenapi

AI에게 시세·차트·내 포트폴리오를 물어보세요.

Claude·ChatGPT·Copilot 같은 AI 비서에 LS증권 OpenAPI를 붙입니다. 시세·차트·기업정보·ETF·시장 스크리너·지수/업종/테마 컨텍스트, LS 실계좌 read-only 조회(v1.6), 그리고 내 페이퍼 포트폴리오·관심종목까지 — 평소 쓰던 대화창에서 자연어로 묻고 받습니다.

"오늘 코스피 어땠어? 강한 업종은?"

"SK하이닉스 일봉 차트 보여주고 추세 봐줘"

"내 LS 계좌 잔고 보여줘" — v1.6

"오늘 매매일지랑 수익률" — v1.6

"한투에서 삼성전자 64주 평단 21.5만에 샀어"

"내 보유 중 2차전지 테마만 모아봐"

"포트폴리오 백업해줘"

설정 한 번이면 됩니다. 종목 코드를 외울 필요도, HTS를 따로 띄울 필요도 없습니다.

대화창에 맞게 가볍게 답합니다. 차트·지수 시계열·보유종목처럼 커지기 쉬운 응답은 요약 우선 형태로 보내고, 필요한 경우에만 원본 데이터로 이어가도록 설계했습니다. 그래서 긴 차트 분석이나 스크리닝 대화도 불필요한 토큰을 덜 쓰고 이어갈 수 있습니다.

개발자용 기술 문서(환경 변수, 자격증명 정책, 도구 시그니처, 상세 스키마, SDK·빌드)는 영문 README에 있습니다.

이런 질문에 답합니다

도구 이름이 아니라 "어떤 질문에 답할 수 있는가" 로 묶었습니다.

시세 / 호가

"삼성전자 지금 얼마야?" · "카카오 호가창 보여줘" · "미장 테슬라 현재가" · "내 관심종목 10개 가격 한번에 비교"

국내 단일 종목 현재가와 10단계 호가, 해외주식 현재가/종목정보/10단계 호가, 또는 국내 최대 50종목 일괄 비교.

차트 / 기술적 분석

"SK하이닉스 일·주·월봉 같이 보여줘" · "NVDA 일봉에 이동평균선이랑 RSI" · "여기에 MA200도 추가해줘"

국내·해외 개별주식의 일·주·월·년·분·틱 차트, 이동평균·RSI·MACD·볼린저밴드 같은 기술 지표, 변곡점·MA 정렬·고점 대비 낙폭 같은 사전 계산된 분석. 국내·해외 모두 추가 지표나 기간 변경을 후속 대화에서 그대로 이어갈 수 있습니다.

종목 검색 / 기업 정보

"카카오 종목코드 뭐야?" · "테슬라 keysymbol 찾아줘" · "바이오 ETF 알려줘" · "삼성전자 PER이랑 분기별 매출 추이"

KOSPI/KOSDAQ 종목명 부분 검색, 미국/해외주식 마스터 검색, 일반주식/ETF 필터, PER/PBR/EPS·분기 재무·52주 가격 범위·상위 거래원·외국인 보유, SPAC·관리종목 플래그.

ETF 분석

"KODEX 200 NAV랑 괴리율 보여줘" · "TIGER 미국나스닥100 구성종목 비중 상위 10개"

ETF/ETN 전용 정보(NAV·추적오차율·괴리율·AUM·LP), 구성종목(PDF) 비중순 정렬과 상위 N개 제한.

시장 스크리닝

"오늘 상승률 상위 10개" · "거래대금 상위 + 시총 1조 이상" · "PER 낮은 종목 30개" · "오늘 외인 매수 상위"

등락률·시총·거래량·거래대금 상위, 거래 급증, 펀더멘털 랭킹(PER/PBR/ROE 등), 투자자 수급, 신고/신저가, 공매도 추이, 증권사 투자의견, 관리·매매정지 종목 — 가격·거래량 필터링과 함께.

저장된 신호 검색 (Q-Click) — v1.4

"골든크로스 신호 어떤 게 있어?" · "외국인 매수 streak 신호 돌려줘" · "거래대금 급증 ∩ 외인 매수 양쪽에 다 잡힌 종목"

LS가 큐레이션한 99개 신호 카탈로그(이평선 정배열·MA 돌파·공매도 추세·외국인 수급 streak 등)를 이름이나 키워드로 찾아 그대로 실행합니다. 두 개 이상을 AND(교집합) / OR(합집합) 으로 합쳐 한 번에 부를 수도 있어 — "거래대금 급증과 외국인 매수 둘 다 잡힌 종목" 처럼 HTS 한 화면에서는 표현할 수 없는 복합 조건도 한 번의 대화로 처리합니다.

지수 / 업종 / 테마 컨텍스트

"오늘 코스피" · "강한 업종은?" · "2차전지 테마 종목 비교" · "삼성전자가 속한 테마" · "나스닥·환율 어때?"

국내 지수 단건·시계열 조회, 해외 지수·환율·선물, 업종 등락률 랭킹, 업종/테마 안의 종목 일괄 시세, 종목별 테마 역조회. 키워드가 모호하면 후보를 보여주고 되묻습니다.

프로그램매매 / 기관 수급

"오늘 프로그램매매 어땠어?" · "프로그램이 순매수한 종목 상위" · "삼성전자 프로그램 수급 추이" · "삼성전자 기관이 매집 중인지 분석해줘"

시장 전체 프로그램매매(차익·비차익) 흐름을 분 단위·일 단위로, 종목별 프로그램 순매수 랭킹(시가총액 대비 비중으로 정규화), 개별 종목의 프로그램 수급 추이까지 — 모두 인라인 차트와 함께. 한 종목의 프로그램 발자국을 매집·분산·churn으로 판정하는 footprint 분석도.

LS 실계좌 read-only 조회 — v1.6

"내 LS 계좌 잔고" · "오늘 주문 체결됐어?" · "BEP 단가 알려줘" · "이번 달 수익률" · "오늘 매매일지" · "삼성전자 최대 몇 주 살 수 있어?"

LS appkey와 묶인 실계좌를 read-only로 조회합니다. 보유잔고·당일 주문/미체결·예수금/주문가능금액·기간 손익·일일 매매일지·주문이력·거래내역·신용한도·종목별 주문가능수량(증거금률 100% / 50% / 35% 별로). 매 호출마다 LS REST를 다시 쳐서 항상 최신 — 캐시 없음, 데몬 없음. 발주는 v1.7에서.

페이퍼 포트폴리오(accounts 테이블, 다중 브로커 수동 입력)와 LS 실계좌(lsaccounts 테이블, appkey 자동 발견)는 물리적으로 분리된 저장소**라서, 페이퍼 계좌에 "LS증권" 라벨을 붙여도 실계좌 응답을 가리지 않습니다.

로컬 페이퍼 포트폴리오 / 관심종목 / 백업·복원

"한투에 삼성전자 10주 6.8만 샀어" · "5주 더 7.5만에 추가 매수" · "내 평가손익 보여줘" · "관심종목에 NAVER 추가" · "포트폴리오 백업해줘"

여러 증권사 계좌의 보유 종목·매수/매도 기록(가중평균 평단 자동 계산), 액면분할·무상증자 일괄 반영, 계좌별 + 통합 평가손익. 그룹별 관심종목과 관심 테마 추적, 단일 JSON 백업·복원. 내 보유 종목과 테마/업종을 교차한 필터("내 보유 중 2차전지 테마")도 한 번에. broker 라벨은 순수 표시용이라 "한투", "유안타증권", "LS증권 페이퍼" 등 자유롭게 붙일 수 있고, LS 실계좌와 절대 충돌하지 않습니다.

활용 사례

Shortened. The full README is on GitHub.