한국 주식 데이터를 AI에 연결 MCP · 주소 한 줄 · 무인증

claude mcp add --transport http aikstockdata https://mcp.aikstockdata.com/mcp

{
  "mcpServers": {
    "aikstockdata": {
      "type": "http",
      "url": "https://mcp.aikstockdata.com/mcp"
    }
  }
}

5분이면 됩니다 개발자용 — 주소로 직접 받기

1. 1
   부른다 — 카탈로그부터입니다. 나머지 파일의 주소가 전부 여기 있습니다.

   curl -s https://aikstockdata.com/data/public/index.json

   명령 복사
2. 2
   이렇게 옵니다 — 아래는 꾸며 낸 예시가 아니라 이 페이지를 발행할 때 그 파일에서 그대로 읽은 앞 12줄입니다.

   {
    "schema_version": "1.1",
    "site": "한국주식데이터 (aikstockdata.com)",
    "@type": "DataCatalog",
    "name": "한국주식데이터 — 공개 데이터 카탈로그",
    "description": "코스피·코스닥·코넥스 전 종목의 T+1 확정 종가·DART 공시(접수 시각 포함)·분기 실적을 매 거래일 18:30 전후(KST …(줄 잘림)
    "generated_kst": "2026-09-18 18:10",
    "generated_at": "2026-09-18T18:10:00+09:00",
    "code_rev": "8c687c8",
    "as_of": "2026.09.18",
    "published_date_iso": "2026-09-18",
    "quote_basis_date": "20260917",
   …

   전체 1,290줄 · 이 파일은 우리가 공개하는 모든 JSON·CSV 의 목차입니다 (크기·신선도·소형 대체본 포함). 전문 보기

3. 3
   아니면 한 줄로 — 이 주소를 Claude·ChatGPT 설정에 한 번 넣으면 됩니다. 넣는 법은 연결 안내에 있습니다.

   https://mcp.aikstockdata.com/mcp

   MCP 주소 복사

커넥터를 등록했다면 — 이렇게 물어보세요

공시 접수 시각(HH:MM) — 공개 API 에 없는 값

curl -s https://aikstockdata.com/data/public/disclosures_intraday.json | head -c 400

읽는 규칙 네 가지. ① code·rcept_no 는 문자열로 읽으세요 (pd.read_json(..., dtype={"code": str})). ② 저희 시세와 붙일 거면 in_universe: true 로 먼저 거르세요. 코드가 있다고 다 조인되지 않습니다. ③ 모든 공시가 들어 있습니다 — 저희가 분류하는 유형만이 아니라 그날 접수된 전부입니다. 필요한 유형만 label 또는 title 로 걸러 쓰세요. ④ 공시가 0건이어도 파일은 나갑니다("items": []). 파일이 없으면 그건 고장입니다 — 정정·공지 로그에 기록됩니다.

import requests
d = requests.get("https://aikstockdata.com/data/public/disclosures_intraday.json").json()

# 저희 시세와 붙일 수 있는 건만, 장 마감 전 접수만
rows = [i for i in d["items"] if i["in_universe"] and i["receipt_time"] < "15:30"]
for i in rows[:5]:
    print(i["receipt_time"], i["code"], i["name"], i["label"] or i["title"])

한계도 밝힙니다. 15:00 수집이므로 그 이후 접수분은 들어 있지 않습니다 — 저녁 발행의 disclosures.json 은 우리가 분류하는 공시 유형(label 이 붙는 건)만 담으므로, 15:00 이후 접수된 그 밖의 공시는 어느 파일에도 없습니다(그런 공시는 DART 원문 목록에서 보세요). 또 이 파일은 접수 사실과 시각일 뿐이며, 가격·수익률·해석을 담지 않습니다. 같은 시각에 여러 건이 접수되는 일도 흔합니다.

장 마감 후 공시 — 저녁 전체판에도 같은 두 필드가 있습니다

import requests
d = requests.get("https://aikstockdata.com/data/public/disclosures.json").json()

# 오늘 장 마감 뒤에 나온 공시 — 아직 종가에 반영되지 않았다
late = [e for e in d["events"] if e["session"] == "after_close"]
for e in late[:5]:
    print(e["rcept_dt"], e["receipt_time"], e["code"], e["name"], e["title"])

시각을 못 얻은 건도 필드는 있습니다 (receipt_time: null, session: "unknown") — 필드가 있다 없다 하면 받아 쓰는 쪽이 깨집니다. 확보 비율은 파일 안 receipt_time_note.coverage 에 적힙니다. 접수번호↔시각 대조표만 필요하면 https://aikstockdata.com/data/public/dart_receipt_times.json 을 쓰세요 (covers.through 로 어디까지 수록됐는지 확인할 수 있습니다).

공개 데이터 (JSON · 무료 · 키 불필요)

시세는 전 영업일 확정 종가(T+1)이며 실시간이 아닙니다. 파일 안의 basDt(기준일자)를 꼭 확인하세요. 매 거래일 자동 갱신됩니다.

파일 다운로드 (CSV·JSON)

CSV는 엑셀에서 바로 열리고, AI 챗봇에는 파일을 업로드하거나 위 주소를 그대로 붙여넣으면 됩니다. 전부 공공데이터 가공물 — 출처를 표기하면 비영리 목적으로 인용·이용할 수 있고, 상업적 재배포는 허용하지 않습니다.

복사해서 바로 쓰는 질문 예시

다른 도구와 함께 쓰기 (pykrx 등)

from pykrx import stock      # 시세 시계열은 이쪽
import requests              # 공시·실적·해석은 우리

ohlcv = stock.get_market_ohlcv("20260101", "20260820", "005930")
x = requests.get("https://aikstockdata.com/data/public/s/005930.json").json()
x["financials"], x["recent_disclosures"], x["signals"]

이용 조건

본 데이터와 안내는 정보 제공 목적이며 투자 권유가 아니고, 특정 종목의 매수·매도를 추천하지 않습니다.