Menu
한국은행 ECOS Open API로 기준금리, 환율, 소비자물가지수, 통화량 등 중앙은행 경제통계 시계열과 100대 핵심지표를 조회한다. Use when the user asks 기준금리, 환율 추이, 물가지수, M2, 국고채 금리, 거시경제 통계. Not for 주식 시세(korean-stock-search) or KOSIS 일반 통계(kosis-stats).
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | bok-ecos-stats |
| description | 한국은행 ECOS Open API로 기준금리, 환율, 소비자물가지수, 통화량 등 중앙은행 경제통계 시계열과 100대 핵심지표를 조회한다. Use when the user asks 기준금리, 환율 추이, 물가지수, M2, 국고채 금리, 거시경제 통계. Not for 주식 시세(korean-stock-search) or KOSIS 일반 통계(kosis-stats). |
| license | MIT |
| metadata | {"category":"data","locale":"ko-KR","phase":"v1"} |
한국은행 경제통계시스템(ECOS) Open API https://ecos.bok.or.kr/api/ 로 중앙은행 경제통계를 조회한다.
search — 통계코드(또는 alias) 기반 시계열 데이터 조회tables — 통계표 카탈로그 목록items — 특정 통계표의 항목(item) 목록key — 100대 핵심지표 (환율/금리/물가/국민소득 등 최신값)word — 통계 용어 사전 검색조회 전용이다. 투자 판단·전망 단정은 범위 밖이다.
korean-stock-search, toss-securitieskosis-statssample)로 무가입 동작 확인 (2026-07-21). 단 호출당 최대 10행 제한이 있다. 공개 엔드포인트이므로 k-skill-proxy를 경유하지 않고 직접 호출한다.선택 환경변수 (더 많은 행이 필요할 때):
KSKILL_BOK_ECOS_API_KEY — https://ecos.bok.or.kr/api 회원가입 후 무료 발급. ~/.config/k-skill/secrets.env 의 같은 키도 읽는다.python3 bok-ecos-stats/scripts/bok_ecos.py search --alias 기준금리 --start 20260101 --end 20260721 --text
python3 bok-ecos-stats/scripts/bok_ecos.py search --alias 원달러환율 --start 20260701 --end 20260721 --text
python3 bok-ecos-stats/scripts/bok_ecos.py search --alias 소비자물가지수 --start 202501 --end 202606 --text
지원 alias: 기준금리, 원달러환율, 소비자물가지수(=cpi), M2(=통화량), 국고채3년.
--start/--end는 주기 형식을 따른다: 일(D) YYYYMMDD, 월(M) YYYYMM, 분기(Q) YYYYQn, 연(A) YYYY.
python3 bok-ecos-stats/scripts/bok_ecos.py key --limit 10 --text
python3 bok-ecos-stats/scripts/bok_ecos.py tables --text
python3 bok-ecos-stats/scripts/bok_ecos.py items --stat-code 722Y001 --text
python3 bok-ecos-stats/scripts/bok_ecos.py search --stat-code 722Y001 --cycle D \
--start 20260101 --end 20260721 --item-code 0101000 --text
python3 bok-ecos-stats/scripts/bok_ecos.py word --query 소비자물가지수 --text
--text 없이 실행하면 구조화 JSON(result, rows, source)을 출력한다.
https://ecos.bok.or.kr/api/<Service>/<key>/json/kr/<start>/<end>/<segments...> — 쿼리스트링 없는 positional URL. 한글 검색어는 helper가 percent-encoding 처리한다.sample: 무가입, 호출당 최대 10행 (초과 시 ERROR-301).{"RESULT":{"CODE":"INFO-100"}}.{"RESULT":{"CODE":"INFO-200","MESSAGE":"해당하는 데이터가 없습니다."}} → result: "empty".| 상황 | 동작 |
|---|---|
빈 결과 (INFO-200) | result: "empty" — 기간/코드 확인 안내 |
인증키 오류 (INFO-100) | 개인 키 발급/확인 안내 |
sample 10행 초과 (ERROR-301) | 개인 키 발급 안내 (helper는 sample 사용 시 limit을 10으로 자동 캡) |
| 알 수 없는 alias, stat-code 없는 search | upstream 미호출, 사용법 오류 출력 |
| HTTP 오류/타임아웃/JSON 파싱 실패 | 차단·점검 가능성 안내 후 종료 코드 1 |
time)을 반드시 함께 표시한다.Korean apartment and individual-house official price lookup through the public realtyprice.kr web data surface. Use when the user asks for 공동주택가격, 개별주택가격, 아파트 공시가격, 단독주택 공시가격, or housing official price history. This is not land official price, transaction price, or building register metadata.
한국도로공사·국가교통정보센터 공개 API로 고속도로 실시간 소통(구간별 속도/교통량/정체 등급)과 CCTV 스트림 메타데이터를 조회한다. Use when the user asks 고속도로 정체, 교통 상황, 노선/구간 소통, 고속도로 CCTV. Not for 대중교통 길찾기 or 자동차 경로 안내.
After installing the full k-skill bundle, configure and verify the shared cross-platform setup, then optionally wire update checks and GitHub starring with explicit user consent.
국가데이터처가 운영하는 KOSIS(국가통계포털, kosis.kr) Open API로 한국 공식 통계표를 검색하고 메타데이터·데이터·대용량 자료를 조회한다. Use when the user asks for 한국 공식 통계 (인구, 가구, 물가, 고용 등) 수치 조회, not for analysis or visualization.
Search, reserve, inspect, and cancel KTX or Korail tickets in Korea with the korail2 + pycryptodome Python packages. Use when the user asks for KTX seats, Korail bookings, train changes, reservation status, remaining seat numbers, car-by-car seats, or power-outlet/good-seat tips.
Use when the user asks to search Korean theses, academic articles, research reports, journals, or university-library catalog metadata through KERIS RISS.