Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas Iniciar sesión

Kiwoom Securities (키움증권) REST API

de younghwan91versión 0.5.0i★ 2iSe ejecuta en tu computadoraSitio oficial ↗
Nombre en el registroio.github.younghwan91/kiwoom-client

Cómo instalar

Qué hace

Korean stocks via the Kiwoom REST API: quotes, charts, rankings, account. Live orders opt-in only.

Texto original del autor

  • Conexión Se ejecuta en tu computadora
  • Cuenta o clave Necesita KIWOOM_APP_KEY, KIWOOM_APP_SECRET
  • Categoría Tiendas en línea y pagos

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad6/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso18/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Kiwoom Securities (키움증권) REST API. Sigue https://mcp.popnx.com/i/younghwan91-kiwoom-client.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 21 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Necesitas una clave de Kiwoom Securities (키움증권) REST API (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Kiwoom Securities (키움증권) REST API para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "kiwoom-client": { "command": "uvx", "args": [ "kiwoom-client" ], "env": { "KIWOOM_APP_KEY": "your-value", "KIWOOM_APP_SECRET": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En KIWOOM_APP_KEY, KIWOOM_APP_SECRET deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Kiwoom Securities (키움증권) REST API aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala uv (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    uv --version
    • Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita

    Abrir la página de descarga de uv ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version

    Se instala una vez y sirve para todo lo que usa uv

  2. Regístrate y crea una clave de Kiwoom Securities (키움증권) REST API

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Kiwoom Securities (키움증권) REST API ↗

  3. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  4. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "kiwoom-client": {
          "command": "uvx",
          "args": [
            "kiwoom-client"
          ],
          "env": {
            "KIWOOM_APP_KEY": "your-value",
            "KIWOOM_APP_SECRET": "your-value"
          }
        }
      }
    }

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Cierra Claude y vuelve a abrirlo

  6. Pruébalo

    Usa Kiwoom Securities (키움증권) REST API y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Kiwoom Securities (키움증권) REST API o muestra una herramienta de Kiwoom Securities (키움증권) REST API en la respuesta, ya está conectado

3 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • KIWOOM_IS_MOCK true = paper trading server (모의투자). Default false = live server. · valor por defecto true
  • KIWOOM_MCP_TOOLSETS Módulos separados por comas a exponer, p. ej. market,chart,account. Por defecto: todos.
    Ver original en inglésComma-separated modules to expose, e.g. market,chart,account. Default: all.
  • KIWOOM_MCP_MODE discovery = expone solo search_tools/describe_tool/call_tool para ahorrar contexto.
    Ver original en inglésdiscovery = expose only search_tools/describe_tool/call_tool to save context.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Kiwoom Securities (키움증권) REST API

Kiwoom Securities (키움증권) REST API se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Kiwoom Securities (키움증권) REST API

  • Necesitas una clave de Kiwoom Securities (키움증권) REST API (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Necesitas una clave de Kiwoom Securities (키움증권) REST API (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
  • Necesitas una clave de Kiwoom Securities (키움증권) REST API (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
  • Necesitas una clave de Kiwoom Securities (키움증권) REST API (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)

B · Otros en Tiendas en línea y pagos que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Necesitas una clave de Kiwoom Securities (키움증권) REST API (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Kiwoom Securities (키움증권) REST API para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user kiwoom-client --env KIWOOM_APP_KEY=your-value --env KIWOOM_APP_SECRET=your-value -- uvx kiwoom-client 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En KIWOOM_APP_KEY, KIWOOM_APP_SECRET deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Kiwoom Securities (키움증권) REST API aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala uv (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    uv --version
    • Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita

    Abrir la página de descarga de uv ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version

    Se instala una vez y sirve para todo lo que usa uv

  2. Regístrate y crea una clave de Kiwoom Securities (키움증권) REST API

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Kiwoom Securities (키움증권) REST API ↗

  3. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  4. Pega este comando y pulsa Enter

    claude mcp add --scope user kiwoom-client --env KIWOOM_APP_KEY=your-value --env KIWOOM_APP_SECRET=your-value -- uvx kiwoom-client

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Escribe /mcp en Claude Code

    Deberías ver Kiwoom Securities (키움증권) REST API en la lista como conectado

  6. Pruébalo

    Usa Kiwoom Securities (키움증권) REST API y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Kiwoom Securities (키움증권) REST API o muestra una herramienta de Kiwoom Securities (키움증권) REST API en la respuesta, ya está conectado

3 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • KIWOOM_IS_MOCK true = paper trading server (모의투자). Default false = live server. · valor por defecto true
  • KIWOOM_MCP_TOOLSETS Módulos separados por comas a exponer, p. ej. market,chart,account. Por defecto: todos.
    Ver original en inglésComma-separated modules to expose, e.g. market,chart,account. Default: all.
  • KIWOOM_MCP_MODE discovery = expone solo search_tools/describe_tool/call_tool para ahorrar contexto.
    Ver original en inglésdiscovery = expose only search_tools/describe_tool/call_tool to save context.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Necesitas una clave de Kiwoom Securities (키움증권) REST API (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Kiwoom Securities (키움증권) REST API para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "kiwoom-client": { "command": "uvx", "args": [ "kiwoom-client" ], "env": { "KIWOOM_APP_KEY": "your-value", "KIWOOM_APP_SECRET": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En KIWOOM_APP_KEY, KIWOOM_APP_SECRET deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Kiwoom Securities (키움증권) REST API aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala uv (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    uv --version
    • Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita

    Abrir la página de descarga de uv ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version

    Se instala una vez y sirve para todo lo que usa uv

  2. Regístrate y crea una clave de Kiwoom Securities (키움증권) REST API

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Kiwoom Securities (키움증권) REST API ↗

  3. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  4. Escribe tu clave

    En la configuración de Kiwoom Securities (키움증권) REST API, KIWOOM_APP_KEY, KIWOOM_APP_SECRET está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Abre el chat de IA de Cursor en modo Agent

  6. Pruébalo

    Usa Kiwoom Securities (키움증권) REST API y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Kiwoom Securities (키움증권) REST API o muestra una herramienta de Kiwoom Securities (키움증권) REST API en la respuesta, ya está conectado

3 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • KIWOOM_IS_MOCK true = paper trading server (모의투자). Default false = live server. · valor por defecto true
  • KIWOOM_MCP_TOOLSETS Módulos separados por comas a exponer, p. ej. market,chart,account. Por defecto: todos.
    Ver original en inglésComma-separated modules to expose, e.g. market,chart,account. Default: all.
  • KIWOOM_MCP_MODE discovery = expone solo search_tools/describe_tool/call_tool para ahorrar contexto.
    Ver original en inglésdiscovery = expose only search_tools/describe_tool/call_tool to save context.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Necesitas una clave de Kiwoom Securities (키움증권) REST API (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Kiwoom Securities (키움증권) REST API para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "kiwoom-client": { "type": "stdio", "command": "uvx", "args": [ "kiwoom-client" ], "env": { "KIWOOM_APP_KEY": "your-value", "KIWOOM_APP_SECRET": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En KIWOOM_APP_KEY, KIWOOM_APP_SECRET deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Kiwoom Securities (키움증권) REST API aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala uv (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    uv --version
    • Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita

    Abrir la página de descarga de uv ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version

    Se instala una vez y sirve para todo lo que usa uv

  2. Regístrate y crea una clave de Kiwoom Securities (키움증권) REST API

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Kiwoom Securities (키움증권) REST API ↗

  3. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  4. Escribe tu clave

    En la configuración de Kiwoom Securities (키움증권) REST API, KIWOOM_APP_KEY, KIWOOM_APP_SECRET está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Abre el chat de IA de VS Code en modo Agent

  6. Pruébalo

    Usa Kiwoom Securities (키움증권) REST API y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Kiwoom Securities (키움증권) REST API o muestra una herramienta de Kiwoom Securities (키움증권) REST API en la respuesta, ya está conectado

3 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • KIWOOM_IS_MOCK true = paper trading server (모의투자). Default false = live server. · valor por defecto true
  • KIWOOM_MCP_TOOLSETS Módulos separados por comas a exponer, p. ej. market,chart,account. Por defecto: todos.
    Ver original en inglésComma-separated modules to expose, e.g. market,chart,account. Default: all.
  • KIWOOM_MCP_MODE discovery = expone solo search_tools/describe_tool/call_tool para ahorrar contexto.
    Ver original en inglésdiscovery = expose only search_tools/describe_tool/call_tool to save context.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Kiwoom Securities (키움증권) REST API💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user kiwoom-client --env KIWOOM_APP_KEY=your-value --env KIWOOM_APP_SECRET=your-value -- uvx kiwoom-client

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "kiwoom-client": {
      "command": "uvx",
      "args": [
        "kiwoom-client"
      ],
      "env": {
        "KIWOOM_APP_KEY": "your-value",
        "KIWOOM_APP_SECRET": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "kiwoom-client": {
      "command": "uvx",
      "args": [
        "kiwoom-client"
      ],
      "env": {
        "KIWOOM_APP_KEY": "your-value",
        "KIWOOM_APP_SECRET": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "kiwoom-client": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "kiwoom-client"
      ],
      "env": {
        "KIWOOM_APP_KEY": "your-value",
        "KIWOOM_APP_SECRET": "your-value"
      }
    }
  }
}

Valores que debes completar

  • KIWOOM_APP_KEY secreto obligatorio env
    Kiwoom REST API app key (키움 REST API 앱키)
  • KIWOOM_APP_SECRET secreto obligatorio env
    Kiwoom REST API app secret (시크릿키)
  • KIWOOM_IS_MOCK env
    true = paper trading server (모의투자). Default false = live server.
  • KIWOOM_MCP_TOOLSETS env
    Módulos separados por comas a exponer, p. ej. market,chart,account. Por defecto: todos.
    Ver original en inglésComma-separated modules to expose, e.g. market,chart,account. Default: all.
  • KIWOOM_MCP_MODE env
    discovery = expone solo search_tools/describe_tool/call_tool para ahorrar contexto.
    Ver original en inglésdiscovery = expose only search_tools/describe_tool/call_tool to save context.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
249/sem
Conexión
Se ejecuta en tu computadora
Última versióni
0.5.0
Publicado en el registroi
21 nov 2026
Último cambio de códigoi
21 nov 2026
Creador
younghwan91
Paquetes
pypi: kiwoom-client
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 21 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub younghwan91, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hoy

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para kiwoom-client@0.5.0

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 21 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/younghwan91-kiwoom-client.svg)](https://mcp.popnx.com/en/servers/younghwan91-kiwoom-client)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Tiendas en línea y pagosi

  • Más estrellas que el 94% de los otros 3027 servidores de esta categoría
  • Publicado en el registro más recientemente que el 99% de los otros 3027 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 3027 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Kiwoom Securities (키움증권) REST API?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: KIWOOM_APP_KEY, KIWOOM_APP_SECRET

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hoy, y la última versión (0.5.0) llegó al registro hoy.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Stripe MCP, FlightClaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Stripe MCP

MCP server integrating with Stripe - tools for customers, products, payments, and more.

de stripeMuy usado★ 2,1 milActualizado hace 13 meses

Se ejecuta en la nube✓ del servicio · stripe.com

FlightClaw

Search, price-track and book flights from about 300 airlines, paid on a hosted checkout link.

de flightclawEn crecimiento★ 87Actualizado hoy

Se ejecuta en la nube✓ del servicio · flightclaw.com

Trade It

Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.

de trade-it-incEn crecimiento★ 62Actualizado hace 36 días

Se ejecuta en la nube✓ del servicio · tradeit.app

idealo MCP Server

Search products, compare prices and discover deals across 6 European markets with your AI assistant.

de idealoInicial★ 28Actualizado hace 6 meses

Se ejecuta en la nube✓ del servicio · mcp.idealo.com
Comparado con otros parecidos
Este
Kiwoom Securities (키움증권) REST API
Stripe MCPFlightClawTrade ItMarketplace Ad Pros: Amazon Ads & Seller Centralidealo MCP Server
Dónde se ejecutaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveSíNoNoNoNoNo
Se añade con + en ClaudeNoSíNoNoNoNo
Revisiones básicas3/34/44/45/54/44/4
LicenciaMITMITMITCC0-1.0MITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

한국어 | English

kiwoom-client — 키움증권 REST API 파이썬 클라이언트

키움 REST API, 파이썬과 AI 에이전트로. 182개 엔드포인트, 실시간 WebSocket, 그리고 MCP 서버로 AI 에이전트까지 — OpenAPI+ 의 COM/OCX 없이 Windows · macOS · Linux 어디서나 자동매매·데이터 수집 코드가 돌아갑니다. 키움증권과 무관한 비공식 오픈소스입니다.

  • REST 182개 + 조건검색 4종 + 실시간 19종을 모듈 15개로 감쌌습니다. 아래 그림은 코드에서 센 것이라 타일 하나가 엔드포인트 하나입니다.
  • MCP 서버 내장 — Claude Code · Cursor 가 stock_info_basic_stock_info 같은 도구로 시세·계좌·주문을 직접 부릅니다. 실전 계좌에서는 KIWOOM_MCP_ALLOW_LIVE_ORDERS=true 를 켜기 전까지 주문 도구가 등록조차 되지 않습니다.
  • 봇이 토큰 만료로 죽지 않습니다 — 만료 전 자동 갱신, 401 이면 재발급 후 재시도. TR별 Rate Limiter 가 429 를 막고, 그래도 나오면 백오프 후 다시 보냅니다.

빠른 시작

pip install kiwoom-client
from kiwoom_client import KiwoomAPI

api = KiwoomAPI.from_env(is_mock=True) # KIWOOM_APP_KEY·KIWOOM_APP_SECRET 환경변수 (.env 는 from_env(".env"))

또는 직접: KiwoomAPI(app_key="발급받은_앱키", app_secret="발급받은_시크릿키", is_mock=True)

info = api.stock_info.basic_stock_info(stk_cd=api.stock_code("삼성전자")) # 종목명 → 005930 chart = api.chart.stock_daily_chart(stk_cd="005930", base_dt="20260326", upd_stkpc_tp="1") # 일봉 print(info["stk_nm"])

접근토큰은 첫 호출에서 자동 발급되고 만료 전에 갱신되므로 따로 할 일이 없습니다. 앱키·시크릿키는 키움 REST API 포털에서 발급받고, 처음에는 모의투자(is_mock=True)로 시작하세요.

AI 에이전트에서 (MCP)
pip install 'kiwoom-client[mcp]'

claude mcp add --transport stdio \ --env KIWOOM_APP_KEY=발급받은_앱키 --env KIWOOM_APP_SECRET=발급받은_시크릿키 --env KIWOOM_IS_MOCK=true \ kiwoom-client -- kiwoom-client-mcp

이제 Claude Code 에서 "삼성전자 지금 얼마야?" 라고 물으면 됩니다. Cursor 등 다른 클라이언트 설정과 환경변수는 MCP 서버로 사용하기.

실서버를 호출하지 않고 만든 예시 화면입니다(시세 값은 가상). 실전투자 서버에서는 KIWOOM_MCP_ALLOW_LIVE_ORDERS=true 를 켜기 전까지 주문 도구가 등록되지 않아, 에이전트가 주문할 방법 자체가 없습니다.

더 읽을거리: 왜 kiwoom-client 인가 — OpenAPI+·pykiwoom·다른 REST 래퍼와 비교 · 엔드포인트 전체 목록

무엇을 하나

  • 크로스 플랫폼: REST 기반이라 Windows · macOS · Linux, 헤드리스 서버에서도 돌아갑니다.
  • sync / async 양쪽: KiwoomAPI 와 AsyncKiwoomAPI 가 같은 엔드포인트를 제공합니다.
  • 자동 토큰 관리: 발급·만료 전 갱신·401 재발급을 라이브러리가 맡습니다.
  • 내장 Rate Limiter: TR(api_id)별 토큰 버킷(1 req/s, 버스트 2) + 429 자동 재시도.
  • 자동 페이지네이션: request_all() 이 cont-yn/next-key 를 끝까지 따라갑니다.
  • 바로 쓰는 응답: to_dataframe() 이 "+70000" 같은 문자열을 숫자로 바꿔 DataFrame 으로 넘깁니다.
  • 호가단위 보정: round_to_tick() 으로 지정가를 KRX 호가단위에 맞춥니다.
  • 실시간 WebSocket: 체결·호가·잔고 등 19종 구독, PING 응답·재연결·구독 복원 내장. 조건검색도 같은 소켓.
  • MCP 서버: 모듈 15개의 REST 엔드포인트 전부와 조건검색 4종이 MCP 도구로 노출됩니다.
기존 키움 OpenAPI / pykiwoom 과 무엇이 다른가?

키움 OpenAPI+(OCX/COM) 와 이를 감싼 pykiwoom 은 32bit Windows 에 묶여 있어 서버 배포·자동화가 어렵습니다. 이 라이브러리는 키움의 신규 REST API 를 쓰므로 그 제약이 없습니다.

항목키움 OpenAPI+ (OCX)pykiwoomkiwoom-client
연동 방식COM/OCXOCX 래퍼REST + WebSocket
운영체제Windows 전용Windows 전용Windows · macOS · Linux
Python 비트수32bit 전용32bit 전용64bit 지원
서버/헤드리스 배포어려움 (GUI 필요)어려움가능
실시간 데이터이벤트 콜백이벤트 콜백async WebSocket
설치별도 모듈 설치OCX + 모듈`pip install` 한 줄

키움 공식 저장소·다른 REST 래퍼까지 넣은 비교는 왜 kiwoom-client 인가, OpenAPI+ TR·함수를 REST 로 옮기는 대응표는 옮겨 오기.

설치와 사전 준비

pip install kiwoom-client            # 기본

pip install 'kiwoom-client[pandas]' # to_dataframe() 까지 pip install 'kiwoom-client[mcp]' # MCP 서버까지 uv add kiwoom-client # uv 를 쓴다면

  • Python 3.10 이상. 소스에서 쓰려면 git clone 뒤 pip install -e .
  • 키움 REST API 포털에서 API 사용신청으로 앱키·시크릿키를 발급받습니다. 환경변수는 .env.example 참고.
  • 모의투자용 키와 실전투자용 키는 다릅니다. is_mock 과 짝이 맞지 않으면 인증이 거부됩니다.
구분실전투자모의투자
is_mockFalse (기본값)True
REST URLhttps://api.kiwoom.comhttps://mockapi.kiwoom.com
WebSocket URLwss://api.kiwoom.com:10000wss://mockapi.kiwoom.com:10000

사용법

계좌와 주문
evaluation = api.account.account_evaluation(qry_tp="0", dmst_stex_tp="KRX")  # 계좌 평가 현황

deposit = api.account.deposit_detail(qry_tp="3") # 예수금 상세 position = api.account.filled_position(dmst_stex_tp="KRX") # 체결 잔고 unfilled = api.account.unfilled_orders(all_stk_tp="0", trde_tp="0", stex_tp="0") # 미체결 주문

삼성전자 10주 지정가 매수 — 값은 키움 공식 스펙 기준 (문자열)

result = api.order.buy_order( dmst_stex_tp="KRX", # 거래소 구분: KRX / NXT / SOR stk_cd="005930", # 종목코드 ord_qty="10", # 주문 수량 ord_uv="70000", # 주문 단가 trde_tp="0", # 매매구분: 0 보통(지정가), 3 시장가, 28 스톱지정가 ... ) api.order.sell_order(dmst_stex_tp="KRX", stk_cd="005930", ord_qty="10", ord_uv="75000", trde_tp="0") api.order.modify_order( # 정정 (kt10002) dmst_stex_tp="KRX", orig_ord_no="원주문번호", stk_cd="005930", mdfy_qty="5", mdfy_uv="71000", ) api.order.cancel_order( # 취소 (kt10003) — cncl_qty="0" 이면 잔량 전부 dmst_stex_tp="KRX", orig_ord_no="원주문번호", stk_cd="005930", cncl_qty="5", )

api.logout() # 토큰 폐기 (선택) api.close() # 연결 종료 — with 문을 쓰면 자동

지정가(ord_uv)는 KRX 호가단위의 배수여야 합니다. 아니면 거부되거나 의도와 다른 가격에 체결됩니다.

from kiwoom_client import add_ticks, round_to_tick, tick_size

tick_size(70123) # Decimal('100') (5만~20만원대는 1틱 100원) round_to_tick(70123) # Decimal('70100') (직전 유효 호가로 내림) add_ticks(49950, 2) # Decimal('50100') (구간 경계를 넘는 N틱 이동)

api.order.buy_order( dmst_stex_tp="KRX", stk_cd="005930", ord_qty="10", ord_uv=str(round_to_tick(target_price)), trde_tp="0", )

asyncio

AsyncKiwoomAPI 는 KiwoomAPI 와 같은 엔드포인트를 제공하며, 호출 앞에 await 만 붙이면 됩니다.

import asyncio

from kiwoom_client import AsyncKiwoomAPI

async def main(): async with AsyncKiwoomAPI(app_key="앱키", app_secret="시크릿키", is_mock=True) as api:

서로 다른 TR은 동시에 나간다 — 직렬로 돌리면 3배 걸린다

info, chart, ranking = await asyncio.gather( api.stock_info.basic_stock_info(stk_cd="005930"), api.chart.stock_daily_chart(stk_cd="005930", base_dt="20260326", upd_stkpc_tp="1"), api.ranking.top_volume_today( # ka10030 — 필드는 api.describe("ka10030") mrkt_tp="000", sort_tp="1", mang_stk_incls="0", crd_tp="0", trde_qty_tp="0", pric_tp="0", trde_prica_tp="0", mrkt_open_tp="0", stex_tp="3", ), ) print(info["stk_nm"])

asyncio.run(main())

Rate Limiter 는 TR(api_id)별로 걸립니다. 서로 다른 TR 은 서로를 막지 않고 동시에 나가며, 같은 TR 을 반복 호출할 때만 초당 1건으로 조여집니다. 전체 예제는 examples/async_usage.py.

응답을 숫자·DataFrame으로 받기

키움은 모든 값을 문자열로 돌려줍니다. 가격은 "+70000", 등락률은 "-1.23", 거래량은 "1,234,567" 같은 식이라 그대로는 계산에 쓸 수 없습니다.

from kiwoom_client import to_dataframe, to_number, normalize

result = api.ranking.top_volume_today(...)

df = to_dataframe(result) # 페이로드 키를 자동으로 찾아 DataFrame 으로 (문자열 → 숫자 포함) print(df["cur_prc"].mean()) # 바로 계산 가능

data = normalize(result) # dict 그대로 쓰고 싶다면 price = to_number("+70000") # 70000

종목코드("005930")처럼 앞자리 0 이 의미를 갖는 값과 base_dt 같은 날짜·식별자 필드는 문자열로 남깁니다. to_dataframe() 에는 pandas 가 필요합니다(pip install 'kiwoom-client[pandas]'). 차트 응답은 to_ohlcv(resp) 가 open/high/low/close/volume + 날짜 인덱스 DataFrame 으로 바꿉니다.

샘플 응답을 to_dataframe() 에 넣은 실제 출력입니다. 시세 값 자체는 예시입니다 — stk_cd 는 문자열로 남고 가격·거래량만 숫자가 되는 것을 보세요.

실시간 WebSocket
import asyncio

from kiwoom_client import KiwoomAPI

api = KiwoomAPI(app_key="앱키", app_secret="시크릿키") ws = api.create_websocket()

async def main():

connect()가 LOGIN 핸드셰이크까지 끝냅니다. 실패하면 KiwoomWebSocketError

await ws.connect()

콜백은 REAL 프레임의 항목 하나를 받습니다:

{"type": "0B", "item": "005930", "values": {"10": "+70000", ...}}

ws.on("0B", lambda d: print(f"체결 {d['item']}: {d['values'].get('10')}")) ws.on("0D", lambda d: print(f"호가 {d['item']}: {d['values'].get('41')}"))

async 콜백도 그대로 등록할 수 있습니다

async def save(d): ... ws.on("0B", save)

삼성전자 실시간 체결+호가 구독

await ws.subscribe("0B", "005930") await ws.subscribe(["0B", "0D"], ["005930", "000660", "035420"])

PING 응답과 재연결(재로그인·구독 복원)은 listen()이 알아서 처리합니다

await ws.listen()

asyncio.run(main())

values 의 키는 키움 FID 번호입니다(10=현재가, 13=누적거래량, 41=매도최우선호가).

조건검색도 같은 WebSocket 을 씁니다. api.condition_search 가 요청 페이로드를 만들고, ws.send() 로 보낸 뒤 ws.on_trnm() 으로 응답을 받습니다.

await ws.connect()

ws.on_trnm("CNSRLST", lambda d: print("조건식 목록:", d["data"])) ws.on_trnm("CNSRREQ", lambda d: print("검색 결과:", d.get("data")))

조건식 목록을 먼저 조회해야 seq를 알 수 있습니다

await ws.send(api.condition_search.condition_list())

seq로 검색 (search_type="1"이면 실시간 편입/이탈까지 수신)

await ws.send(api.condition_search.condition_search_realtime(seq="1")) await ws.listen()

검증 상태: 실서버(api.kiwoom.com) 대상으로 LOGIN 핸드셰이크 · PING 프레임 · REG 등록 응답까지 확인했습니다.

다만 REAL 프레임의 항목 필드명(`item`/`values`)은 장 마감 중이라 아직 미확정입니다. 장중 이상 동작을 만나면

이슈로 알려주세요. 직접 확인하려면 python tests/integration_ws_smoke.py --prod.

연속 조회 (페이지네이션)

응답 헤더의 cont-yn 이 "Y" 이면 다음 페이지가 있다는 뜻입니다. request_all() 이 끝까지 따라갑니다.

all_data = api._client.request_all(

"/api/dostk/acnt", "ka10076", data_key="filled_list", # 응답에서 리스트 데이터의 키 이름 )

요청 제한 (Rate Limit)

키움 REST API 는 TR(api_id)별로 독립적인 호출 제한을 둡니다. 실측 결과:

항목측정값
지속(sustained) 안전 속도TR당 약 1 req/s (이 속도에선 거부 0)
순간 버스트(burst) 허용량TR당 약 2건
초과 시 응답HTTP 429 + {"return_code": 5, "return_msg": "허용된 요청 개수를 초과하였습니다"}
제한 단위TR(api_id)별 독립 — 서로 다른 TR은 영향 없음

라이브러리는 기본으로 TR별 토큰 버킷(1 req/s, 버스트 2) 을 걸고, 그래도 429 가 나면 *

Solo se muestra el principio; lee el resto en el repo