Kosis Kr

@pipeworx/kosis-kr

韓国の国家統計（KOSIS） — 人口、物価、雇用、貿易、産業を網羅する、約100,000件の表を収録した韓国統計庁の公式統計データベースを閲覧、検索し、時系列データを取得できます。

Pipeworx の一部です — AI エージェントを1882以上のライブデータソースに接続するMCPゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携、承認、公開のいずれもされていません。

ツール

• kosis_stat_list({ parentListId, vwCd, _apiKey }) — テーブルディレクトリを一度に1階層ずつたどります。
• kosis_search({ searchNm, orgId, startCount, resultCount, _apiKey }) — キーワードでテーブルを検索します。データツールに必要なorgIdとtblIdのペアを返します。
• kosis_stat_data({ orgId, tblId, itmId, objL1, objL2, prdSe, newEstPrdCnt, startPrdDe, endPrdDe, _apiKey }) — 1つのテーブルから観測値を取得します。

認証

プラットフォームキー（PLATFORM_KOSIS_KEY）。?_apiKey=でBYOキーに切り替えられます。 https://kosis.kr/openapi/で無料登録できます。サインアップしてサービスごとにOpenAPIアクセスを申請すると、手動承認なしですぐにキーが発行されます。

データソース

• https://kosis.kr/openapi/statisticsList.do — テーブルディレクトリ。
• https://kosis.kr/openapi/statisticsSearch.do — テーブルのキーワード検索。
• https://kosis.kr/openapi/Param/statisticsParameterData.do — 観測値。

注意点

• KOSISは無効または未設定のキーに対して、本文に{"err":"11","errMsg":"유효하지않은 인증KEY입니다."}を含むHTTP 200を返します。 ステータスコードのチェックだけでは成功と判定されます。このパックは200レスポンスのerrを確認し、エラーを発生させます。
• prdSeはテーブルが実際に公開している周期と一致させる必要があります。 月次テーブルに"Y"を指定すると、エラーなしで観測値が0件返されます。
• 韓国語の検索語は英語の検索語よりはるかに多くのテーブルに一致します。
• 成功時のペイロードは未検証です。フリートキーが存在しないためです。フィールド名は公開されているパラメーターガイドに基づいています。各ツールはrawも返すため、実際のキーを持つ呼び出し元は、ここに記載された名前が古くても未加工のペイロードを取得できます。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "kosis-kr": {
      "url": "https://gateway.pipeworx.io/kosis-kr/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/kosis-kr/mcpのtools/listは、上記の表にあるツールに加え、Pipeworx共通のメタツール（ask_pipeworx、discover_tools、search_within、remember／recallなど、ゲートウェイ全体で利用できる一連のツール）を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールに加えて、共通ツールが約30個表示されます。接続のinitializeレスポンスには正確な範囲が示されており、その日の時点での権威ある情報です。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使えば、このパックが扱わない質問にも、カタログ全体を横断してルーティングするask_pipeworxを介して回答できます。MCPサーバーを追加する必要はありません。現時点ではメタツールを含めずにパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点に見合わない場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フルのPipeworxゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも同じゲートウェイと、同じ1882以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworxを使ってすべてのツールにアクセスできます。

MCPクライアントをお持ちでない場合：HTTP経由で呼び出す

このパックでは独自のAPIキー（_apiKey）を使用します。こちらではキーを用意していないため、キーなしで実行できるcurlの例はありません。ツールの詳細を確認するにはGET https://gateway.pipeworx.io/v1/tools/kosis_stat_listを実行します。検索するにはPOST https://gateway.pipeworx.io/v1/tools/search_packsに{"query":"..."}を指定します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行でき、Pipeworx アカウントやゲートウェイとの往復通信は不要です。

{
  "mcpServers": {
    "kosis-kr": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-kosis-kr"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-kosis-kr

標準入力／標準出力を介して MCP で通信し、initialize／tools/list／tools/call に対して、このパックのツールのみを使って応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックのエンドポイントでも、完全なゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Kosis Kr data" })

ゲートウェイが適切なツールを選択し、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT