[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M73H7Z0P8X8YNQZETY0WDXTY":3,"skill-same:01M73H7Z0P8X8YNQZETY0WDXTY":94},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":57,"commitSha":58,"skillDirectory":59,"forksCount":60,"repositoryHtmlUrl":61,"repositoryHomepageUrl":6,"ownerHtmlUrl":62,"ownerBlogUrl":6,"ownerDescription":63,"updatedAt":64,"install":65,"resources":77},"01M73H7Z0P8X8YNQZETY0WDXTY","k-ecos",null,"Queries the Bank of Korea Economic Statistics System (`한국은행 경제통계시스템 ECOS`) Open API for Korean macro-financial statistics — base rate, exchange rates, money supply, interest rates, GDP, and the `100대 통계지표` (100 key indicators) quick lookup. Covers statistics-table discovery, item-code lookup, time-series data retrieval, terminology glossary, and metadata lookup. Requires ECOS_API_KEY environment variable; a public demo key (`sample`) works for smoke tests capped at 10 rows per request.","5throck\u002Fai-workspace-standards","5throck","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F10958964?v=4","01M73BFEH0V0VS483TW4JD49JW","01M73BFEJ5VQZJHJSFTVPAZGDM",25,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fcommon\u002F.hermes\u002Fskills\u002Fk-ecos\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: k-ecos\nscope: common\ndescription: >\n  Queries the Bank of Korea Economic Statistics System (`한국은행 경제통계시스템\n  ECOS`) Open API for Korean macro-financial statistics — base rate, exchange\n  rates, money supply, interest rates, GDP, and the `100대 통계지표` (100 key\n  indicators) quick lookup. Covers statistics-table discovery, item-code\n  lookup, time-series data retrieval, terminology glossary, and metadata\n  lookup. Requires ECOS_API_KEY environment variable; a public demo key\n  (`sample`) works for smoke tests capped at 10 rows per request.\nversion: 1.0.1\nlast_reviewed: 2026-09-11\nstatus: active\nowner: public-data-analyst\nprerequisites: ECOS_API_KEY environment variable (public demo key `sample` usable for ≤10-row queries)\nl2_propagate: true\nrelates_to:\n  - skill: k-dart\n    type: composes_with\n  - skill: k-kosis\n    type: composes_with\n  - skill: k-opendata\n    type: composes_with\nmetadata:\n  type: domain\n  source: https:\u002F\u002Fecos.bok.or.kr\n  license: ECOS Open API terms (`경제통계 Open API 이용약관`)\n  category: financial-statistics\n  locale: ko-KR\n  triggers:\n    - k-ecos\n    - \u002Fk-ecos\n    - ECOS\n    - '`한국은행`'\n    - '`한국은행 Open API`'\n    - '`경제통계시스템`'\n    - '`기준금리`'\n    - '`환율`'\n    - '`본원통화`'\n    - '`100대 통계지표`'\n    - Bank of Korea statistics\n    - Korean monetary statistics\n---\n\n## Context\n\nUnified skill for the Bank of Korea (BOK, `한국은행`) Economic Statistics System (ECOS, `경제통계시스템`) Open API — covers statistics-table discovery, item-code lookup, time-series data retrieval, the `100대 통계지표` (100 key indicators) latest-value snapshot, statistical terminology glossary, and metadata lookup. ECOS is the authoritative primary source for Korean monetary and financial statistics (base rate, market rates, exchange rates, money supply\u002Fliquidity, credit, household finances) that KOSIS (`k-kosis`) mostly re-publishes secondhand. Complements DART-based company financials (`k-dart`) and public-portal trade data (`k-opendata`): ECOS supplies the central-bank-grade macro-financial series needed to frame a company or market narrative against Korean monetary conditions. Useful for pitch-deck research requiring verified BOK statistics with citation.\n\n## When to Use\n\n- Time-series retrieval for a known BOK statistic (e.g., \"get `한국은행 기준금리` monthly 2020–2024\")\n- Finding the right ECOS table\u002Fseries by browsing the statistics tree (\"`기준금리 관련 통계표 찾아줘`\")\n- Latest-value snapshot of headline indicators via the `100대 통계지표` (exchange rates, growth rate, income) — fastest path for a single number\n- Item-structure lookup for a table (item codes, units, available cycles, data coverage)\n- Statistical terminology lookup (\"what does `소비자동향지수` mean, per BOK\")\n- Macro-financial context research to support market-sizing or monetary-condition slides\n- Any engagement requiring verified Bank of Korea statistics with citation\n\n## Execution Steps\n\nPrefer the bundled helper `scripts\u002Fecos-fetch.ts` (see Helper Script) for retrieval steps — it handles encoding, pagination, retry, and error normalization; the raw requests below are the fallback.\n\n1. **Verify Prerequisites**: Confirm `ECOS_API_KEY` environment variable is set. If not, either use the public demo key `sample` (works for all six services, capped at 10 rows per request — enough for smoke tests and the `KeyStatisticList` quick lookup) or guide the user to \u003Chttps:\u002F\u002Fecos.bok.or.kr> (\"`MyPage` → `인증키 신청`\") to apply for a personal key.\n2. **Discover the target table**: If the user only knows a statistic by name (not `통계표코드`\u002FSTAT_CODE), browse `StatisticTableList` (`서비스 통계 목록`) — it returns the hierarchical category tree (`STAT_NAME` values like `1.1.1. 본원통화`) where searchable leaves carry `SRCH_YN=Y`. There is no keyword-search endpoint; locate the table by category navigation or from the ECOS web UI (\u003Chttps:\u002F\u002Fecos.bok.or.kr> → `통계검색` shows each table's `통계표코드` in its URL\u002Fmeta).\n3. **Resolve item codes**: Call `StatisticItemList` (`통계 세부항목 목록`) with the table code to get `ITEM_CODE`\u002F`ITEM_NAME`, `GRP_CODE` (item group = filter dimension), per-cycle availability (`CYCLE`, `START_TIME`~`END_TIME`, `DATA_CNT`), and `UNIT_NAME`. Use this to pick the cycle and item codes instead of guessing.\n4. **Retrieve data**: Call `StatisticSearch` (`통계 조회 조건 설정`) with the table code, cycle (`A`\u002F`S`\u002F`Q`\u002F`M`\u002F`SM`\u002F`D` — never `YY`\u002F`QQ`\u002F`MM`\u002F`DD`), cycle-matching date formats, and optional item codes. Pass `요청시작건수`\u002F`요청종료건수` to page through large result sets (1-based row range; `list_total_count` reports the full total).\n5. **Quick lookup (optional)**: For headline numbers (\"`지금 원달러 환율?`\", \"`경제성장률?`\"), call `KeyStatisticList` (`100대 통계지표`) first — no parameters beyond counts, returns the latest value\u002Fclassification\u002Funit for each of the ~101 key indicators.\n6. **Glossary\u002Fmetadata (optional)**: Call `StatisticWord` (`통계용어사전`) with a term, or `StatisticMeta` (`통계메타DB`) with a data name, for BOK's official explanation. Percent-encode Korean path segments.\n7. **Process Response**: Always pass `json` as the `요청유형`. A successful response is `{\"\u003CServiceName>\":{\"list_total_count\":N,\"row\":[...]}}`; an error is a bare `{\"RESULT\":{\"CODE\":\"...\",\"MESSAGE\":\"...\"}}` — treat any response with `RESULT` and no `row` as an error and surface `CODE`+`MESSAGE` verbatim.\n8. **Format Output**: Present rows sorted by `TIME`; pair `DATA_VALUE` with `UNIT_NAME`; keep original figures.\n9. **Save to Deliverables**: Store research findings in `deliverables\u002Fresearch\u002F` per project conventions; append disclaimer \"`한국은행 경제통계시스템 ECOS Open API 자료 기준 (조회: YYYY-MM-DD)`\" with the actual retrieval date.\n\n## Output Format\n\n- Table discovery: `P_STAT_CODE` \u002F `STAT_CODE` \u002F `STAT_NAME` \u002F `CYCLE` \u002F `SRCH_YN` (category tree navigation)\n- Item lookup: `GRP_NAME` \u002F `ITEM_CODE` \u002F `ITEM_NAME` \u002F `CYCLE` \u002F `START_TIME`~`END_TIME` \u002F `DATA_CNT` \u002F `UNIT_NAME`\n- Statistical data: `STAT_NAME` \u002F `ITEM_NAME1`~`ITEM_NAME4` \u002F `UNIT_NAME` \u002F `TIME` \u002F `DATA_VALUE` (the value), sorted by period\n- 100 key indicators: `CLASS_NAME` \u002F `KEYSTAT_NAME` \u002F `DATA_VALUE` \u002F `CYCLE` (latest period) \u002F `UNIT_NAME`\n- Glossary: `WORD` \u002F `CONTENT` verbatim\n- Metadata: `LVL` \u002F `CONT_NAME` \u002F `META_DATA`\n\n## Reference Material\n\n- `references\u002Fterms-ko.json` — Korean-term → ECOS code mapping (service names, cycle codes, verified starter tables, glossary). Keep SKILL.md English; look up Korean terms there.\n- Starter table codes, live-verified 2026-09-11 (codes may change — always confirm coverage via `StatisticItemList`): `722Y001` (`한국은행 기준금리 및 여수신금리`; item `0101000` `한국은행 기준금리`, cycles A\u002FQ\u002FM\u002FD), `200Y101` (`주요지표(연간지표)` — e.g. item `10101` `국내총생산(명목, 원화표시)`), `102Y004` (`본원통화 구성내역(평잔, 원계열)` — official-guide sample data).\n- If recurring lookups reveal stable table\u002Fitem patterns, add them to `references\u002Fterms-ko.json` rather than this file.\n\n## Related Skills\n\n- k-dart\n- k-kosis\n- k-opendata\n- research\n\n## ECOS Open API Specification\n\n### Prerequisites\n\n`ECOS_API_KEY` environment variable. Sign up and apply at \u003Chttps:\u002F\u002Fecos.bok.or.kr> (\"`MyPage` → `인증키 신청`\"; registration is on the Open API portal, not the main ECOS statistics site).\n\nThe literal demo key `sample` is accepted by all six services for read-only testing, capped at **10 rows per request** (exceeding it returns `ERROR-301`). Prefer it for smoke tests and `KeyStatisticList` lookups; use a personal key for real data pulls.\n\n### Request URL Format\n\nAll services use one positional path-parameter template (https and http both accepted per the official guide):\n\n```\nhttps:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002F{서비스명}\u002F{인증키}\u002F{요청유형}\u002F{언어구분}\u002F{...service-specific segments}\n```\n\nCommon leading segments:\n\n| # | Segment | Values | Notes |\n|---|---------|--------|-------|\n| 1 | `서비스명` | see below | English service name (e.g. `StatisticSearch`) |\n| 2 | `인증키` | issued key or `sample` | |\n| 3 | `요청유형` | `json` \\| `xml` | always pass explicitly |\n| 4 | `언어구분` | `kr` \\| `en` | `en` returns translated names\u002Funits |\n\n### Cycle Codes and Date Formats\n\n`StatisticSearch` cycle segment (`주기`) — **not** `YY`\u002F`QQ`\u002F`MM`\u002F`DD`; the wrong alphabet is the most common cause of `ERROR-100`:\n\n| Cycle | Meaning | Date format (`검색시작일자` \u002F `검색종료일자`) |\n|---|---|---|\n| `A` | `연` (annual) | `2024` |\n| `S` | `반년` (semi-annual) | `2024S1` \u002F `2024S2` (live-verified 2026-09-11) |\n| `Q` | `분기` (quarterly) | `2024Q1` |\n| `M` | `월` (monthly) | `202401` |\n| `SM` | `반월` (semi-monthly) | `202401S1` \u002F `202401S2` — month + half index (live-verified 2026-09-11) |\n| `D` | `일` (daily) | `20240101` |\n\nVerified-format examples: `S` → table `105Y001` (`예금규모별 계좌수 및 금액`), `SM` → table `814Y002` (`예금은행 지급준비액(구기준, 평잔)`, data ends 2008). When unsure of a table's cycles and coverage, read `CYCLE`\u002F`START_TIME`\u002F`END_TIME` from `StatisticItemList` first — the `START_TIME`\u002F`END_TIME` values themselves show the exact date format for that cycle. The date format must match the cycle exactly, otherwise `ERROR-101` (`주기와 다른 형식의 날짜 형식입니다`).\n\n### 1. StatisticSearch (`통계 조회 조건 설정`) — main data endpoint\n\n```\nGET https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticSearch\u002F{인증키}\u002F{요청유형}\u002F{언어}\u002F{요청시작건수}\u002F{요청종료건수}\u002F{통계표코드}\u002F{주기}\u002F{검색시작일자}\u002F{검색종료일자}\u002F{통계항목코드1}\u002F{통계항목코드2}\u002F{통계항목코드3}\u002F{통계항목코드4}\n```\n\n| Segment | Required | Description |\n|---|---|---|\n| `요청시작건수`\u002F`요청종료건수` | Y | 1-based row range of the full result (guide sample: `1`\u002F`10`); page through via `list_total_count` |\n| `통계표코드` | Y | e.g. `722Y001` |\n| `주기` | Y | `A`\u002F`S`\u002F`Q`\u002F`M`\u002F`SM`\u002F`D` |\n| `검색시작일자`\u002F`검색종료일자` | Y | cycle-matching format |\n| `통계항목코드1`~`4` | N | item path (1–4 levels). Omit to receive **all** items of the table |\n\nResponse row fields: `STAT_CODE`, `STAT_NAME`, `ITEM_CODE1`~`4`, `ITEM_NAME1`~`4`, `UNIT_NAME`, `WGT`, `TIME`, `DATA_VALUE`.\n\n### 2. StatisticTableList (`서비스 통계 목록`) — category tree\n\n```\nGET https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticTableList\u002F{인증키}\u002F{요청유형}\u002F{언어}\u002F{요청시작건수}\u002F{요청종료건수}\u002F{통계표코드}\n```\n\n| Segment | Required | Description |\n|---|---|---|\n| `통계표코드` | N | filters to one table when given |\n\nResponse row fields: `P_STAT_CODE`, `STAT_CODE`, `STAT_NAME`, `CYCLE`, `SRCH_YN`, `ORG_NAME`. Navigate the hierarchy via `P_STAT_CODE` → `STAT_CODE`; leaves with `SRCH_YN=Y` are queryable in `StatisticSearch`.\n\n### 3. StatisticItemList (`통계 세부항목 목록`) — item codes per table\n\n```\nGET https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticItemList\u002F{인증키}\u002F{요청유형}\u002F{언어}\u002F{요청시작건수}\u002F{요청종료건수}\u002F{통계표코드}\n```\n\nResponse row fields: `STAT_CODE`, `STAT_NAME`, `GRP_CODE`, `GRP_NAME`, `ITEM_CODE`, `ITEM_NAME`, `P_ITEM_CODE`, `P_ITEM_NAME`, `CYCLE`, `START_TIME`, `END_TIME`, `DATA_CNT`, `UNIT_NAME`, `WEIGHT`. `GRP_NAME` names the filter dimension (`계정항목`, `지역코드`, …); item codes are passed to `StatisticSearch` in group order.\n\n### 4. KeyStatisticList (`100대 통계지표`) — latest headline values\n\n```\nGET https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FKeyStatisticList\u002F{인증키}\u002F{요청유형}\u002F{언어}\u002F{요청시작건수}\u002F{요청종료건수}\n```\n\nNo service-specific segments. ~101 rows; response row fields: `CLASS_NAME`, `KEYSTAT_NAME`, `DATA_VALUE`, `CYCLE` (latest period), `UNIT_NAME`. Best first stop for \"current\" values (`환율`, `경제성장률`, `기준금리`, `가구소득`, …).\n\n### 5. StatisticWord (`통계용어사전`) — glossary\n\n```\nGET https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticWord\u002F{인증키}\u002F{요청유형}\u002F{언어}\u002F{요청시작건수}\u002F{요청종료건수}\u002F{용어}\n```\n\n| Segment | Required | Description |\n|---|---|---|\n| `용어` | Y | Korean term (e.g. `소비자동향지수`) — percent-encode |\n\nResponse row fields: `WORD`, `CONTENT` (BOK's official explanation, up to 4000 chars).\n\n### 6. StatisticMeta (`통계메타DB`) — metadata\n\n```\nGET https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticMeta\u002F{인증키}\u002F{요청유형}\u002F{언어}\u002F{요청시작건수}\u002F{요청종료건수}\u002F{데이터명}\n```\n\n| Segment | Required | Description |\n|---|---|---|\n| `데이터명` | Y | Korean data name (e.g. `경제심리지수`) — percent-encode |\n\nResponse row fields: `LVL`, `P_CONT_CODE`, `CONT_CODE`, `CONT_NAME`, `META_DATA`.\n\n### Quick Recipes (verified 2026-09-11)\n\n```bash\n# 1) Latest headline values (환율\u002F성장률\u002F기준금리\u002F…): page with a personal key,\n#    or 1\u002F10 windows with the sample key\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FKeyStatisticList\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F101\u002F'\n# → filter rows client-side by CLASS_NAME\u002FKEYSTAT_NAME; CYCLE holds the latest period\n\n# 2) BOK base rate, most recent 12 months (item 0101000 = 한국은행 기준금리)\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticSearch\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F12\u002F722Y001\u002FM\u002F202509\u002F202608\u002F0101000\u002F'\n\n# 3) Annual nominal GDP (200Y101 주요지표(연간지표), item 10101 = 국내총생산(명목))\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticSearch\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F10\u002F200Y101\u002FA\u002F2020\u002F2025\u002F10101\u002F'\n```\n\nAll three return the standard success envelope; recipe 1 works with the `sample` key only in 10-row windows.\n\n### Helper Script\n\n`scripts\u002Fecos-fetch.ts` (self-contained, bun) wraps everything in this section — Korean path-segment encoding, 1-based row-range pagination (respecting the `sample` key's ≤10-row windows), exponential backoff on `ERROR-602`\u002FHTTP 5xx, and error-envelope normalization. Prefer it over hand-rolled `curl`; the raw requests above are the no-tooling fallback.\n\n```bash\n# BOK base rate, monthly, most recent 12 months → markdown table\nbun scripts\u002Fecos-fetch.ts --service StatisticSearch --table 722Y001 --cycle M \\\n  --from 202509 --to 202608 --items 0101000 --format md --sample\n\n# Latest key indicators (auto-pages the sample-key cap)\nbun scripts\u002Fecos-fetch.ts --service KeyStatisticList --sample --format md\n```\n\n`scripts\u002Fverify-terms.ts` re-validates the codes in `references\u002Fterms-ko.json` against the live API (drift check — run it before trusting recorded codes, and refresh the file's `verified` date when it passes):\n\n```bash\nbun scripts\u002Fverify-terms.ts          # uses the sample key; --include-unverified to check all entries\n```\n\n### Example Requests\n\n```bash\n# Latest headline values — 100 key indicators (works with the `sample` key)\ncurl -fsS --get 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FKeyStatisticList\u002Fsample\u002Fjson\u002Fkr\u002F0\u002F10\u002F'\n\n# BOK base rate, monthly 2021, item 0101000 (한국은행 기준금리)\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticSearch\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F12\u002F722Y001\u002FM\u002F202101\u002F202112\u002F0101000\u002F'\n\n# Same query without item codes — returns ALL items of the table for the period\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticSearch\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F10\u002F722Y001\u002FM\u002F202601\u002F202608\u002F'\n\n# Annual GDP (명목) from the guide's example table 200Y101, item 10101\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticSearch\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F10\u002F200Y101\u002FA\u002F2020\u002F2023\u002F10101\u002F'\n\n# Browse the category tree (839 nodes as of 2026-09-11)\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticTableList\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F10\u002F'\n\n# Item codes \u002F coverage of a table\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticItemList\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F10\u002F722Y001'\n\n# Glossary lookup — percent-encode the Korean term\nWORD=$(python3 -c \"import urllib.parse; print(urllib.parse.quote('소비자동향지수'))\")\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticWord\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F10\u002F'\"$WORD\"'\u002F'\n```\n\n### Response Shape \u002F Response Policy\n\n**Verified by live testing (2026-09-11)** — all six services respond correctly with the `sample` key:\n\n- Success: a single JSON object keyed by the service name, e.g. `{\"StatisticSearch\":{\"list_total_count\":12,\"row\":[{...}, ...]}}` (`KeyStatisticList` additionally carries `row_count`). Iterate `row`; use `list_total_count` for pagination.\n- Error: a bare object `{\"RESULT\":{\"CODE\":\"...\",\"MESSAGE\":\"...\"}}` with no `row` key — surface `CODE`+`MESSAGE` verbatim. Note the guide lists codes as `정보-100`\u002F`에러-301` etc., but the JSON payload spells them `INFO-100`\u002F`ERROR-301`.\n- **Cycle-code alphabet gotcha**: the widely-copied tutorials use `YY`\u002F`QQ`\u002F`MM`\u002F`DD`; the live API returns `ERROR-100` for those. Only `A`\u002F`S`\u002F`Q`\u002F`M`\u002F`SM`\u002F`D` are accepted (official guide + verified live).\n- Row-range segments are 1-based (official sample `1`\u002F`10`). The `sample`-key cap applies to the window span: `요청종료건수 − 요청시작건수 \u003C 10`, i.e. at most 10 rows per window starting at ≥1 — verified live (`1\u002F10` and `11\u002F20` pass; `0\u002F10` fails `ERROR-301` even though `0\u002F5` passes, so a leading `0` is only safe for tiny windows). With a personal key the span cap is much larger; page in comfortable windows via `list_total_count`.\n- Omitting all item codes returns every item in the table for the date range — convenient but can be large; filter client-side or narrow the item path.\n- Korean path segments (`용어`, `데이터명`) must be percent-encoded; a literal UTF-8 Korean path segment was observed to 404 at the CDN level.\n- `DATA_VALUE` is returned as a string; keep the original string in deliverables and format for display only.\n- Append disclaimer at the end: \"`한국은행 경제통계시스템 ECOS Open API 자료 기준 (조회: YYYY-MM-DD)`\" with the actual retrieval date.\n\n### Failure Modes\n\n| Code | Meaning (verbatim source) | Action |\n|---|---|---|\n| `INFO-100` | `인증키가 유효하지 않습니다` | Check `ECOS_API_KEY`; `sample` only works with ≤10-row ranges |\n| `INFO-200` | `해당하는 데이터가 없습니다` | No data for the table\u002Fcycle\u002Fdates — verify coverage via `StatisticItemList` |\n| `ERROR-100` | `필수 값이 누락되어 있습니다` | Usually a wrong cycle code (`MM` vs `M`) or malformed dates — re-check the segment order |\n| `ERROR-101` | `주기와 다른 형식의 날짜 형식입니다` | Date format doesn't match the cycle (`2024` for `A`, `2024Q1` for `Q`, `202401` for `M`, `20240101` for `D`) |\n| `ERROR-200` | `파일타입 값이 누락 혹은 유효하지 않습니다` | Use `json` or `xml` |\n| `ERROR-300`\u002F`ERROR-301` | `조회건수 값이 누락\u002F타입이 유효하지 않습니다` | Row range missing or non-integer; with `sample`, also fires above 10 rows |\n| `ERROR-400` | `검색범위가 적정범위를 초과하여 60초 TIMEOUT` | Narrow the date range or item path and retry |\n| `ERROR-500` | `서버 오류 \u002F 해당 서비스를 찾을 수 없습니다` | Check the service name spelling |\n| `ERROR-600`\u002F`ERROR-601` | `DB Connection \u002F SQL 오류` | Transient server-side fault — retry later |\n| `ERROR-602` | `과도한 OpenAPI호출로 이용이 제한되었습니다` | Rate-limited — back off and retry after a wait |\n\n### Notes\n\n- Data source: [한국은행 경제통계시스템 ECOS Open API](https:\u002F\u002Fecos.bok.or.kr) — official developer guide at `개발가이드` → `개발 명세서` (SPA; each service's spec page has a `개발명세서 다운로드` button).\n- This skill is read-only query only.\n- License\u002Fterms: `경제통계 Open API 이용약관` — cite \"`출처: 한국은행 경제통계시스템`\" plus the retrieval date when reproducing figures in deliverables. Per-consumer daily\u002Fhourly quotas are not publicly documented; only `ERROR-602` signals throttling.\n- ECOS is the primary source for monetary\u002Ffinancial statistics; KOSIS (`k-kosis`) re-publishes some of the same series — prefer ECOS for BOK-originated series and for English-language BOK names via `언어구분=en`.\n- All endpoint shapes, the cycle-code alphabet, the `sample` key behavior, and every error code table row above were verified against the live API and the official SPA guide on 2026-09-11.\n","## Context\n\nUnified skill for the Bank of Korea (BOK, `한국은행`) Economic Statistics System (ECOS, `경제통계시스템`) Open API — covers statistics-table discovery, item-code lookup, time-series data retrieval, the `100대 통계지표` (100 key indicators) latest-value snapshot, statistical terminology glossary, and metadata lookup. ECOS is the authoritative primary source for Korean monetary and financial statistics (base rate, market rates, exchange rates, money supply\u002Fliquidity, credit, household finances) that KOSIS (`k-kosis`) mostly re-publishes secondhand. Complements DART-based company financials (`k-dart`) and public-portal trade data (`k-opendata`): ECOS supplies the central-bank-grade macro-financial series needed to frame a company or market narrative against Korean monetary conditions. Useful for pitch-deck research requiring verified BOK statistics with citation.\n\n## When to Use\n\n- Time-series retrieval for a known BOK statistic (e.g., \"get `한국은행 기준금리` monthly 2020–2024\")\n- Finding the right ECOS table\u002Fseries by browsing the statistics tree (\"`기준금리 관련 통계표 찾아줘`\")\n- Latest-value snapshot of headline indicators via the `100대 통계지표` (exchange rates, growth rate, income) — fastest path for a single number\n- Item-structure lookup for a table (item codes, units, available cycles, data coverage)\n- Statistical terminology lookup (\"what does `소비자동향지수` mean, per BOK\")\n- Macro-financial context research to support market-sizing or monetary-condition slides\n- Any engagement requiring verified Bank of Korea statistics with citation\n\n## Execution Steps\n\nPrefer the bundled helper `scripts\u002Fecos-fetch.ts` (see Helper Script) for retrieval steps — it handles encoding, pagination, retry, and error normalization; the raw requests below are the fallback.\n\n1. **Verify Prerequisites**: Confirm `ECOS_API_KEY` environment variable is set. If not, either use the public demo key `sample` (works for all six services, capped at 10 rows per request — enough for smoke tests and the `KeyStatisticList` quick lookup) or guide the user to \u003Chttps:\u002F\u002Fecos.bok.or.kr> (\"`MyPage` → `인증키 신청`\") to apply for a personal key.\n2. **Discover the target table**: If the user only knows a statistic by name (not `통계표코드`\u002FSTAT_CODE), browse `StatisticTableList` (`서비스 통계 목록`) — it returns the hierarchical category tree (`STAT_NAME` values like `1.1.1. 본원통화`) where searchable leaves carry `SRCH_YN=Y`. There is no keyword-search endpoint; locate the table by category navigation or from the ECOS web UI (\u003Chttps:\u002F\u002Fecos.bok.or.kr> → `통계검색` shows each table's `통계표코드` in its URL\u002Fmeta).\n3. **Resolve item codes**: Call `StatisticItemList` (`통계 세부항목 목록`) with the table code to get `ITEM_CODE`\u002F`ITEM_NAME`, `GRP_CODE` (item group = filter dimension), per-cycle availability (`CYCLE`, `START_TIME`~`END_TIME`, `DATA_CNT`), and `UNIT_NAME`. Use this to pick the cycle and item codes instead of guessing.\n4. **Retrieve data**: Call `StatisticSearch` (`통계 조회 조건 설정`) with the table code, cycle (`A`\u002F`S`\u002F`Q`\u002F`M`\u002F`SM`\u002F`D` — never `YY`\u002F`QQ`\u002F`MM`\u002F`DD`), cycle-matching date formats, and optional item codes. Pass `요청시작건수`\u002F`요청종료건수` to page through large result sets (1-based row range; `list_total_count` reports the full total).\n5. **Quick lookup (optional)**: For headline numbers (\"`지금 원달러 환율?`\", \"`경제성장률?`\"), call `KeyStatisticList` (`100대 통계지표`) first — no parameters beyond counts, returns the latest value\u002Fclassification\u002Funit for each of the ~101 key indicators.\n6. **Glossary\u002Fmetadata (optional)**: Call `StatisticWord` (`통계용어사전`) with a term, or `StatisticMeta` (`통계메타DB`) with a data name, for BOK's official explanation. Percent-encode Korean path segments.\n7. **Process Response**: Always pass `json` as the `요청유형`. A successful response is `{\"\u003CServiceName>\":{\"list_total_count\":N,\"row\":[...]}}`; an error is a bare `{\"RESULT\":{\"CODE\":\"...\",\"MESSAGE\":\"...\"}}` — treat any response with `RESULT` and no `row` as an error and surface `CODE`+`MESSAGE` verbatim.\n8. **Format Output**: Present rows sorted by `TIME`; pair `DATA_VALUE` with `UNIT_NAME`; keep original figures.\n9. **Save to Deliverables**: Store research findings in `deliverables\u002Fresearch\u002F` per project conventions; append disclaimer \"`한국은행 경제통계시스템 ECOS Open API 자료 기준 (조회: YYYY-MM-DD)`\" with the actual retrieval date.\n\n## Output Format\n\n- Table discovery: `P_STAT_CODE` \u002F `STAT_CODE` \u002F `STAT_NAME` \u002F `CYCLE` \u002F `SRCH_YN` (category tree navigation)\n- Item lookup: `GRP_NAME` \u002F `ITEM_CODE` \u002F `ITEM_NAME` \u002F `CYCLE` \u002F `START_TIME`~`END_TIME` \u002F `DATA_CNT` \u002F `UNIT_NAME`\n- Statistical data: `STAT_NAME` \u002F `ITEM_NAME1`~`ITEM_NAME4` \u002F `UNIT_NAME` \u002F `TIME` \u002F `DATA_VALUE` (the value), sorted by period\n- 100 key indicators: `CLASS_NAME` \u002F `KEYSTAT_NAME` \u002F `DATA_VALUE` \u002F `CYCLE` (latest period) \u002F `UNIT_NAME`\n- Glossary: `WORD` \u002F `CONTENT` verbatim\n- Metadata: `LVL` \u002F `CONT_NAME` \u002F `META_DATA`\n\n## Reference Material\n\n- `references\u002Fterms-ko.json` — Korean-term → ECOS code mapping (service names, cycle codes, verified starter tables, glossary). Keep SKILL.md English; look up Korean terms there.\n- Starter table codes, live-verified 2026-09-11 (codes may change — always confirm coverage via `StatisticItemList`): `722Y001` (`한국은행 기준금리 및 여수신금리`; item `0101000` `한국은행 기준금리`, cycles A\u002FQ\u002FM\u002FD), `200Y101` (`주요지표(연간지표)` — e.g. item `10101` `국내총생산(명목, 원화표시)`), `102Y004` (`본원통화 구성내역(평잔, 원계열)` — official-guide sample data).\n- If recurring lookups reveal stable table\u002Fitem patterns, add them to `references\u002Fterms-ko.json` rather than this file.\n\n## Related Skills\n\n- k-dart\n- k-kosis\n- k-opendata\n- research\n\n## ECOS Open API Specification\n\n### Prerequisites\n\n`ECOS_API_KEY` environment variable. Sign up and apply at \u003Chttps:\u002F\u002Fecos.bok.or.kr> (\"`MyPage` → `인증키 신청`\"; registration is on the Open API portal, not the main ECOS statistics site).\n\nThe literal demo key `sample` is accepted by all six services for read-only testing, capped at **10 rows per request** (exceeding it returns `ERROR-301`). Prefer it for smoke tests and `KeyStatisticList` lookups; use a personal key for real data pulls.\n\n### Request URL Format\n\nAll services use one positional path-parameter template (https and http both accepted per the official guide):\n\n```\nhttps:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002F{서비스명}\u002F{인증키}\u002F{요청유형}\u002F{언어구분}\u002F{...service-specific segments}\n```\n\nCommon leading segments:\n\n| # | Segment | Values | Notes |\n|---|---------|--------|-------|\n| 1 | `서비스명` | see below | English service name (e.g. `StatisticSearch`) |\n| 2 | `인증키` | issued key or `sample` | |\n| 3 | `요청유형` | `json` \\| `xml` | always pass explicitly |\n| 4 | `언어구분` | `kr` \\| `en` | `en` returns translated names\u002Funits |\n\n### Cycle Codes and Date Formats\n\n`StatisticSearch` cycle segment (`주기`) — **not** `YY`\u002F`QQ`\u002F`MM`\u002F`DD`; the wrong alphabet is the most common cause of `ERROR-100`:\n\n| Cycle | Meaning | Date format (`검색시작일자` \u002F `검색종료일자`) |\n|---|---|---|\n| `A` | `연` (annual) | `2024` |\n| `S` | `반년` (semi-annual) | `2024S1` \u002F `2024S2` (live-verified 2026-09-11) |\n| `Q` | `분기` (quarterly) | `2024Q1` |\n| `M` | `월` (monthly) | `202401` |\n| `SM` | `반월` (semi-monthly) | `202401S1` \u002F `202401S2` — month + half index (live-verified 2026-09-11) |\n| `D` | `일` (daily) | `20240101` |\n\nVerified-format examples: `S` → table `105Y001` (`예금규모별 계좌수 및 금액`), `SM` → table `814Y002` (`예금은행 지급준비액(구기준, 평잔)`, data ends 2008). When unsure of a table's cycles and coverage, read `CYCLE`\u002F`START_TIME`\u002F`END_TIME` from `StatisticItemList` first — the `START_TIME`\u002F`END_TIME` values themselves show the exact date format for that cycle. The date format must match the cycle exactly, otherwise `ERROR-101` (`주기와 다른 형식의 날짜 형식입니다`).\n\n### 1. StatisticSearch (`통계 조회 조건 설정`) — main data endpoint\n\n```\nGET https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticSearch\u002F{인증키}\u002F{요청유형}\u002F{언어}\u002F{요청시작건수}\u002F{요청종료건수}\u002F{통계표코드}\u002F{주기}\u002F{검색시작일자}\u002F{검색종료일자}\u002F{통계항목코드1}\u002F{통계항목코드2}\u002F{통계항목코드3}\u002F{통계항목코드4}\n```\n\n| Segment | Required | Description |\n|---|---|---|\n| `요청시작건수`\u002F`요청종료건수` | Y | 1-based row range of the full result (guide sample: `1`\u002F`10`); page through via `list_total_count` |\n| `통계표코드` | Y | e.g. `722Y001` |\n| `주기` | Y | `A`\u002F`S`\u002F`Q`\u002F`M`\u002F`SM`\u002F`D` |\n| `검색시작일자`\u002F`검색종료일자` | Y | cycle-matching format |\n| `통계항목코드1`~`4` | N | item path (1–4 levels). Omit to receive **all** items of the table |\n\nResponse row fields: `STAT_CODE`, `STAT_NAME`, `ITEM_CODE1`~`4`, `ITEM_NAME1`~`4`, `UNIT_NAME`, `WGT`, `TIME`, `DATA_VALUE`.\n\n### 2. StatisticTableList (`서비스 통계 목록`) — category tree\n\n```\nGET https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticTableList\u002F{인증키}\u002F{요청유형}\u002F{언어}\u002F{요청시작건수}\u002F{요청종료건수}\u002F{통계표코드}\n```\n\n| Segment | Required | Description |\n|---|---|---|\n| `통계표코드` | N | filters to one table when given |\n\nResponse row fields: `P_STAT_CODE`, `STAT_CODE`, `STAT_NAME`, `CYCLE`, `SRCH_YN`, `ORG_NAME`. Navigate the hierarchy via `P_STAT_CODE` → `STAT_CODE`; leaves with `SRCH_YN=Y` are queryable in `StatisticSearch`.\n\n### 3. StatisticItemList (`통계 세부항목 목록`) — item codes per table\n\n```\nGET https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticItemList\u002F{인증키}\u002F{요청유형}\u002F{언어}\u002F{요청시작건수}\u002F{요청종료건수}\u002F{통계표코드}\n```\n\nResponse row fields: `STAT_CODE`, `STAT_NAME`, `GRP_CODE`, `GRP_NAME`, `ITEM_CODE`, `ITEM_NAME`, `P_ITEM_CODE`, `P_ITEM_NAME`, `CYCLE`, `START_TIME`, `END_TIME`, `DATA_CNT`, `UNIT_NAME`, `WEIGHT`. `GRP_NAME` names the filter dimension (`계정항목`, `지역코드`, …); item codes are passed to `StatisticSearch` in group order.\n\n### 4. KeyStatisticList (`100대 통계지표`) — latest headline values\n\n```\nGET https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FKeyStatisticList\u002F{인증키}\u002F{요청유형}\u002F{언어}\u002F{요청시작건수}\u002F{요청종료건수}\n```\n\nNo service-specific segments. ~101 rows; response row fields: `CLASS_NAME`, `KEYSTAT_NAME`, `DATA_VALUE`, `CYCLE` (latest period), `UNIT_NAME`. Best first stop for \"current\" values (`환율`, `경제성장률`, `기준금리`, `가구소득`, …).\n\n### 5. StatisticWord (`통계용어사전`) — glossary\n\n```\nGET https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticWord\u002F{인증키}\u002F{요청유형}\u002F{언어}\u002F{요청시작건수}\u002F{요청종료건수}\u002F{용어}\n```\n\n| Segment | Required | Description |\n|---|---|---|\n| `용어` | Y | Korean term (e.g. `소비자동향지수`) — percent-encode |\n\nResponse row fields: `WORD`, `CONTENT` (BOK's official explanation, up to 4000 chars).\n\n### 6. StatisticMeta (`통계메타DB`) — metadata\n\n```\nGET https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticMeta\u002F{인증키}\u002F{요청유형}\u002F{언어}\u002F{요청시작건수}\u002F{요청종료건수}\u002F{데이터명}\n```\n\n| Segment | Required | Description |\n|---|---|---|\n| `데이터명` | Y | Korean data name (e.g. `경제심리지수`) — percent-encode |\n\nResponse row fields: `LVL`, `P_CONT_CODE`, `CONT_CODE`, `CONT_NAME`, `META_DATA`.\n\n### Quick Recipes (verified 2026-09-11)\n\n```bash\n# 1) Latest headline values (환율\u002F성장률\u002F기준금리\u002F…): page with a personal key,\n#    or 1\u002F10 windows with the sample key\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FKeyStatisticList\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F101\u002F'\n# → filter rows client-side by CLASS_NAME\u002FKEYSTAT_NAME; CYCLE holds the latest period\n\n# 2) BOK base rate, most recent 12 months (item 0101000 = 한국은행 기준금리)\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticSearch\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F12\u002F722Y001\u002FM\u002F202509\u002F202608\u002F0101000\u002F'\n\n# 3) Annual nominal GDP (200Y101 주요지표(연간지표), item 10101 = 국내총생산(명목))\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticSearch\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F10\u002F200Y101\u002FA\u002F2020\u002F2025\u002F10101\u002F'\n```\n\nAll three return the standard success envelope; recipe 1 works with the `sample` key only in 10-row windows.\n\n### Helper Script\n\n`scripts\u002Fecos-fetch.ts` (self-contained, bun) wraps everything in this section — Korean path-segment encoding, 1-based row-range pagination (respecting the `sample` key's ≤10-row windows), exponential backoff on `ERROR-602`\u002FHTTP 5xx, and error-envelope normalization. Prefer it over hand-rolled `curl`; the raw requests above are the no-tooling fallback.\n\n```bash\n# BOK base rate, monthly, most recent 12 months → markdown table\nbun scripts\u002Fecos-fetch.ts --service StatisticSearch --table 722Y001 --cycle M \\\n  --from 202509 --to 202608 --items 0101000 --format md --sample\n\n# Latest key indicators (auto-pages the sample-key cap)\nbun scripts\u002Fecos-fetch.ts --service KeyStatisticList --sample --format md\n```\n\n`scripts\u002Fverify-terms.ts` re-validates the codes in `references\u002Fterms-ko.json` against the live API (drift check — run it before trusting recorded codes, and refresh the file's `verified` date when it passes):\n\n```bash\nbun scripts\u002Fverify-terms.ts          # uses the sample key; --include-unverified to check all entries\n```\n\n### Example Requests\n\n```bash\n# Latest headline values — 100 key indicators (works with the `sample` key)\ncurl -fsS --get 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FKeyStatisticList\u002Fsample\u002Fjson\u002Fkr\u002F0\u002F10\u002F'\n\n# BOK base rate, monthly 2021, item 0101000 (한국은행 기준금리)\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticSearch\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F12\u002F722Y001\u002FM\u002F202101\u002F202112\u002F0101000\u002F'\n\n# Same query without item codes — returns ALL items of the table for the period\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticSearch\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F10\u002F722Y001\u002FM\u002F202601\u002F202608\u002F'\n\n# Annual GDP (명목) from the guide's example table 200Y101, item 10101\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticSearch\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F10\u002F200Y101\u002FA\u002F2020\u002F2023\u002F10101\u002F'\n\n# Browse the category tree (839 nodes as of 2026-09-11)\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticTableList\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F10\u002F'\n\n# Item codes \u002F coverage of a table\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticItemList\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F10\u002F722Y001'\n\n# Glossary lookup — percent-encode the Korean term\nWORD=$(python3 -c \"import urllib.parse; print(urllib.parse.quote('소비자동향지수'))\")\ncurl -fsS 'https:\u002F\u002Fecos.bok.or.kr\u002Fapi\u002FStatisticWord\u002F'\"$ECOS_API_KEY\"'\u002Fjson\u002Fkr\u002F1\u002F10\u002F'\"$WORD\"'\u002F'\n```\n\n### Response Shape \u002F Response Policy\n\n**Verified by live testing (2026-09-11)** — all six services respond correctly with the `sample` key:\n\n- Success: a single JSON object keyed by the service name, e.g. `{\"StatisticSearch\":{\"list_total_count\":12,\"row\":[{...}, ...]}}` (`KeyStatisticList` additionally carries `row_count`). Iterate `row`; use `list_total_count` for pagination.\n- Error: a bare object `{\"RESULT\":{\"CODE\":\"...\",\"MESSAGE\":\"...\"}}` with no `row` key — surface `CODE`+`MESSAGE` verbatim. Note the guide lists codes as `정보-100`\u002F`에러-301` etc., but the JSON payload spells them `INFO-100`\u002F`ERROR-301`.\n- **Cycle-code alphabet gotcha**: the widely-copied tutorials use `YY`\u002F`QQ`\u002F`MM`\u002F`DD`; the live API returns `ERROR-100` for those. Only `A`\u002F`S`\u002F`Q`\u002F`M`\u002F`SM`\u002F`D` are accepted (official guide + verified live).\n- Row-range segments are 1-based (official sample `1`\u002F`10`). The `sample`-key cap applies to the window span: `요청종료건수 − 요청시작건수 \u003C 10`, i.e. at most 10 rows per window starting at ≥1 — verified live (`1\u002F10` and `11\u002F20` pass; `0\u002F10` fails `ERROR-301` even though `0\u002F5` passes, so a leading `0` is only safe for tiny windows). With a personal key the span cap is much larger; page in comfortable windows via `list_total_count`.\n- Omitting all item codes returns every item in the table for the date range — convenient but can be large; filter client-side or narrow the item path.\n- Korean path segments (`용어`, `데이터명`) must be percent-encoded; a literal UTF-8 Korean path segment was observed to 404 at the CDN level.\n- `DATA_VALUE` is returned as a string; keep the original string in deliverables and format for display only.\n- Append disclaimer at the end: \"`한국은행 경제통계시스템 ECOS Open API 자료 기준 (조회: YYYY-MM-DD)`\" with the actual retrieval date.\n\n### Failure Modes\n\n| Code | Meaning (verbatim source) | Action |\n|---|---|---|\n| `INFO-100` | `인증키가 유효하지 않습니다` | Check `ECOS_API_KEY`; `sample` only works with ≤10-row ranges |\n| `INFO-200` | `해당하는 데이터가 없습니다` | No data for the table\u002Fcycle\u002Fdates — verify coverage via `StatisticItemList` |\n| `ERROR-100` | `필수 값이 누락되어 있습니다` | Usually a wrong cycle code (`MM` vs `M`) or malformed dates — re-check the segment order |\n| `ERROR-101` | `주기와 다른 형식의 날짜 형식입니다` | Date format doesn't match the cycle (`2024` for `A`, `2024Q1` for `Q`, `202401` for `M`, `20240101` for `D`) |\n| `ERROR-200` | `파일타입 값이 누락 혹은 유효하지 않습니다` | Use `json` or `xml` |\n| `ERROR-300`\u002F`ERROR-301` | `조회건수 값이 누락\u002F타입이 유효하지 않습니다` | Row range missing or non-integer; with `sample`, also fires above 10 rows |\n| `ERROR-400` | `검색범위가 적정범위를 초과하여 60초 TIMEOUT` | Narrow the date range or item path and retry |\n| `ERROR-500` | `서버 오류 \u002F 해당 서비스를 찾을 수 없습니다` | Check the service name spelling |\n| `ERROR-600`\u002F`ERROR-601` | `DB Connection \u002F SQL 오류` | Transient server-side fault — retry later |\n| `ERROR-602` | `과도한 OpenAPI호출로 이용이 제한되었습니다` | Rate-limited — back off and retry after a wait |\n\n### Notes\n\n- Data source: [한국은행 경제통계시스템 ECOS Open API](https:\u002F\u002Fecos.bok.or.kr) — official developer guide at `개발가이드` → `개발 명세서` (SPA; each service's spec page has a `개발명세서 다운로드` button).\n- This skill is read-only query only.\n- License\u002Fterms: `경제통계 Open API 이용약관` — cite \"`출처: 한국은행 경제통계시스템`\" plus the retrieval date when reproducing figures in deliverables. Per-consumer daily\u002Fhourly quotas are not publicly documented; only `ERROR-602` signals throttling.\n- ECOS is the primary source for monetary\u002Ffinancial statistics; KOSIS (`k-kosis`) re-publishes some of the same series — prefer ECOS for BOK-originated series and for English-language BOK names via `언어구분=en`.\n- All endpoint shapes, the cycle-code alphabet, the `sample` key behavior, and every error code table row above were verified against the live API and the official SPA guide on 2026-09-11.\n",{"name":5,"owner":23,"scope":24,"status":25,"version":26,"metadata":27,"relates_to":45,"description":53,"l2_propagate":54,"last_reviewed":55,"prerequisites":56},"public-data-analyst","common","active","1.0.1",{"type":28,"locale":29,"source":30,"license":31,"category":32,"triggers":33},"domain","ko-KR","https:\u002F\u002Fecos.bok.or.kr","ECOS Open API terms (`경제통계 Open API 이용약관`)","financial-statistics",[5,34,35,36,37,38,39,40,41,42,43,44],"\u002Fk-ecos","ECOS","`한국은행`","`한국은행 Open API`","`경제통계시스템`","`기준금리`","`환율`","`본원통화`","`100대 통계지표`","Bank of Korea statistics","Korean monetary statistics",[46,49,51],{"type":47,"skill":48},"composes_with","k-dart",{"type":47,"skill":50},"k-kosis",{"type":47,"skill":52},"k-opendata","Queries the Bank of Korea Economic Statistics System (`한국은행 경제통계시스템 ECOS`) Open API for Korean macro-financial statistics — base rate, exchange rates, money supply, interest rates, GDP, and the `100대 통계지표` (100 key indicators) quick lookup. Covers statistics-table discovery, item-code lookup, time-series data retrieval, terminology glossary, and metadata lookup. Requires ECOS_API_KEY environment variable; a public demo key (`sample`) works for smoke tests capped at 10 rows per request.\n",true,1789084800000,"ECOS_API_KEY environment variable (public demo key `sample` usable for ≤10-row queries)","main","b57e612781a79b0e3e60878294ce59c86cc68e5d","templates\u002Fcommon\u002F.hermes\u002Fskills\u002Fk-ecos",9,"https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards","https:\u002F\u002Fgithub.com\u002F5throck","Experienced in digital transformation, enterprise IT, startup acceleration, and business strategy. Focused on building practical systems that connect technolo","2026-11-14 21:22:34",{"source":8,"skillName":5,"commands":66,"prompt":76,"zipAvailable":54},[67,70,73],{"tool":68,"command":69},"npx","npx skills add 5throck\u002Fai-workspace-standards --skill k-ecos",{"tool":71,"command":72},"bunx","bunx skills add 5throck\u002Fai-workspace-standards --skill k-ecos",{"tool":74,"command":75},"pnpm","pnpm dlx skills add 5throck\u002Fai-workspace-standards --skill k-ecos","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fcommon\u002F.hermes\u002Fskills\u002Fk-ecos\u002FSKILL.md",[78,84,90],{"path":79,"resourceType":80,"resourceTypeDesc":81,"sizeBytes":82,"sourceHtmlUrl":83},"references\u002Fterms-ko.json","REFERENCE","参考文档",4871,"https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fcommon\u002F.hermes\u002Fskills\u002Fk-ecos\u002Freferences\u002Fterms-ko.json",{"path":85,"resourceType":86,"resourceTypeDesc":87,"sizeBytes":88,"sourceHtmlUrl":89},"scripts\u002Fecos-fetch.ts","SCRIPT","脚本",10680,"https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fcommon\u002F.hermes\u002Fskills\u002Fk-ecos\u002Fscripts\u002Fecos-fetch.ts",{"path":91,"resourceType":86,"resourceTypeDesc":87,"sizeBytes":92,"sourceHtmlUrl":93},"scripts\u002Fverify-terms.ts",5167,"https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fcommon\u002F.hermes\u002Fskills\u002Fk-ecos\u002Fscripts\u002Fverify-terms.ts",[95,103,108,113,118,123],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":102},"01M7BBJDYHJMGTJYSC37JVWY8S","i18n-layout","Text layout and encoding guidance: character encoding (UTF-8, legacy Korean code pages, BOM hazards), line endings, RTL\u002Fbidi handling, and script-specific font selection (Hangul focus). Use when: encoding is corrupted or mojibake appears, an RTL locale must render correctly, fonts must be chosen for a script, or CRLF\u002FBOM issues surface.","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":104,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":102},"01M7BBJ9XHAAS1AVGKZZ841VBZ","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.hermes\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":109,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":102},"01M7BBJ5C3X8TKFKG5R9P9P49W","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.gemini\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":114,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":102},"01M7BBJ1B52X0QMJ2QVBMPJB37","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.codex\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":119,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":120,"categories":121,"keywords":122,"publishedAt":102},"01M7BBHX91BW2Q2R276MRX5AW3","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.claude\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":124,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":125,"categories":126,"keywords":127,"publishedAt":102},"01M7BBHQWGXPSFRWN1PRC2NMMV","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.agents\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[]]