kosis-stats

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

KOSIS Stats

What this skill does

本Skill的功能

국가데이터처(구 통계청)가 운영하는 KOSIS(국가통계포털) Open API

https://kosis.kr/openapi/

로 한국 공식 통계 자료를 조회 자동화한다.

이 스킬은 조회 전용이다. 통계 작성, 데이터 변경, 대시보드 등록, 사용자별 통계 자료 등록은 범위에 포함하지 않는다.

지원 endpoint:

```
statisticsSearch.do
```
— 키워드로 통계표 검색
```
statisticsData.do?method=getMeta
```
— 통계표 메타데이터 (분류·항목·단위)
```
statisticsParameterData.do
```
— 통계표 데이터 셀 조회 (기간/분류 필터)
```
statisticsBigData.do
```
— 대용량 자료 (사전 등록한
```
userStatsId
```
필요)

通过国家数据厅（原统计厅）运营的KOSIS（国家统计门户）Open API

https://kosis.kr/openapi/

实现韩国官方统计资料的查询自动化。

本Skill为查询专用，不包含统计表格制作、数据修改、仪表盘注册、用户专属统计资料注册等功能。

支持的endpoint:

```
statisticsSearch.do
```
— 通过关键词搜索统计表格
```
statisticsData.do?method=getMeta
```
— 查询统计表格元数据（分类、项目、单位）
```
statisticsParameterData.do
```
— 查询统计表格数据单元格（支持时间/分类筛选）
```
statisticsBigData.do
```
— 获取大容量资料（需预先注册的
```
userStatsId
```
）

When to use

使用场景

"1인 가구 비율 통계 찾아줘"
"KOSIS에서 고령인구 비율 시도별 데이터 가져와"
"DT_1IN0001 표 메타데이터 보여줘"
"최근 5년치 소비자물가지수 KOSIS에서 뽑아줘"

"帮我查找单人家庭比例统计"
"从KOSIS获取各道市的高龄人口比例数据"
"展示DT_1IN0001表格的元数据"
"从KOSIS提取最近5年的消费者物价指数"

When not to use

非适用场景

실시간 시세나 거래소 데이터를 원하는 경우 (KOSIS는 공식 통계용)
데이터 시각화·분석·보고서 작성이 주 목적인 경우 (이 스킬은 raw 데이터 조회만)
통계 작성·등록·수정이 필요한 경우
대용량 자료를 받기 위해 사용자별 자료(
```
userStatsId
```
)를 새로 등록해야 하는 경우 (KOSIS 웹에서 직접 등록)

需要实时行情或交易所数据的情况（KOSIS仅用于官方统计）
以数据可视化、分析、报告撰写为主要目的的情况（本Skill仅支持原始数据查询）
需要制作、注册、修改统计表格的情况
需新注册用户专属资料(
```
userStatsId
```
)才能获取大容量资料的情况（需直接在KOSIS网页完成注册）

Prerequisites

前置条件

Python 3.9+ (stdlib only, 외부 패키지 없음)
일반
```
search
```
/
```
meta
```
/
```
data
```
:
```
k-skill-proxy
```
의 KOSIS route가 있는 hosted/self-host 프록시에 접근 가능할 것
```
bigdata
```
또는
```
--direct
```
: KOSIS Open API 인증키 (무료, https://kosis.kr/openapi/ 에서 회원가입 후 활용신청)

bash

python3 kosis-stats/scripts/run_kosis_stats.py --help

Python 3.9+（仅使用标准库，无需外部包）
常规
```
search
```
/
```
meta
```
/
```
data
```
操作：可访问带有KOSIS路由的
```
k-skill-proxy
```
托管/自托管代理
```
bigdata
```
或
```
--direct
```
操作：需KOSIS Open API认证密钥（免费，可在https://kosis.kr/openapi/ 注册会员后申请）

bash

python3 kosis-stats/scripts/run_kosis_stats.py --help

Required environment variables

必要环境变量

일반

search

meta

data

: 없음. 기본 hosted

https://k-skill-proxy.nomadamas.org

를 사용한다.

```
KSKILL_PROXY_BASE_URL
```
— self-host·별도 프록시를 쓸 때만 설정. 비우면 기본 hosted proxy를 사용한다.
```
KSKILL_KOSIS_API_KEY
```
—
```
bigdata
```
또는
```
--direct
```
로 KOSIS를 직접 호출할 때만 필요하다.

발급 절차와 호출 한도, 에러 코드 등 자세한 내용은

references/kosis-openapi-guide.md

참고.

常规

search

meta

data

操作：无，默认使用托管代理

https://k-skill-proxy.nomadamas.org

```
KSKILL_PROXY_BASE_URL
```
— 仅在使用自托管/其他代理时设置，留空则使用默认托管代理
```
KSKILL_KOSIS_API_KEY
```
— 仅在通过
```
bigdata
```
或
```
--direct
```
直接调用KOSIS时需要

关于密钥申请流程、调用限制、错误代码等详细信息，请参考

references/kosis-openapi-guide.md

Credential resolution order (

bigdata

또는

--direct

전용)

凭证获取优先级（仅适用于

bigdata

或

--direct

操作）

이미 환경변수에 있으면 그대로 사용한다.
에이전트가 자체 secret vault(1Password CLI, Bitwarden CLI, macOS Keychain 등)를 사용 중이면 거기서 꺼내 환경변수로 주입해도 된다.
~/.config/k-skill/secrets.env
(기본 fallback) — plain dotenv 파일, 퍼미션
```
0600
```
.
아무것도 없으면 유저에게 물어서 2 또는 3에 저장한다.

기본 경로에 저장하는 것은 fallback일 뿐, 강제가 아니다. 일반 조회 helper는 proxy URL만 읽고, KOSIS 인증키는 proxy 서버에서만 주입한다.

bigdata

--direct

호출만

KSKILL_KOSIS_API_KEY

환경변수와 위 secrets 파일을 읽는다.

已存在于环境变量中：直接使用
Agent正在使用自有密钥库（1Password CLI、Bitwarden CLI、macOS钥匙串等）：可从中提取并注入环境变量
~/.config/k-skill/secrets.env
（默认备用方案）：纯文本dotenv文件，权限需设为
```
0600
```
无任何凭证时：询问用户并保存至上述第2或第3种方式

默认路径仅作为备用方案，并非强制要求。常规查询工具仅读取代理URL，KOSIS认证密钥仅在代理服务器注入。仅

bigdata

--direct

调用会读取

KSKILL_KOSIS_API_KEY

环境变量及上述密钥文件。

Inputs

输入参数

서브커맨드:

search

meta

data

bigdata

공통 옵션:

```
--text
```
: 사람용 요약
```
--json
```
: 구조화 결과 (기본값)
```
--dry-run
```
: 인증키 없이 요청 URL/파라미터만 출력
```
--timeout N
```
: HTTP 타임아웃 초 단위 (기본 30)
```
--proxy-base-url URL
```
: 기본 hosted proxy 대신 self-host/alternate proxy 사용
```
--direct
```
: proxy를 우회하고
```
KSKILL_KOSIS_API_KEY
```
로 KOSIS 직접 호출

서브커맨드별 입력:

search

```
--query "키워드"
```
```
--result-count N
```
(1-5000, 기본 20)
```
--start-count N
```
(페이징 시작, 기본 1)

meta

```
--org-id 101
```
(기본 101=통계청)
```
--table-id DT_1IN0001
```
```
--meta-type TBL|ITM|OBJ
```
(기본 TBL)

data

```
--org-id 101
```
```
--table-id DT_1IN0001
```
```
--prd-se M|Q|S|Y|F|IR
```
(수록 주기)

--start YYYY[MM|QQ|HH]

--end YYYY[MM|QQ|HH]

```
--itm-id ALL
```
(항목 ID, 기본 ALL)
```
--obj-l 1=ALL --obj-l 2=00
```
(분류 필터, 반복 가능)

```
bigdata
```
- ```
--user-stats-id <KOSIS 등록 ID>
```
- ```
--format json|sdmx|csv
```
  (xls는 바이너리라 helper 미지원 — 필요 시 KOSIS 웹에서 직접 다운로드)
- ```
--prd-se
```
  ,
```
--new-est-prd-cnt
```
  (선택)

子命令：

search

meta

data

bigdata

通用选项:

```
--text
```
: 生成面向人类的摘要
```
--json
```
: 返回结构化结果（默认值）
```
--dry-run
```
: 不实际发起请求，仅输出请求URL/参数（无需认证密钥）
```
--timeout N
```
: HTTP超时时间（单位：秒，默认30）
```
--proxy-base-url URL
```
: 使用自托管/其他代理替代默认托管代理
```
--direct
```
: 绕过代理，使用
```
KSKILL_KOSIS_API_KEY
```
直接调用KOSIS

子命令专属输入:

```
search
```
- ```
--query "关键词"
```
- ```
--result-count N
```
  （范围1-5000，默认20）
- ```
--start-count N
```
  （分页起始位置，默认1）

meta

```
--org-id 101
```
（默认101=统计厅）
```
--table-id DT_1IN0001
```
```
--meta-type TBL|ITM|OBJ
```
（默认TBL）

data

```
--org-id 101
```
```
--table-id DT_1IN0001
```
```
--prd-se M|Q|S|Y|F|IR
```
（统计周期）

--start YYYY[MM|QQ|HH]

--end YYYY[MM|QQ|HH]

```
--itm-id ALL
```
（项目ID，默认ALL）
```
--obj-l 1=ALL --obj-l 2=00
```
（分类筛选，可重复设置）

```
bigdata
```
- ```
--user-stats-id <KOSIS注册ID>
```
- ```
--format json|sdmx|csv
```
  （不支持xls格式，因其为二进制文件，如需获取请直接从KOSIS网页下载）
- ```
--prd-se
```
  ,
```
--new-est-prd-cnt
```
  （可选参数）

Workflow

工作流程

1. Ensure proxy access is available

1. 确保代理访问可用

일반

search

meta

data

는 기본 hosted

k-skill-proxy

를 사용하므로 사용자 KOSIS 키가 필요 없다. self-host를 쓰면

KSKILL_PROXY_BASE_URL

을 설정한다.

bigdata

또는

--direct

가 필요할 때만

KSKILL_KOSIS_API_KEY

를 credential resolution order에 따라 확보한다. 시크릿이 없다는 이유로 다른 통계 사이트나 비공식 경로를 찾지 않는다.

常规

search

meta

data

操作默认使用托管

k-skill-proxy

，无需用户提供KOSIS密钥。使用自托管代理时需设置

KSKILL_PROXY_BASE_URL

。

仅当需要

bigdata

或

--direct

操作时，才按照凭证获取优先级获取

KSKILL_KOSIS_API_KEY

。不会因无密钥而转向其他统计网站或非官方渠道。

2. Search for candidate tables

2. 搜索候选表格

질문을 먼저 한국어 키워드로 좁히고

search

로 후보 통계표를 본다.

bash

python3 kosis-stats/scripts/run_kosis_stats.py search --query "1인 가구" --text

출력에서

[ORG_ID/TBL_ID]

를 골라 다음 단계에 사용한다.

先将用户问题提炼为韩语关键词，通过

search

命令查看候选统计表格。

bash

python3 kosis-stats/scripts/run_kosis_stats.py search --query "1인 가구" --text

从输出中选择

[ORG_ID/TBL_ID]

用于后续步骤。

3. Inspect the table meta before fetching data

3. 获取数据前先查看表格元数据

데이터를 받기 전에 분류/단위/주기를 확인한다.

bash

python3 kosis-stats/scripts/run_kosis_stats.py meta --table-id DT_1JC1501 --text

在获取数据前，先确认分类、单位、统计周期等信息。

bash

python3 kosis-stats/scripts/run_kosis_stats.py meta --table-id DT_1JC1501 --text

4. Fetch a small bounded slice first

4. 先获取小范围数据切片

--prd-se

--start

--end

--obj-l

으로 범위를 좁혀 작은 슬라이스를 먼저 조회한다.

bash

python3 kosis-stats/scripts/run_kosis_stats.py data \
  --table-id DT_1JC1501 --prd-se Y --start 2020 --end 2022 \
  --obj-l 1=ALL --json

표마다 필수 분류 차원 수가 다르다. default
--obj-l 1=ALL
만으로는 부족한 표가 많다. KOSIS가 코드

(필수요청변수값 누락 objL)을 돌려주면,

meta --table-id <ID> --meta-type ITM --json

으로 ITM 안에 들어 있는

OBJ_ID

(분류 차원)와 코드를 확인한 뒤

--obj-l 1=<코드> --obj-l 2=<코드>

형태로 필요한 차원을 모두 지정한다. (많은 표가 OBJ 메타는 비어 있고 분류가 ITM 안에 들어 있음.)

40,000셀을 초과하면 KOSIS는 에러 코드

또는

을 반환한다. 기간을 좁히거나(예: 5년→1년) 분류 필터의 ALL 을 특정 코드로 바꿔(예:

--obj-l 1=11

서울만) 호출을 분할한다. 그래도 부족하면 사용자별 통계자료(

userStatsId

)를 등록해

bigdata

서브커맨드를 사용한다.

행정구역 코드 관례:

C1

코드는 보통 시도가 2자리(

서울,

부산 등), 시군구가 5자리다.

data --json

응답의

C1

필드를 확인해 원하는 단위만 후속 처리에서 필터한다.

通过

--prd-se

--start

--end

--obj-l

缩小范围，先查询小数据切片。

bash

python3 kosis-stats/scripts/run_kosis_stats.py data \
  --table-id DT_1JC1501 --prd-se Y --start 2020 --end 2022 \
  --obj-l 1=ALL --json

不同表格所需的必填分类维度数量不同。仅使用默认的
--obj-l 1=ALL
可能无法满足多数表格需求。若KOSIS返回错误码

（必填请求参数objL缺失），需通过

meta --table-id <ID> --meta-type ITM --json

查看ITM中的

OBJ_ID

（分类维度）及对应代码，然后以

--obj-l 1=<代码> --obj-l 2=<代码>

的形式设置所有必要维度。（多数表格的OBJ元数据为空，分类信息包含在ITM中）

当数据量超过40,000单元格时，KOSIS会返回错误码

或

。此时需缩小时间范围（如从5年改为1年）或将分类筛选的ALL替换为特定代码（如

--obj-l 1=11

仅查询首尔）拆分请求。若仍无法解决，需注册用户专属统计资料(

userStatsId

)并使用

bigdata

子命令。

行政区划代码惯例：

C1

代码中，道市通常为2位（

=首尔，

=釜山等），市郡区为5位。可通过

data --json

响应中的

C1

字段筛选所需行政区划单位。

5. (Optional) Use bigdata for large datasets

5.（可选）使用bigdata获取大容量数据集

bigdata

는 KOSIS 웹에서 미리 등록한

userStatsId

가 필요하다. 미등록 상태면 사용자에게 등록 안내만 하고 멈춘다.

bash

python3 kosis-stats/scripts/run_kosis_stats.py bigdata \
  --user-stats-id "openapisample/101/DT_1IN1502/2/1/20191106094026_1" \
  --format json --new-est-prd-cnt 5

使用

bigdata

需预先在KOSIS网页注册

userStatsId

。若未注册，仅向用户提供注册指引后终止操作。

bash

python3 kosis-stats/scripts/run_kosis_stats.py bigdata \
  --user-stats-id "openapisample/101/DT_1IN1502/2/1/20191106094026_1" \
  --format json --new-est-prd-cnt 5

6. Cite the source

6. 标注数据源

응답을 요약할 때는

org_id

tbl_id

, 기간, 단위(

UNIT_NM

), 그리고 endpoint URL을 함께 적는다.

在整理响应结果时，需同时标注

org_id

、

tbl_id

、时间范围、单位(

UNIT_NM

)及endpoint URL。

Done when

完成标准

사용자 질문에 대응하는 통계표 ID(
```
org_id
```
/
```
tbl_id
```
)가 명확하다.
메타데이터를 1회 이상 조회해 분류·단위·주기를 확인했다.
작은 슬라이스부터 단계적으로 데이터를 받았다.
결과에 출처(table id, 기간, 단위, endpoint)를 명시했다.
한도 초과 시 분할 또는
```
bigdata
```
안내로 처리했다.

已明确对应用户问题的统计表格ID(
```
org_id
```
/
```
tbl_id
```
)
已至少查询一次元数据，确认分类、单位、统计周期
已逐步从数据切片开始获取数据
结果中已明确标注数据源（表格ID、时间范围、单位、endpoint）
已处理数据量超限情况（拆分请求或引导使用
```
bigdata
```
）

Failure modes

故障模式

```
KSKILL_KOSIS_API_KEY
```
누락:
```
bigdata
```
또는
```
--direct
```
호출에서만 발급 안내 메시지와 함께 종료(exit 1)
KOSIS 에러 코드
```
10
```
/
```
11
```
: 인증키 누락/만료 → 키 점검.
```
bigdata
```
에서
```
11
```
이 나오면
```
userStatsId
```
가 본인 KOSIS 계정에 등록된 것이 아닐 가능성이 크다.
코드
```
20
```
: 필수 분류 누락 →
```
meta --meta-type OBJ
```
(또는 비어 있으면
```
ITM
```
) 으로 필요한 차원 수와 코드를 확인하고
```
--obj-l 1=... --obj-l 2=...
```
모두 지정 후 재시도
코드
```
21
```
: 잘못된 요청 변수 →
```
org_id
```
/
```
tbl_id
```
/기간 형식 재확인. tblId 의심 시
```
search
```
로 정확한 ID 다시 찾기
코드
```
30
```
: 결과 없음 → 키워드를 더 짧게 또는 다른 표현으로 바꾸거나 기간/분류 완화. meta 호출에서 30 이 나오면 표가 해당 메타 타입을 지원하지 않는 경우이므로 다른
```
--meta-type
```
시도
코드
```
31
```
/
```
41
```
: 한도 초과 → 기간 좁히기, 분류 ALL 을 특정 코드로 바꾸기, 또는
```
bigdata
```
사용
코드
```
40
```
: 분당 1,000건 호출 한도 → 잠시 대기
코드
```
50
```
: KOSIS 서버 오류 → 1~2초 후 재시도
비표준 JSON: KOSIS는 따옴표 없는 키를 가끔 반환한다. helper는 자동 보정한다.
응답에
```
UNIT_NM
```
누락: 일부 표는 KOSIS 응답에 단위가 비어 있다. helper text 출력의
```
[summary]
```
라인에
```
unit=(KOSIS 응답에 UNIT_NM 미포함)
```
으로 명시되며, 단위는
```
meta
```
응답이나 KOSIS 웹 화면에서 별도 확인한다.
HTTPS 전용 (2026-03-05 이후): URL은 항상
```
https://
```
. HTTP 요청은 차단된다.

```
KSKILL_KOSIS_API_KEY
```
缺失：仅在
```
bigdata
```
或
```
--direct
```
调用时，提示密钥申请指引并终止（exit 1）
KOSIS错误码
```
10
```
/
```
11
```
：认证密钥缺失/过期 → 检查密钥。若
```
bigdata
```
返回
```
11
```
，大概率是
```
userStatsId
```
未注册到当前用户的KOSIS账户
错误码
```
20
```
：必填分类缺失 → 通过
```
meta --meta-type OBJ
```
（若为空则用
```
ITM
```
）确认所需维度数量及代码，设置所有
```
--obj-l 1=... --obj-l 2=...
```
参数后重试
错误码
```
21
```
：请求参数错误 → 重新确认
```
org_id
```
/
```
tbl_id
```
/时间格式。若怀疑表格ID错误，通过
```
search
```
重新查找准确ID
错误码
```
30
```
：无结果 → 简化关键词或更换表述，放宽时间/分类筛选条件。若meta调用返回30，说明该表格不支持当前元数据类型，需尝试其他
```
--meta-type
```
错误码
```
31
```
/
```
41
```
：数据量超限 → 缩小时间范围、将分类ALL替换为特定代码，或使用
```
bigdata
```
错误码
```
40
```
：每分钟调用次数超过1000次限制 → 等待片刻后重试
错误码
```
50
```
：KOSIS服务器错误 → 1~2秒后重试
非标准JSON：KOSIS偶尔会返回无引号的键，工具会自动修正
响应中缺失
```
UNIT_NM
```
：部分表格的KOSIS响应中无单位信息，工具文本输出的
```
[summary]
```
行会标注
```
unit=(KOSIS响应中未包含UNIT_NM)
```
，需从meta响应或KOSIS网页另行确认单位
仅支持HTTPS（2026-03-05起）：URL必须为
```
https://
```
，HTTP请求会被拦截

회복 시나리오 예시

恢复场景示例

코드 20 회복:

data --table-id DT_1J22001 --prd-se M --start 202401 --end 202401

→ 코드 20 →

meta --table-id DT_1J22001 --meta-type ITM --json

으로 차원 확인 →

data ... --obj-l 1=T10 --obj-l 2=0

재호출 → 성공

코드 31 회복:

data --table-id DT_1B26001 --prd-se Y --start 2020 --end 2024 --obj-l 1=ALL --obj-l 2=ALL --obj-l 3=ALL

→ 코드 31 →

... --start 2024 --end 2024 --obj-l 1=11 --obj-l 2=ALL --obj-l 3=ALL

(서울만) 재호출 → 성공

错误码20恢复：

data --table-id DT_1J22001 --prd-se M --start 202401 --end 202401

→ 返回错误码20 → 通过

meta --table-id DT_1J22001 --meta-type ITM --json

确认维度 → 执行

data ... --obj-l 1=T10 --obj-l 2=0

重试 → 成功

错误码31恢复：

data --table-id DT_1B26001 --prd-se Y --start 2020 --end 2024 --obj-l 1=ALL --obj-l 2=ALL --obj-l 3=ALL

→ 返回错误码31 → 执行

... --start 2024 --end 2024 --obj-l 1=11 --obj-l 2=ALL --obj-l 3=ALL

（仅查询首尔）重试 → 成功

Maintainer review notes

维护者审核说明

메인테이너가 이 스킬을 검토하기 위해 KOSIS 인증키를 새로 발급받을 필요는 없다. 일반 조회는

k-skill-proxy

가 KOSIS 인증키를 서버 쪽에서 주입한다.

bigdata

와

--direct

만 개인 KOSIS 키가 필요하다.

키 없이 가능한 검증:

```
./scripts/validate-skills.sh
```

python3 -m py_compile kosis-stats/scripts/run_kosis_stats.py kosis-stats/tests/test_run_kosis_stats.py

python3 kosis-stats/scripts/run_kosis_stats.py --help

python3 kosis-stats/scripts/run_kosis_stats.py search --query 인구 --dry-run

(URL/파라미터 출력만)

PYTHONPATH=kosis-stats/scripts python3 -m unittest discover -s kosis-stats/tests -p 'test_*.py' -v

```
npm run ci
```

실제 direct live smoke는 기여자 또는 이미 KOSIS 키가 있는 사용자가 선택적으로 수행한다. Proxy live smoke는 배포 proxy에

KOSIS_API_KEY

가 설정된 뒤 수행한다. PR에는 호출 endpoint, 파라미터, 응답 행 수 같은 비민감 요약만 남기고 인증키와 개인 조회 세부 내역은 공유하지 않는다.

维护者无需重新申请KOSIS认证密钥即可审核本Skill。常规查询由

k-skill-proxy

在服务器端注入KOSIS认证密钥，仅

bigdata

和

--direct

操作需要个人KOSIS密钥。

无需密钥即可完成的验证：

```
./scripts/validate-skills.sh
```

python3 -m py_compile kosis-stats/scripts/run_kosis_stats.py kosis-stats/tests/test_run_kosis_stats.py

python3 kosis-stats/scripts/run_kosis_stats.py --help

python3 kosis-stats/scripts/run_kosis_stats.py search --query 인구 --dry-run

（仅输出URL/参数）

PYTHONPATH=kosis-stats/scripts python3 -m unittest discover -s kosis-stats/tests -p 'test_*.py' -v

```
npm run ci
```

实际直接调用测试由贡献者或已有KOSIS密钥的用户选择性执行。代理调用测试需在部署代理设置

KOSIS_API_KEY

后执行。PR中仅保留调用endpoint、参数、响应行数等非敏感摘要，不得共享认证密钥及个人查询详情。

Safety notes

安全注意事项

조회 전용 스킬이다.
사용자별 통계자료(
```
userStatsId
```
) 등록, 데이터 수정, KOSIS 웹 자동화는 하지 않는다.
일반 조회 인증키는 proxy 서버에서만 다룬다. direct/bigdata 인증키는 환경변수 또는
```
~/.config/k-skill/secrets.env
```
로만 다룬다.
응답 JSON에 인증키가 echo 되지 않도록 helper는
```
--dry-run
```
시에도 키를
```
<DRY-RUN>
```
으로 대체한다.

本Skill为查询专用
不执行用户专属统计资料(
```
userStatsId
```
)注册、数据修改、KOSIS网页自动化等操作
常规查询的认证密钥仅在代理服务器处理。direct/bigdata认证密钥仅通过环境变量或
```
~/.config/k-skill/secrets.env
```
处理
为避免认证密钥在响应JSON中泄露，工具在
```
--dry-run
```
模式下会将密钥替换为
```
<DRY-RUN>
```

kosis-stats

Original

Translation

KOSIS Stats

KOSIS Stats

What this skill does

本Skill的功能

When to use

使用场景

When not to use

非适用场景

Prerequisites

前置条件

Required environment variables

必要环境变量

Credential resolution order (bigdata 또는 --direct 전용)

凭证获取优先级（仅适用于bigdata或--direct操作）

Inputs

输入参数

Workflow

工作流程

1. Ensure proxy access is available

1. 确保代理访问可用

2. Search for candidate tables

2. 搜索候选表格

3. Inspect the table meta before fetching data

3. 获取数据前先查看表格元数据

4. Fetch a small bounded slice first

4. 先获取小范围数据切片

5. (Optional) Use bigdata for large datasets

5.（可选）使用bigdata获取大容量数据集

6. Cite the source

6. 标注数据源

Done when

完成标准

Failure modes

故障模式

회복 시나리오 예시

恢复场景示例

Maintainer review notes

维护者审核说明

Safety notes

安全注意事项

Credential resolution order (
`bigdata`
또는
`--direct`
전용)

凭证获取优先级（仅适用于
`bigdata`
或
`--direct`
操作）