MCP OpenDART

Accede a datos financieros del sistema OpenDART (Data Analysis, Retrieval and Transfer System) de Corea para modelos de lenguaje de IA.

GitHubPrueba este MCPPatrocinado

Documentación

한국어 | English

MCP OpenDART

License PyPI Version PyPI Downloads

Servidor de Model Context Protocol (MCP) para OpenDART (sistema de divulgación electrónica de la Financial Supervisory Service). Esta integración permite interacciones seguras y contextuales de IA con OpenDART, manteniendo la privacidad y seguridad de los datos.

Ejemplos de uso

Puede solicitar a su asistente de IA cosas como:

  • 📊 Informes financieros - "Traiga el último informe trimestral de Samsung Electronics"
  • 🔍 Búsqueda de divulgaciones - "Encuentre los principales cambios de participación accionaria de las empresas del KOSPI el mes pasado"
  • 📈 Análisis de empresas - "Muéstreme los estados financieros de Hyundai Motor de los últimos 3 años"
  • ⚡ Actualizaciones en tiempo real - "Traiga las divulgaciones importantes del sector tecnológico de hoy"

Demostración de funciones

Demo

Ejemplo de uso: Análisis del informe anual 2024 de Samsung Electronics

Pregunta:

Con base en el informe anual 2024 de Samsung Electronics, responda las siguientes preguntas:

  1. ¿Quién es el empleado mejor pagado? Indique los 5 principales por remuneración individual y sus montos
  2. ¿Hubo cambios en la participación del propietario? ¿Cuál es el cambio en el porcentaje de participación del accionista mayoritario y partes relacionadas, y el motivo de la transacción?
  3. ¿Cuánto se paga en dividendos? Proporcione la tendencia de 3 años de dividendos, rendimiento de dividendos y ratio de pago, y la sostenibilidad de los dividendos
  4. ¿Hay riesgos ocultos? Busque en las notas a los estados financieros información sobre litigios, pasivos contingentes y provisiones
  5. ¿Cuál es la perspectiva del negocio de HBM? Resuma la posición oficial de la empresa sobre HBM y semiconductores de IA en la sección de contenido del negocio

Resuma 3 puntos de precaución al invertir en Samsung Electronics.

Respuesta:

Analizaré con base en el informe anual 2024 de Samsung Electronics. Primero, consultaré el número único de Samsung Electronics. El número único de Samsung Electronics es 00126380. Ahora consultaré la información para cada pregunta. Ahora buscaré en las notas a los estados financieros el contenido relacionado con litigios y pasivos contingentes. Ahora, con base en la información recopilada, proporcionaré un análisis integral.

Análisis integral del informe anual 2024 de Samsung Electronics

1) Empleado mejor pagado - Top 5 por remuneración individual

RangoNombreCargoRemuneración total
1Kyung Kye-hyunAsesor8.036 mil millones KRW
2Lee Jung-baeConsultor6.950 mil millones KRW
3Choi Si-youngConsultor6.900 mil millones KRW
4Han Jong-heeCEO5.240 mil millones KRW
5Roh Tae-moonDirector5.098 mil millones KRW

Análisis: Es notable que los ejecutivos retirados (asesores/consultores) reciben una remuneración más alta que los ejecutivos actuales. Kyung Kye-hyun, exjefe de la división DS, recibió más de 8 mil millones de KRW incluso después de su retiro, lo que parece incluir indemnizaciones y bonificaciones por desempeño previas.

2) Cambio en la participación del propietario - Accionista mayoritario y partes relacionadas

AccionistaRelaciónParticipación inicialParticipación finalCambioMotivo
Samsung Life InsuranceAccionista mayoritario8.51%8.51%-Sin cambios
Samsung C&TEmpresa afiliada5.01%5.01%-Sin cambios
Hong Ra-heeParte relacionada1.96%1.64%▼0.32%Venta fuera de horario
Lee Jae-yongParte relacionada1.63%1.63%-Sin cambios
Lee Boo-jinEjecutiva de empresa afiliada0.93%0.80%▼0.13%Venta fuera de horario
Lee Seo-hyunEjecutiva de empresa afiliada0.93%0.79%▼0.14%Venta fuera de horario
Total-20.70%20.07%▼0.63%-

Análisis:

  • Hong Ra-hee, Lee Boo-jin y Lee Seo-hyun vendieron aproximadamente 37 millones de acciones (alrededor de 2 billones de KRW) mediante ventas fuera de horario
  • La participación del presidente Lee Jae-yong (1.63%) no cambió
  • La participación total de partes relacionadas disminuyó de 20.70% a 20.07%
  • Motivo de la venta: se estima que fue para obtener fondos para el pago del impuesto a la herencia y ajustar la cartera de activos

3) Estado de dividendos - Tendencia de 3 años

Clasificación202420232022
Utilidad neta consolidada33.6 billones KRW14.5 billones KRW54.7 billones KRW
Total de dividendos en efectivo9.81 billones KRW9.81 billones KRW9.81 billones KRW
Dividendo por acción (ordinaria)1,446 KRW1,444 KRW1,444 KRW
Rendimiento de dividendos (ordinaria)2.7%1.9%2.5%
Ratio de pago29.2%67.8%17.9%

Evaluación de sostenibilidad de dividendos:

  • Positivo: Mantenimiento estable de aproximadamente 9.8 billones de KRW en dividendos durante 3 años consecutivos (consistencia en la política de retorno al accionista)
  • Precaución: El ratio de pago de 67.8% en 2023 fue un fenómeno temporal debido a la fuerte caída de la utilidad neta
  • Perspectiva: Con la recuperación de la utilidad neta en 2024 (33.6 billones de KRW), el ratio de pago se normalizó al 29.2%. El nivel actual de dividendos es sostenible

4) Riesgos ocultos - Análisis de notas a los estados financieros

📌 Principales litigios/pasivos contingentes

① Litigio administrativo relacionado con la contabilidad de Samsung BioLogics (en curso)

  • La Comisión de Valores y Futuros impuso una multa de 8 mil millones de KRW y ordenó la reemisión de los estados financieros por errores contables en la participación de Samsung Bioepis
  • Samsung BioLogics está llevando a cabo un litigio para anular la sanción
  • El Tribunal Administrativo de Seúl dictó sentencias de anulación en 2020 (1ª) y 2024 (2ª) → la Comisión apeló
  • Riesgo: Si se pierde el litigio, podría afectar las ganancias por método de participación, inversiones en empresas asociadas y utilidades retenidas de Samsung Electronics de 2015 a 2022

② Pasivos contingentes por litigios legales

  • "Hay litigios, disputas e investigaciones regulatorias en curso con múltiples empresas en el curso normal de las operaciones"
  • La gerencia considera que no tendrán un impacto significativo en la situación financiera
  • Sin embargo, el monto y el momento de la salida de recursos son inciertos

③ Provisiones

  • Provisión por garantía de ventas: Estimación de costos por garantía de calidad del producto, intercambios y reparaciones
  • Provisión por emisiones: Provisión para costos esperados por exceso de derechos de emisión de gases de efecto invernadero

5) Perspectiva del negocio de HBM y semiconductores de IA - Posición oficial de la empresa

📌 Situación de resultados del 4º trimestre de 2024

"Aunque el ajuste de inventario de los clientes de móviles/PC se intensificó, la inversión de los principales centros de datos y empresas tecnológicas orientada a IA continuó, y la demanda de HBM y DRAM para servidores se mantuvo sólida."

📌 Perspectiva y riesgos para 2025

"Se espera que el impulso de la demanda orientada a IA continúe, pero la demanda de centros de datos y clientes OEM podría variar según la situación del suministro de GPU, y la volatilidad de la demanda de HBM debido a los controles de exportación de semiconductores de IA también continúa."

📌 Estrategia de respuesta de la empresa

  • Transición de cartera hacia productos de alto valor agregado (HBM, DDR5, LPDDR5x, QLC SSD)
  • Aceleración de la transición a procesos de vanguardia
  • Enfoque en responder a la demanda de DDR5 para servidores y QLC SSD de alta capacidad para servidores

📌 Negocio de Foundry

"Se espera que el mercado de Foundry en 2025 continúe con una fuerte demanda de aplicaciones HPC/AI, con crecimiento de dos dígitos centrado en el mercado de nodos avanzados"

  • Expansión de la demanda de móviles/HPC basada en rendimiento estable del proceso de 4 nm
  • Preparación para el envío de producción en masa para móviles del proceso de 3 nm con GAA en el primer semestre de 2025

🚨 3 puntos de precaución al invertir en Samsung Electronics

1️⃣ Brecha de competitividad en HBM y riesgo geopolítico

  • Posición de seguidor en tecnología HBM y aseguramiento de clientes frente a SK Hynix
  • Posible caída abrupta de la demanda de HBM hacia China si se refuerzan los controles de exportación de semiconductores de IA de EE. UU.
  • Incertidumbre en la expansión de la participación de Samsung Electronics debido a la diversificación de proveedores de clientes clave como NVIDIA

2️⃣ Venta de acciones de la familia propietaria e inestabilidad de la estructura de gobierno

  • Venta continua de acciones por aproximadamente 2 billones de KRW anuales por parte de Hong Ra-hee, Lee Boo-jin y Lee Seo-hyun
  • La participación personal del presidente Lee Jae-yong (1.63%) es baja, lo que genera preocupación sobre la estabilidad del control
  • Alta dependencia de empresas afiliadas como Samsung Life (8.51%) y Samsung C&T (5.01%)
  • Existe la posibilidad de más ventas de acciones para el pago adicional del impuesto a la herencia

3️⃣ Impacto potencial del litigio contable de Samsung BioLogics

  • Litigio administrativo en curso, resultado impredecible
  • Si se pierde, podría haber una modificación retroactiva de los estados financieros de 2015-2022 → posible reducción de utilidades retenidas
  • Riesgo de distorsión de los estados financieros consolidados debido a cambios en las inversiones en empresas asociadas y ganancias por método de participación
  • La empresa indica que es difícil reflejar esto en los estados financieros en este momento

Conclusión: Samsung Electronics se beneficia del impulso de la demanda de IA/HBM, pero debe monitorear de cerca la brecha tecnológica frente a competidores, la incertidumbre geopolítica y los riesgos relacionados con la estructura de gobierno. Los dividendos son estables, pero dado que la utilidad neta es volátil, es recomendable prestar atención al mantenimiento del monto absoluto de dividendos más que al ratio de pago.

Funciones compatibles

📊 6 categorías principales de análisis

CategoríaPropósito del análisisÁreas principales de análisis
🔍 Análisis de información de divulgacionesDetectar patrones de divulgación y señales de cambios en la gestión• Predicción de cambios en el estado de la gestión mediante análisis de frecuencia y tipo de divulgaciones
• Monitoreo en tiempo real de divulgaciones clave como informes de eventos importantes y cambios en la estructura de gobierno
• Descubrimiento de riesgos ocultos mediante extracción automática de notas a los estados financieros
• Identificación de intenciones estratégicas mediante análisis estructurado del contenido del negocio/descripción de la empresa
📈 Análisis de información clave de informes periódicosExtraer información clave de gestión de informes anuales, trimestrales y semestrales• Evaluación de riesgos de la estructura de gobierno mediante análisis de remuneración de ejecutivos y sistemas de compensación
• Análisis de sostenibilidad de políticas de dividendos y estrategias de retorno al accionista
• Identificación de intenciones de financiamiento mediante patrones de cambios de capital (aumento/reducción/acciones propias)
• Evaluación de estabilidad organizacional mediante estado del personal y estructura de costos laborales
💰 Análisis de información financiera de informes periódicosEvaluación de solidez financiera basada en estados financieros y datos XBRL• Análisis integral de indicadores de rentabilidad (ROA/ROE), estabilidad (ratio de deuda), crecimiento y actividad
• Detección de volatilidad y anomalías en el desempeño financiero mediante análisis de tendencias de series temporales
• Evaluación de la posición relativa frente al promedio de la industria y competitividad
• Análisis de la estructura de solidez financiera del grupo completo basado en estados financieros consolidados
👥 Análisis de información integral de divulgaciones de participaciónEvaluación de estabilidad de la estructura de gobierno y riesgos de cambios en el control• Monitoreo de estabilidad del control mediante cambios en la participación del accionista mayoritario y partes relacionadas
• Detección temprana de posibles adquisiciones hostiles mediante cambios en la participación de accionistas con 5% o más
• Análisis de sospechas de uso de información privilegiada mediante transacciones de acciones de ejecutivos y accionistas principales
• Evaluación de defensa contra M&A y riesgos de la estructura de gobierno mediante el grado de dispersión de accionistas minoritarios
⚡ Análisis de informes de eventos importantesDetectar señales de cambios en la estrategia de gestión y reestructuración• Análisis de estrategias de reestructuración empresarial mediante decisiones de adquisición/cesión de negocios, fusiones/escisiones
• Identificación de cambios en la estrategia de gestión mediante contratos de transferencia de activos y opciones de venta
• Alerta temprana de crisis de gestión como quiebras, suspensiones de operaciones y procedimientos de rehabilitación
• Evaluación de riesgos legales e impacto financiero mediante hechos de presentación de demandas
💼 Análisis de declaraciones de valoresAnálisis profundo de la estructura de financiamiento y riesgos de deuda• Análisis de condiciones de emisión de valores de deuda (bonos corporativos/bonos convertibles/bonos con warrants)
• Evaluación de liquidez y riesgos de refinanciamiento mediante la estructura de deuda a corto/largo plazo
• Verificación de la transparencia en la gestión de fondos mediante el uso de fondos públicos/privados
• Análisis de estrategias globales de financiamiento y riesgos de divisas mediante decisiones de cotización en el extranjero

🎯 Funciones avanzadas de análisis

  • Extracción automática de notas a los estados financieros: Analiza automáticamente las notas a los estados financieros consolidados y las notas a los estados financieros, almacenándolas como datos estructurados
  • Análisis del contenido del negocio: Analiza dinámicamente la sección II. Contenido del negocio, estructurándola por subsecciones como descripción general del negocio, estado de operaciones y solidez financiera
  • Análisis de la descripción de la empresa: Analiza dinámicamente la sección I. Descripción de la empresa, extrayendo información clave como historia de la empresa, cambios de capital y número total de acciones
  • Búsqueda de datos estructurados: Búsqueda semántica por tablas y párrafos para recuperar inmediatamente información detallada relacionada con palabras clave específicas (por ejemplo, litigios, pasivos contingentes, HBM)
  • Selección inteligente de archivos XML: Selecciona automáticamente el mejor informe de negocio de archivos ZIP, excluyendo informes de auditoría, para maximizar la eficiencia del análisis

🧠 Sistema de grafo de conocimiento basado en ontología

  • Generación automática de grafos de conocimiento: Genera automáticamente grafos de conocimiento estructurados al almacenar en caché documentos de divulgación

    • Entidades: Corporación, Divulgación, Sección, Subsección, Tabla, Párrafo
    • Relaciones: Extracción automática de relaciones estructurales como corporación-divulgación, divulgación-sección, sección-subsección
    • Metadatos: Incluye número de nodos, número de aristas, momento de generación, etc.

  • Motor de consultas en lenguaje natural: Búsqueda basada en relaciones utilizando grafos de conocimiento

    • Soporte de consultas en lenguaje natural: "subsecciones del contenido del negocio", "sección de notas a los estados financieros", etc.
    • Exploración de relaciones estructurales: Exploración automática de relaciones entre secciones y jerarquías de subsecciones
    • Descubrimiento automático de entidades relacionadas: Devuelve todos los nodos y aristas relacionados con la consulta

  • Expansión de sinónimos por dominio: Expansión dinámica de términos para mejorar la precisión de búsqueda

    • Separación por dominio: seguros (synonyms_insurance.json), finanzas (synonyms_finance.json), etc.
    • Expansión automática: Inclusión automática de sinónimos relacionados en la búsqueda (por ejemplo, "CSM" → "margen de servicio de contrato", "activos de pólizas de seguro")
    • Puntuación de coincidencia: Proporciona puntuaciones de confianza para términos expandidos

  • Aprendizaje de sinónimos con automejora: Descubrimiento automático de sinónimos mediante el análisis de resultados de búsqueda y grafos de conocimiento

    • Aprendizaje automático: Análisis de patrones de co-ocurrencia en resultados de búsqueda
    • Análisis de relaciones del grafo de conocimiento: Cálculo de confianza basado en nodos compartidos y longitudes de ruta dentro del grafo
    • Aprobación automática basada en confianza: Confianza alta (≥0.8) se aprueba automáticamente; confianza baja se agrega a la cola de revisión manual
    • Sistema de revisión manual: Gestión de colas y estadísticas

Guía de inicio rápido

1. Configuración de autenticación

Primero, obtenga una clave API de OpenDART:

  1. Acceda a OpenDART
  2. Regístrese y solicite una clave API

2. Instalación

# 저장소 복제
git clone https://github.com/ChangooLee/mcp-opendart.git
cd mcp-opendart

# [중요] Python 3.10 이상 사용 필수. 아래 'Python 3.10+ 설치 안내' 참고

# 가상 환경 생성
python3.10 -m venv .venv
source .venv/bin/activate

# 패키지 설치
# python 3.10 이상이 필요 
python3 -m pip install --upgrade pip
uv pip install -e .

Ejecutar con Docker

Cargar la imagen de Docker (usar imagen precompilada)

Puede usar la imagen precompilada incluida en el repositorio:

# Git LFS가 설치되어 있다면 자동으로 다운로드됩니다
# Git LFS 설치: https://git-lfs.github.com/
git lfs pull

# 이미지 로드
docker load -i mcp-opendart-image.tar.gz

Construir la imagen de Docker

Para construirla usted mismo:

# Docker 이미지 빌드
docker build -t mcp-opendart:latest .

Ejecutar el contenedor de Docker

Método 1: Pasar variables de entorno directamente (opción -e)

# 기본 실행 (포트 8000)
docker run -d \
  --name mcp-opendart \
  -p 8000:8000 \
  -e OPENDART_API_KEY=your-api-key-here \
  -e TRANSPORT=http \
  -e HOST=0.0.0.0 \
  -e PORT=8000 \
  -e LOG_LEVEL=INFO \
  mcp-opendart:latest

# 다른 포트로 실행 (예: 9000)
docker run -d \
  --name mcp-opendart \
  -p 9000:9000 \
  -e OPENDART_API_KEY=your-api-key-here \
  -e TRANSPORT=http \
  -e HOST=0.0.0.0 \
  -e PORT=9000 \
  -e LOG_LEVEL=INFO \
  mcp-opendart:latest

Método 2: Usar archivo .env (recomendado)

Cree el archivo .env y configure las variables de entorno:

# .env 파일 예시
# OPENDART_API_KEY=your-api-key-here
# TRANSPORT=http
# HOST=0.0.0.0
# PORT=8000
# LOG_LEVEL=INFO
# MCP_SERVER_NAME=opendart-mcp

# .env 파일을 사용하여 실행
docker run -d \
  --name mcp-opendart \
  -p 8000:8000 \
  --env-file .env \
  mcp-opendart:latest

Nota: El uso del archivo .env permite gestionar información sensible como claves API sin exponerla en el código.

Uso de Docker Compose (opcional)

Puede crear el archivo docker-compose.yml:

version: '3.8'

services:
  mcp-opendart:
    build: .
    container_name: mcp-opendart
    ports:
      - "8000:8000"
    environment:
      - OPENDART_API_KEY=${OPENDART_API_KEY}
      - TRANSPORT=http
      - HOST=0.0.0.0
      - PORT=8000
      - LOG_LEVEL=INFO
    restart: unless-stopped

Ejecución:

docker-compose up -d

Verificación de conexión

Cuando el servidor esté ejecutándose correctamente, puede acceder a los siguientes endpoints:

  • Endpoint MCP: http://localhost:8000/mcp
  • Healthcheck: Usa el healthcheck integrado de Docker

Verificación de registros

# 컨테이너 로그 확인
docker logs mcp-opendart

# 실시간 로그 확인
docker logs -f mcp-opendart

Detener y eliminar el contenedor

# 컨테이너 중지
docker stop mcp-opendart

# 컨테이너 제거
docker rm mcp-opendart

# 이미지 제거
docker rmi mcp-opendart:latest

Guía de instalación de Python 3.10+

Verificar la versión de Python (se requiere 3.10 o superior)

python3 --version

Si la versión de Python es inferior a 3.10, instale Python 3.10 o superior según las instrucciones a continuación:

macOS

  • Descargue el instalador de Python más reciente desde el sitio web oficial: https://www.python.org/downloads/macos/
  • O si usa Homebrew: 
    brew install python@3.10
    Después de la instalación, es posible que deba usar el comando python3.10.

Windows

  • Descargue y ejecute el instalador de Python más reciente desde el sitio web oficial: https://www.python.org/downloads/windows/
  • Asegúrese de marcar la opción "Add Python to PATH" durante la instalación.
  • Después de la instalación, reinicie la terminal y use el comando python o python3.

Linux (Ubuntu/Debian)

  • Actualice la lista de paquetes e instale Python 3.10: 
    sudo apt update
sudo apt install python3.10 python3.10-venv python3.10-distutils
  • Es posible que deba usar el comando python3.10.

Linux (Fedora/CentOS/RHEL)

  • Instale Python 3.10: 
    sudo dnf install python3.10

Integración con IDE

MCP OpenDART está diseñado para usarse con asistentes de IA mediante integración con IDE.

Cómo configurar Claude Desktop

  1. Haga clic en el menú de hamburguesa (☰) > Settings > Developer > botón "Edit Config"
  2. Agregue la siguiente configuración:
{
  "mcpServers": {
    "mcp-opendart": {
      "command": "YOUR_LOCATION/.venv/bin/mcp-opendart",
      "env": {
        "OPENDART_API_KEY": "API-KEY",
        "OPENDART_BASE_URL": "https://opendart.fss.or.kr/api/",
        "HOST": "0.0.0.0",
        "PORT": "8000",
        "TRANSPORT": "stdio",
        "LOG_LEVEL": "INFO",
        "MCP_SERVER_NAME": "mcp-opendart"
      }
    }
  }
}

Configuración de Streamable HTTP (opcional)

También puede ejecutarlo con streamable-http usando transporte HTTP:

{
  "mcpServers": {
    "mcp-opendart": {
      "command": "YOUR_LOCATION/.venv/bin/mcp-opendart",
      "env": {
        "OPENDART_API_KEY": "API-KEY",
        "OPENDART_BASE_URL": "https://opendart.fss.or.kr/api/",
        "HOST": "0.0.0.0",
        "PORT": "9000",
        "TRANSPORT": "http",
        "LOG_LEVEL": "INFO",
        "MCP_SERVER_NAME": "mcp-opendart"
      }
    }
  }
}

[!NOTE]

  • Al configurar TRANSPORT="http", el servidor se ejecuta en modo streamable-http
  • Endpoint: http://HOST:PORT/mcp

[!NOTE]

  • YOUR_LOCATION: Cambie a la ruta real donde está instalado el entorno virtual
  • API-KEY: Cambie a la clave API de OpenDART que recibió

Variables de entorno principales

  • OPENDART_API_KEY: Clave API de OpenDART
  • OPENDART_BASE_URL: URL base de la API (valor predeterminado: URL oficial)
  • HOST: Host del servidor (valor predeterminado: 0.0.0.0)
  • PORT: Puerto del servidor (valor predeterminado: 8000)
  • TRANSPORT: Método de transporte (se recomienda stdio; si se configura como http, admite streamable-http)
  • LOG_LEVEL: Nivel de registro (INFO, DEBUG, etc.)
  • MCP_SERVER_NAME: Nombre del servidor

Sistema de extracción y búsqueda automática de notas a los estados financieros

Arquitectura del sistema

graph TD
    A[공시서류 다운로드] --> B[XML 파싱]
    B --> C{재무제표 주석 존재?}
    C -->|Yes| D[재무제표 주석 추출]
    C -->|No| E[다른 보고서 검색 안내]
    E --> F[LLM이 다른 보고서 선택]
    F --> A
    D --> G[섹션별 분류]
    G --> H[연결재무제표 주석]
    G --> I[재무제표 주석]
    H --> J[테이블 추출]
    H --> K[문단 추출]
    I --> L[테이블 추출]
    I --> M[문단 추출]
    J --> N[구조화된 JSON 저장]
    K --> N
    L --> N
    M --> N
    N --> O[disclosure_cache 저장]
    O --> P[검색 가능한 상태]
    P --> Q[키워드 검색]
    Q --> R[테이블 검색 결과]
    Q --> S[문단 검색 결과]

Estructura de caché

disclosure_cache/
├── financial_notes_{rcp_no}/
│   ├── metadata.json
│   ├── disclosure_{rcp_no}.json
│   ├── consolidated_notes/          # 3. 연결재무제표 주석
│   │   ├── metadata.json
│   │   ├── tables/
│   │   └── paragraphs/
│   ├── separate_notes/              # 5. 재무제표 주석
│   │   ├── metadata.json
│   │   ├── tables/
│   │   └── paragraphs/
│   ├── business_content/            # II. 사업의 내용
│   │   ├── metadata.json
│   │   └── subsections/
│   │       ├── 1_사업의_개요/
│   │       ├── 2_영업의_현황/
│   │       ├── 3_파생상품거래_현황/
│   │       ├── 4_영업설비/
│   │       └── 5_재무건전성_등_기타_참고사항/
│   └── company_overview/            # I. 회사의 개요
│       ├── metadata.json
│       └── subsections/
│           ├── 1_회사의_개요/
│           ├── 2_회사의_연혁/
│           ├── 3_자본금_변동사항/
│           ├── 4_주식의_총수_등/
│           └── 5_정관에_관한_사항/

Funciones de búsqueda

  • Búsqueda en tablas: Búsqueda de palabras clave en encabezados y celdas de datos
  • Búsqueda en párrafos: Búsqueda de palabras clave en párrafos de notas a los estados financieros
  • Búsqueda por sección: Búsqueda en notas a los estados financieros consolidados, notas a los estados financieros, contenido del negocio y descripción de la empresa
  • Clasificación de contexto: Clasificación automática en información básica, información de negocio e información financiera
  • Expansión automática: Inclusión automática de todas las subsecciones al buscar en contenido del negocio y descripción de la empresa
  • Distinción de mayúsculas/minúsculas: Búsqueda opcional con distinción de mayúsculas y minúsculas
  • Expansión automática de sinónimos: Expansión automática de términos de búsqueda basada en diccionarios de sinónimos por dominio (por ejemplo, "CSM" → "margen de servicio de contrato", "activos de pólizas de seguro")
  • Consulta de grafo de conocimiento: Exploración de relaciones estructurales en lenguaje natural (por ejemplo, "subsecciones del contenido del negocio", "sección de notas a los estados financieros")

Herramientas

Herramientas de OpenDART

  • ds001_disclosure: Búsqueda y consulta de información de divulgaciones
  • ds002_periodic: Consulta de información clave de informes periódicos
  • ds003_financial: Consulta de información financiera de informes periódicos
  • ds004_ownership: Consulta de información integral de divulgaciones de participación
  • ds005_major: Consulta de información clave de informes de eventos importantes
  • ds006_securities: Consulta de información clave de declaraciones de valores
Lista de herramientas principales
CategoríaHerramientas
Información de divulgacionesget_corporation_code_by_name, get_disclosure_list, get_corporation_info, get_disclosure_document, get_corporation_code
Información clave de informes periódicosget_annual_report, get_quarterly_report, get_semi_annual_report
Información financiera de informes periódicosget_single_acnt, get_multi_acnt, get_xbrl_file, get_single_acc, get_xbrl_taxonomy, get_single_index, get_multi_index
Información integral de divulgaciones de participaciónget_major_shareholders, get_executive_holdings
Información clave de informes de eventos importantesget_major_reports, get_business_reports
Información clave de declaraciones de valoresget_securities_filing, get_prospectus
Búsqueda en notas a los estados financierossearch_financial_notes
Descarga de documentos de divulgaciónget_disclosure_document
Consulta de grafo de conocimientoquery_knowledge_graph

Solución de problemas y depuración

Problemas comunes

  • Fallo de autenticación:

    • Verifique que la clave API sea válida y esté activa
    • Verifique que la clave API tenga los permisos necesarios
    • Verifique si se excedió el límite de llamadas a la API (20,000 por día)

  • Problemas de acceso a datos:

    • Algunos datos pueden requerir permisos adicionales
    • Algunos datos pueden tener acceso diferido (hasta 24 horas)
    • Verifique que la empresa esté dentro del alcance accesible

  • Problemas de conexión:

    • Verifique la conexión a Internet
    • Verifique la disponibilidad del servicio de la API de OpenDART
    • Verifique que el firewall no esté bloqueando la conexión

Herramientas de depuración

# 상세 로깅 활성화
export LOG_LEVEL=DEBUG

# 로그 확인
tail -f opendart.log

# API 연결 테스트
python -m mcp_opendart test-connection

Seguridad

  • Nunca comparta su clave API
  • Guarde el archivo .env de forma segura
  • Use límites de velocidad adecuados
  • Monitoree el uso de la API
  • Almacene datos sensibles en variables de entorno

Contribuciones

¡Las contribuciones son bienvenidas! Para contribuir:

  1. Haga un fork del repositorio
  2. Cree una rama de funcionalidad
  3. Realice sus cambios
  4. Envíe una solicitud de extracción (pull request)

Licencia

Este proyecto puede usarse únicamente con fines no comerciales, personales, de investigación, educativos y sin fines de lucro. El uso comercial, la redistribución y el uso comercial de obras derivadas están estrictamente prohibidos. Para más detalles, consulte el archivo LICENSE.

Este proyecto no es un producto oficial de OpenDART. OpenDART es una marca registrada de la Financial Supervisory Service.