korean-stock-search: /search returns empty items[], /base-info & /trade-info return 502

[dennis7676]

Summary

korean-stock-search skill의 k-skill-proxy 엔드포인트들이 정상 동작하지 않습니다. upstream KRX Open API 응답 실패로 보입니다.

확인 일시: 2026-04-09

재현 방법

1. /search — 주요 종목 검색 시 빈 결과

# 삼성전자 검색 — items: [] (모든 날짜에서 동일)
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/korean-stock/search' \
  --data-urlencode 'q=삼성전자' \
  --data-urlencode 'bas_dd=20260408'

# 종목코드로 검색 — 역시 빈 결과
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/korean-stock/search' \
  --data-urlencode 'q=005930' \
  --data-urlencode 'bas_dd=20260408'

응답:

{"items":[],"query":{"q":"삼성전자","bas_dd":"20260408","market":null,"limit":10},"proxy":{"name":"k-skill-proxy","cache":{"hit":false,"ttl_ms":300000},"requested_at":"2026-04-09T13:42:36.635Z"}}

2. /base-info & /trade-info — 502 오류

# SKILL.md 문서의 예시 그대로 실행
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/korean-stock/base-info' \
  --data-urlencode 'market=KOSPI' \
  --data-urlencode 'code=005930' \
  --data-urlencode 'bas_dd=20260404'
# → error code: 502

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/korean-stock/trade-info' \
  --data-urlencode 'market=KOSPI' \
  --data-urlencode 'code=005930' \
  --data-urlencode 'bas_dd=20260404'
# → error code: 502

3. /search 부분 동작 케이스

짧은 검색어 삼성 + 과거 날짜에서는 SPAC 종목 4건만 반환됩니다. 삼성전자, 삼성SDI 등 주요 종목은 포함되지 않습니다.

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/korean-stock/search' \
  --data-urlencode 'q=삼성' \
  --data-urlencode 'bas_dd=20260408'
# → items: [삼성스팩10호, 삼성스팩11호, 삼성스팩12호, 삼성스팩13호] (KOSDAQ SPAC만)

4. /health 엔드포인트는 정상

curl -fsS 'https://k-skill-proxy.nomadamas.org/health'
# → {"ok":true, ..., "krxConfigured":true}

예상 원인

• proxy 서버 자체는 정상 (health OK, krxConfigured: true)
• upstream KRX Open API가 502를 반환 → API 키 만료 또는 KRX API 스펙 변경 가능성
• /search는 제한된 캐시/인덱스(최근 IPO/SPAC만)로 부분 동작 중인 것으로 보임

환경

• 클라이언트: macOS, curl 8.7.1
• 스킬 설치: npx skills add NomaDamas/k-skill -y -g (2026-04-09)

[vkehfdl1]

• AI-understood issue summary

  • 재현 내용과 현재 코드 흐름이 일치합니다. packages/k-skill-proxy/src/server.js 기준으로 /base-info·/trade-info 는 KRX upstream 비정상 응답을 그대로 502로 올리고, packages/k-skill-proxy/src/krx-stock.js 의 searchStocks() 는 KOSPI/KOSDAQ/KONEX를 Promise.allSettled() 로 긁은 뒤 성공한 시장만 합쳐서 반환합니다.
  • 그래서 KOSPI 쪽 upstream만 깨져도 005930/삼성전자 는 빈 결과가 되고, 반대로 KOSDAQ 일부 데이터만 살아 있으면 삼성 검색에서 삼성스팩류만 보이는 현재 증상과 정확히 맞습니다.

• Why this issue is needed

  • korean-stock-search 스킬의 대표 사용 경로 3개(/search, /base-info, /trade-info) 중 2개가 하드 실패이고, 나머지 1개도 misleading partial-success 상태입니다.
  • SKILL.md 예시 호출이 현재 실제 프로덕션에서 깨져 있어서 사용자 신뢰와 스킬 계약이 모두 훼손됩니다.
  • 특히 /search 가 조용히 부분 성공만 반환하면 “검색 결과 없음”으로 오해하기 쉬워서, 단순 502보다 더 위험한 UX입니다.

• Why this issue may not be needed

  • 코드 버그가 아니라 프로덕션 KRX_API_KEY 만료 / KRX 계정 상태 변화 / main 배포본 secrets drift 라면, repo 수정 없이 운영 secrets 갱신 + 재배포만으로 끝날 수 있습니다.
  • 또는 KRX가 URL/헤더/응답 shape를 바꾼 전면 스펙 변경이면, 이 이슈는 개별 엔드포인트 버그라기보다 “KRX adapter refresh” 작업으로 흡수될 수도 있습니다.

• Expected Outcome

  • 삼성전자, 005930 같은 대표 쿼리에서 /search 가 다시 정상 후보를 반환한다.
  • KOSPI/005930/20260404 기준 /base-info, /trade-info 예시 호출이 200으로 복구된다.
  • 일부 시장만 장애일 때는 빈 items[] 로 숨기지 말고, 최소한 degraded/upstream error 신호를 주도록 동작이 명확해진다.

• Concise implementation plan

  1. 프로덕션/로컬에서 KRX 각 endpoint(stk_isu_base_info, ksq_isu_base_info, knx_isu_base_info, stk_bydd_trd 등)의 실제 status/body 를 캡처해 key 문제인지 스펙 변경인지 먼저 분리한다.
  2. 필요 시 packages/k-skill-proxy/src/krx-stock.js 의 request contract(URL, 헤더, query param, 응답 파싱)를 업데이트한다.
  3. /search 는 현재처럼 조용히 부분 성공만 내보내지 말고, exact-match 질의에서 핵심 시장 실패를 surfaced error/degraded metadata로 드러내도록 정책을 정한다.
  4. packages/k-skill-proxy/test/server.test.js 에 이번 장애 패턴(시장별 partial failure, upstream 502/응답 shape 변경)을 regression test로 고정한다.
  5. npm run ci + 로컬 proxy smoke curl 3종(/search, /base-info, /trade-info)으로 검증한다.

• Agent Signature

[vkehfdl1]

실제 문제를 파악해봐. KRX_API_KEY의 권한 문제인가?

[vkehfdl1]

직접 확인해봤고, 현재 증상은 KRX_API_KEY의 “전체 장애”라기보다 KOSPI base-info 계열에 대한 권한/상품 scope 문제로 보는 게 가장 맞습니다.

제가 확인한 사실:

• proxy 서버가 읽는 동일한 KRX_API_KEY로 upstream KRX를 직접 호출해 봄
• https://data-dbg.krx.co.kr/svc/apis/sto/stk_isu_base_info?basDd=20260408
  → HTTP 401 / {"respMsg":"Unauthorized API Call","respCode":"401"}
• https://data-dbg.krx.co.kr/svc/apis/sto/ksq_isu_base_info?basDd=20260408
  → HTTP 200 / 정상 데이터 반환
• https://data-dbg.krx.co.kr/svc/apis/sto/knx_isu_base_info?basDd=20260408
  → HTTP 200 / 정상 데이터 반환
• https://data-dbg.krx.co.kr/svc/apis/sto/stk_bydd_trd?basDd=20260408
  → HTTP 200 / KOSPI 일별시세 데이터 정상 반환

즉:

1. KRX 전체가 죽은 것은 아님
   같은 키로 KOSDAQ/KONEX base-info는 정상 응답합니다.

2. 문제는 KOSPI base-info endpoint(stk_isu_base_info) 권한 쪽에 집중됨
   키 만료일 수도 있지만, 현재 관측만으로는 “키 전체 만료”보다는 특정 API 상품/권한 누락 또는 계정 scope 문제에 더 가깝습니다.

3. /search 가 빈 결과가 되는 이유도 설명됨
   현재 검색은 searchStocks() 에서 시장별 base-info snapshot을 모아 검색하는 구조라서, KOSPI base-info만 401 이면 삼성전자/005930 같은 KOSPI 종목이 통째로 빠집니다. 반대로 KOSDAQ 쪽만 살아 있으면 삼성스팩* 같은 결과만 남습니다.

4. /base-info 502도 설명됨
   proxy는 upstream 401을 그대로 노출하지 않고 502로 감싸서 반환하고 있어서, 사용자는 지금 502로만 보게 됩니다.

5. /trade-info 는 이슈 본문 예시 날짜가 섞여 있어 보임
   이슈 본문의 20260404 는 토요일(2026-04-04) 이라 정상 영업일이 아닙니다.
   그래서 trade-info 는 그 날짜에 row가 없고, 현재 구현상 fallback으로 base-info 를 다시 조회하다가 KOSPI base-info 401 을 맞고 최종적으로 502가 된 것으로 보입니다.
   반대로 2026-04-08(수) 기준 trade-info?market=KOSPI&code=005930&bas_dd=20260408 는 지금 프로덕션에서도 200 정상 응답합니다.

정리하면, 네, 권한 문제로 보는 게 맞습니다. 다만 범위는 KRX_API_KEY 전체가 아니라 적어도 KOSPI base-info (stk_isu_base_info) 접근 권한이 없는 상태로 보입니다.

운영 측 다음 확인 포인트는 이 2개입니다:

• KRX 포털에서 현재 키에 stk_isu_base_info 사용 권한이 실제로 붙어 있는지
• 최근에 KOSPI용 API 상품/승인 상태가 바뀌었는지 (KOSDAQ/KONEX는 살아 있으므로 계정 전체 중단 가능성은 상대적으로 낮음)

[vkehfdl1]

정확히 어떤 권한이 없는것인데? 내가 KRX API에서 여러 API key들을 승인 받았는데... 어떤 권한이 없는 것인지 알려주면 내가 추가 신청 하겠음.
https://openapi.krx.co.kr/contents/OPP/USES/service/OPPUSES001_S1.cmd
이쪽에서 어떤 API들 제공 가능한지 봐 (이 사이트 하나에 나온 것이 전부는 아님, 왼쪽의 메뉴를 통해서 어떤 조회가 가능한지 볼 수 있음)

[vkehfdl1]

확인해봤습니다. 추가 신청이 필요한 권한은 주식 > 유가증권 종목기본정보 API (stk_isu_base_info) 쪽으로 보입니다.

근거:

• KRX 공식 주식 서비스 목록(OPPUSES001_S1D1.cmd with path=sto)에는 아래 8개가 잡힙니다.
  • stk_bydd_trd = 유가증권 일별매매정보
  • ksq_bydd_trd = 코스닥 일별매매정보
  • knx_bydd_trd = 코넥스 일별매매정보
  • stk_isu_base_info = 유가증권 종목기본정보
  • ksq_isu_base_info = 코스닥 종목기본정보
  • knx_isu_base_info = 코넥스 종목기본정보
  • 그 외 신주인수권 2종
• 같은 KRX API 키로 2026-04-10에 upstream 직접 호출해 보니:
  • stk_isu_base_info → 401 Unauthorized API Call
  • ksq_isu_base_info → 200 정상
  • knx_isu_base_info → 200 정상
  • stk_bydd_trd → 200 정상 (영업일 20260408, 20260409 기준)
• 그리고 KRX 공식 상세 페이지 OPPUSES002_S2.cmd?BO_ID=PiwgMdTwmsenXhmqqxuj 가 바로 유가증권 종목기본정보 / stk_isu_base_info 상세입니다.

즉, 현재 관측으로는:

1. 키 전체가 막힌 건 아님
   코스닥/코넥스 종목기본정보와 유가증권 일별매매정보는 같은 키로 응답이 옵니다.

2. 빠진 권한은 stk_isu_base_info 쪽
   KRX 포털에서 보면 사람 이름으로는 유가증권 종목기본정보, API ID로는 stk_isu_base_info 입니다.

3. 왜 이게 issue 증상과 정확히 연결되냐면:

   • /base-info?market=KOSPI... 는 이 API를 직접 치므로 바로 실패
   • /search 는 KOSPI base-info snapshot도 같이 긁어서 검색하므로, 삼성전자/005930 같은 KOSPI 종목이 통째로 빠짐
   • /trade-info 는 영업일이면 stk_bydd_trd 로 정상 동작 가능하지만, 휴장일/빈 row일 때 fallback으로 base-info를 다시 보다가 stk_isu_base_info 401에 걸려 502로 보일 수 있음

그래서 KRX 쪽에서는 주식 카테고리의 유가증권 종목기본정보 (stk_isu_base_info) 승인/이용권한 이 현재 키에 붙어 있는지 먼저 확인하면 됩니다.
이미 여러 키를 승인받으셨다면, 지금 proxy가 실제로 쓰는 그 키 에 이 항목이 포함돼 있는지 꼭 따로 확인해야 합니다.