43 lines
1.4 KiB
Markdown
43 lines
1.4 KiB
Markdown
# LS증권 OpenAPI Docs MCP
|
|
|
|
LS증권 OpenAPI TR 스펙(`ls-openapi-spec.json`)을 **조회만** 하는 MCP입니다.
|
|
키움 `kiwoom-docs` / 한투 `kis-code-assistant`와 같은 역할(문서 검색)이며,
|
|
**실제 API 호출·주문·토큰 발급은 하지 않습니다.**
|
|
|
|
## Tools
|
|
|
|
| Tool | 용도 |
|
|
|------|------|
|
|
| `ls_api_stats` | TR 수·카테고리/프로토콜 분포 |
|
|
| `search_ls_api` | 이름/설명/필드 키워드 검색 (예: `분봉`, `t8412`, `조건검색`) |
|
|
| `get_ls_api` | trCode 상세(requestIo/responseIo/예제/docsUrl) |
|
|
| `list_ls_apis` | category·protocol·url 필터 목록 |
|
|
|
|
## Cursor 등록
|
|
|
|
프로젝트 `.cursor/mcp.json`에 `ls-docs`로 등록합니다.
|
|
Cursor MCP 재로드 후 도구가 보입니다.
|
|
|
|
```bash
|
|
cd /home/hoon/kis_bot/mcp/ls-docs-mcp
|
|
uv sync
|
|
uv run python server.py --stdio
|
|
```
|
|
|
|
## 데이터 갱신
|
|
|
|
공식 포털 공개 API에서 스펙을 받아 `data/ls-openapi-spec.json`을 만듭니다
|
|
(REST 시세/주문 호출 아님 — 문서 메타만).
|
|
|
|
```bash
|
|
cd /home/hoon/kis_bot/mcp/ls-docs-mcp
|
|
uv run python fetch_spec.py
|
|
# 로그: 표준출력. 약 1~3분 (TR~360 + 필드 조회, sleep 포함)
|
|
```
|
|
|
|
## 출처
|
|
|
|
- 그룹 목록: `GET https://openapi.ls-sec.co.kr/api/apis/public?size=500`
|
|
- TR 목록: `GET https://openapi.ls-sec.co.kr/api/apis/guide/tr/{apiId}`
|
|
- 필드: `GET https://openapi.ls-sec.co.kr/api/apis/guide/tr/property/{trId}`
|