How do I install the Kofia skill?

Run npx skillmds@latest add seokhoonj/kofia in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Kofia safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Kofia?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Kofia free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

seokhoonj (@seokhoonj) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Kofia by seokhoonj — Agent Skill

Name: Kofia
Author: seokhoonj

Kofia

Fetch one KOFIA 종합통계 operation from data.go.kr over a date range -- investor deposits and forced selling (market_funds), margin loan balances (credit_balance), funds, CMA, ELS/DLS, trusts, overseas derivatives. Holds no logic of its own -- it calls the pydatagokr package's CLI (`datagokr kofia`) and shows the result to the user. Trigger phrases: 투자자예탁금, 신용잔고, 신용거래융자, 반대매매, CMA 잔고, ELS 발행, KOFIA statistics, investor deposit, margin loan balance.

seokhoonj 7726d95 2.4 KB Updated Sep 17, 2026

File contents

datagokr — KOFIA 종합통계

Fetch one 금융투자협회 (KOFIA) statistics operation over a date range. Daily operations (market_funds, credit_balance, fund_net_asset, cma_status) take YYYYMMDD bounds; monthly ones (trust_scale, dls_dlb, els_elb, overseas_derivatives) take YYYYMM. The output is typed snake_case columns (base_date, investor_deposit, margin_loan_total, ...). Data starts 2021-11-16 and updates once a day.

Prerequisite

pipx install pydatagokr      # or: pip install pydatagokr

Never print the key value (the DATAGOKR_API_KEY env var or credentials.json) to output, logs, or a summary -- if you need to check which form it is (encoding vs decoding), ask the user.

A data.go.kr decoding key must be configured (env DATAGOKR_API_KEY or ~/.config/pydatagokr/credentials.json), and the KOFIA dataset applied for (활용신청) on that account.

Running

datagokr kofia <operation> [--begin YYYYMMDD] [--end YYYYMMDD] [--json]

Procedure

Pick the operation. Unsure? Run datagokr list (offline) and match the concept.

Run.

datagokr kofia market_funds --begin 20240101 --end 20240131

Add --json when the user wants machine-readable data.

Relay the result. Show the CLI's stdout; the text view caps at 20 rows, so use --json for a full series.
Error handling. A one-line datagokr: <message> on stderr:
- a [30]/[20] auth error -> the key is wrong, is the encoding form by mistake, or the dataset is not applied for.
- a [22]/[23] rate limit -> the daily traffic limit; wait and retry.
- unknown operation (exit 2) -> run datagokr list and correct the name.

What this skill does not do

It does not re-implement fetching or parsing (the package does); it always calls the CLI.
Customs trade data is the customs skill's job.

---name: kofiadescription: Fetch one KOFIA 종합통계 operation from data.go.kr over a date range -- investor deposits and forced selling (market_funds), margin loan balances (credit_balance), funds, CMA, ELS/DLS, trusts, overseas derivatives. Holds no logic of its own -- it calls the pydatagokr package's CLI (`datagokr kofia`) and shows the result to the user. Trigger phrases: 투자자예탁금, 신용잔고, 신용거래융자, 반대매매, CMA 잔고, ELS 발행, KOFIA statistics, investor deposit, margin loan balance.---# datagokr — KOFIA 종합통계Fetch one 금융투자협회 (KOFIA) statistics operation over a date range. Dailyoperations (`market_funds`, `credit_balance`, `fund_net_asset`, `cma_status`) takeYYYYMMDD bounds; monthly ones (`trust_scale`, `dls_dlb`, `els_elb`,`overseas_derivatives`) take YYYYMM. The output is typed snake_case columns(`base_date`, `investor_deposit`, `margin_loan_total`, ...). Data starts 2021-11-16 andupdates once a day.## Prerequisite```pipx install pydatagokr # or: pip install pydatagokr```**Never print the key value** (the `DATAGOKR_API_KEY` env var or `credentials.json`) to output, logs, or a summary -- if you need to check which form it is (encoding vs decoding), ask the user.A data.go.kr **decoding** key must be configured (env `DATAGOKR_API_KEY` or`~/.config/pydatagokr/credentials.json`), and the KOFIA dataset applied for(활용신청) on that account.## Running```datagokr kofia <operation> [--begin YYYYMMDD] [--end YYYYMMDD] [--json]```## Procedure1. **Pick the operation.** Unsure? Run `datagokr list` (offline) and match the concept.2. **Run.** ```bash datagokr kofia market_funds --begin 20240101 --end 20240131 ``` Add `--json` when the user wants machine-readable data.3. **Relay the result.** Show the CLI's stdout; the text view caps at 20 rows, so use `--json` for a full series.4. **Error handling.** A one-line `datagokr: <message>` on stderr: - a `[30]`/`[20]` auth error -> the key is wrong, is the *encoding* form by mistake, or the dataset is not applied for. - a `[22]`/`[23]` rate limit -> the daily traffic limit; wait and retry. - `unknown operation` (exit 2) -> run `datagokr list` and correct the name.## What this skill does not do- It does not re-implement fetching or parsing (the package does); it always calls the CLI.- Customs trade data is the **customs** skill's job.

Frequently asked questions