MCP OpenDART

Acesse dados financeiros do OpenDART (Sistema de Análise, Recuperação e Transferência de Dados) da Coreia para modelos de linguagem de IA.

GitHubExperimente este MCPPatrocinado

Documentação

한국어 | English

MCP OpenDART

PyPI Version PyPI Downloads

Este é um servidor Model Context Protocol (MCP) para o OpenDART (sistema de divulgação eletrônica da Financial Supervisory Service). Esta integração permite interações seguras e contextuais de IA com o OpenDART, mantendo a privacidade e a segurança dos dados.

Exemplos de uso

Você pode fazer solicitações como as seguintes ao assistente de IA:

📊 Relatórios financeiros - "Traga o relatório trimestral mais recente da Samsung Electronics"
🔍 Busca de divulgações - "Encontre as principais mudanças de participação acionária das empresas do KOSPI no mês passado"
📈 Análise de empresas - "Mostre as demonstrações financeiras da Hyundai Motor dos últimos 3 anos"
⚡ Atualizações em tempo real - "Traga as divulgações importantes do setor de tecnologia de hoje"

Demonstração de funcionalidades

Demo

Exemplo de uso: Análise do relatório anual de 2024 da Samsung Electronics

Pergunta:

Com base no relatório anual de 2024 da Samsung Electronics, responda às seguintes perguntas:

Quem é o funcionário mais bem pago? Informe os 5 maiores salários individuais e os valores.
Houve mudança na participação dos controladores? Qual foi a variação na participação do acionista majoritário e partes relacionadas e o motivo das transações?
Quanto é pago em dividendos? Mostre a tendência de 3 anos de dividendos, rendimento de dividendos e índice de payout, e a sustentabilidade dos dividendos.
Existem riscos ocultos? Pesquise nas notas explicativas das demonstrações financeiras por informações sobre processos judiciais, passivos contingentes e provisões.
Quais são as perspectivas para o negócio de HBM? Resuma a posição oficial da empresa sobre HBM e semicondutores de IA na seção de descrição do negócio.

Resuma 3 pontos de atenção ao investir na Samsung Electronics.

Resposta:

Vou analisar com base no relatório anual de 2024 da Samsung Electronics. Primeiro, vou consultar o número de registro da Samsung Electronics. O número de registro da Samsung Electronics é 00126380. Agora vou consultar as informações para cada pergunta. Agora vou pesquisar nas notas explicativas das demonstrações financeiras por informações sobre processos judiciais e passivos contingentes. Agora vou fornecer uma análise abrangente com base nas informações coletadas.

Análise abrangente do relatório anual de 2024 da Samsung Electronics

1) Funcionário mais bem pago - 5 maiores salários individuais

Ranking	Nome	Cargo	Remuneração total
1	Kyung Kye-hyun	Consultor	8,036 bilhões de KRW
2	Lee Jung-bae	Conselheiro	6,950 bilhões de KRW
3	Choi Si-young	Conselheiro	6,900 bilhões de KRW
4	Han Jong-hee	CEO	5,240 bilhões de KRW
5	Roh Tae-moon	Diretor	5,098 bilhões de KRW

Análise: É notável que executivos aposentados (consultores/conselheiros) recebem salários mais altos do que os executivos atuais. Kyung Kye-hyun, ex-chefe da divisão DS, recebeu mais de 8 bilhões de KRW mesmo após a aposentadoria, o que parece incluir verbas rescisórias e bônus de desempenho anteriores.

2) Mudança na participação dos controladores - Acionista majoritário e partes relacionadas

Acionista	Relação	Participação inicial	Participação final	Variação	Motivo
Samsung Life Insurance	Acionista majoritário	8,51%	8,51%	-	Sem alteração
Samsung C&T	Empresa afiliada	5,01%	5,01%	-	Sem alteração
Hong Ra-hee	Parte relacionada	1,96%	1,64%	▼0,32%	Negociação fora do pregão
Lee Jae-yong	Parte relacionada	1,63%	1,63%	-	Sem alteração
Lee Boo-jin	Executiva de empresa afiliada	0,93%	0,80%	▼0,13%	Negociação fora do pregão
Lee Seo-hyun	Executiva de empresa afiliada	0,93%	0,79%	▼0,14%	Negociação fora do pregão
Total	-	20,70%	20,07%	▼0,63%	-

Análise:

Hong Ra-hee, Lee Boo-jin e Lee Seo-hyun venderam aproximadamente 37 milhões de ações (cerca de 2 trilhões de KRW) em negociações fora do pregão
A participação do presidente Lee Jae-yong (1,63%) permaneceu inalterada
A participação total das partes relacionadas diminuiu de 20,70% para 20,07%
Motivo da venda: presumivelmente para levantar recursos para pagamento de imposto sobre herança e ajuste do portfólio de ativos

3) Situação dos dividendos - Tendência de 3 anos

Item	2024	2023	2022
Lucro líquido consolidado	33,6 trilhões de KRW	14,5 trilhões de KRW	54,7 trilhões de KRW
Total de dividendos em dinheiro	9,81 trilhões de KRW	9,81 trilhões de KRW	9,81 trilhões de KRW
Dividendo por ação (ordinária)	1.446 KRW	1.444 KRW	1.444 KRW
Rendimento de dividendos (ordinária)	2,7%	1,9%	2,5%
Índice de payout	29,2%	67,8%	17,9%

Avaliação da sustentabilidade dos dividendos:

Positivo: Manutenção estável de dividendos de aproximadamente 9,8 trilhões de KRW por 3 anos consecutivos (consistência da política de retorno aos acionistas)
Atenção: O índice de payout de 67,8% em 2023 foi um fenômeno temporário devido à queda acentuada no lucro líquido
Perspectiva: Com a recuperação do lucro líquido em 2024 (33,6 trilhões de KRW), o índice de payout normalizou para 29,2%. O nível atual de dividendos é sustentável

4) Riscos ocultos - Análise das notas explicativas das demonstrações financeiras

📌 Principais processos judiciais/passivos contingentes

① Processo administrativo relacionado à contabilização da Samsung BioLogics (em andamento)

A Securities & Futures Commission impôs multa de 8 bilhões de KRW e ordenou a reescrita das demonstrações financeiras devido a erro na contabilização da participação na Samsung Bioepis
A Samsung BioLogics está contestando a anulação da medida
O Tribunal Administrativo de Seul decidiu pela anulação da medida em 2020 (1ª) e 2024 (2ª) → A SFC está recorrendo
Risco: Em caso de derrota no processo, pode afetar o resultado de equivalência patrimonial, investimentos em associadas e lucros acumulados da Samsung Electronics de 2015 a 2022

② Passivos contingentes de processos judiciais

"Processos, disputas e investigações regulatórias em andamento decorrentes de operações comerciais normais com diversas empresas"
A administração avalia que não terão impacto significativo na posição financeira
No entanto, o valor e o momento da saída de recursos são incertos

③ Provisões

Provisão para garantia de vendas: estimativa de custos com garantia de qualidade do produto, trocas e reparos
Provisão para emissões: provisão para custos esperados com excesso de créditos de emissão de gases de efeito estufa

5) Perspectivas para o negócio de HBM e semicondutores de IA - Posição oficial da empresa

📌 Resultados do 4º trimestre de 2024

"Embora o ajuste de estoques dos clientes de mobile/PC tenha se intensificado, os investimentos voltados para IA dos principais data centers e empresas de tecnologia continuaram, e a demanda por HBM e DRAM para servidores permaneceu robusta."

📌 Perspectivas e riscos para 2025

"Espera-se que o momentum da demanda por IA continue, mas a demanda de data centers e clientes OEM pode variar dependendo da oferta de GPUs, e a volatilidade da demanda por HBM devido aos controles de exportação de semicondutores para IA também continua."

📌 Estratégia de resposta da empresa

Transição do portfólio para produtos de alto valor agregado (HBM, DDR5, LPDDR5x, QLC SSD)
Aceleração da transição para processos de ponta
Foco em atender à demanda por DDR5 para servidores e QLC SSD de alta capacidade para servidores

📌 Negócio de foundry

"Em 2025, espera-se que o mercado de foundry continue com forte demanda por aplicações HPC/AI, com crescimento de dois dígitos centrado no mercado de nós avançados"

Expansão da demanda mobile/HPC com base no rendimento estável do processo de 4nm
Preparação para produção em massa de chips mobile no processo de 3nm com GAA no primeiro semestre de 2025

🚨 3 pontos de atenção ao investir na Samsung Electronics

1️⃣ Defasagem na competitividade de HBM e risco geopolítico

Posição de seguidora em tecnologia HBM e aquisição de clientes em comparação com a SK Hynix
Possibilidade de queda acentuada na demanda por HBM para a China se os EUA reforçarem os controles de exportação de semicondutores de IA
Incerteza na expansão da participação da Samsung Electronics devido à diversificação de fornecedores por clientes importantes como a NVIDIA

2️⃣ Venda de participação pela família controladora e instabilidade na governança corporativa

Venda contínua de aproximadamente 2 trilhões de KRW por ano por Hong Ra-hee, Lee Boo-jin e Lee Seo-hyun
A participação pessoal do presidente Lee Jae-yong (1,63%) é baixa, gerando preocupações com a estabilidade do controle
Alta dependência de empresas afiliadas como Samsung Life (8,51%) + Samsung C&T (5,01%)
Possibilidade contínua de venda de participação para pagamento adicional de imposto sobre herança

3️⃣ Impacto potencial do processo de contabilização da Samsung BioLogics

Processo administrativo em andamento, resultado imprevisível
Em caso de derrota, revisão retroativa das demonstrações financeiras de 2015 a 2022 → possível redução dos lucros acumulados
Risco de distorção das demonstrações financeiras consolidadas devido a alterações nos investimentos em associadas e no resultado de equivalência patrimonial
A empresa afirma que é difícil refletir nas demonstrações financeiras neste momento

Conclusão: A Samsung Electronics está se beneficiando do momentum de demanda por IA/HBM, mas é necessário monitorar de perto a defasagem tecnológica em relação aos concorrentes, as incertezas geopolíticas e os riscos relacionados à governança corporativa. Os dividendos são estáveis, mas, dada a alta volatilidade do lucro líquido, é mais adequado observar a manutenção do valor absoluto dos dividendos do que o índice de payout.

Funcionalidades suportadas

📊 6 categorias principais de análise

Categoria	Objetivo da análise	Principais áreas de análise
🔍 Análise de informações de divulgação	Capturar padrões de divulgação e sinais de mudanças na gestão	• Previsão de mudanças na situação da gestão por meio da análise de frequência e tipo de divulgações • Monitoramento em tempo real de divulgações importantes, como relatórios de eventos relevantes e mudanças na estrutura de governança • Descoberta de riscos ocultos por meio da extração automática de notas explicativas das demonstrações financeiras • Identificação de intenções estratégicas por meio do parsing estruturado da descrição do negócio/visão geral da empresa
📈 Análise de informações principais de relatórios periódicos	Extrair informações essenciais de gestão de relatórios anuais, trimestrais e semestrais	• Avaliação de riscos de governança por meio da análise de remuneração de executivos e sistemas de compensação • Análise da sustentabilidade da política de dividendos e estratégias de retorno aos acionistas • Identificação de intenções de captação de recursos por meio de padrões de variação de capital (aumento/redução de capital, ações em tesouraria) • Avaliação da estabilidade organizacional por meio da situação de funcionários e estrutura de custos de pessoal
💰 Análise de informações financeiras de relatórios periódicos	Avaliação da saúde financeira com base em demonstrações financeiras e dados XBRL	• Análise abrangente de indicadores de rentabilidade (ROA/ROE), estabilidade (índice de endividamento), crescimento e atividade • Detecção de volatilidade e anomalias no desempenho financeiro por meio de análise de tendência temporal • Avaliação da posição relativa e competitividade em comparação com a média do setor • Análise da estrutura de saúde financeira do grupo como um todo com base nas demonstrações financeiras consolidadas
👥 Análise abrangente de informações de participação acionária	Avaliação da estabilidade da governança e riscos de mudança no controle	• Monitoramento da estabilidade do controle por meio de mudanças na participação do acionista majoritário e partes relacionadas • Detecção precoce de possibilidade de aquisição hostil por meio de mudanças na participação de acionistas com 5% ou mais • Análise de suspeitas de negociação com informações privilegiadas por meio de negociações de ações de executivos e acionistas principais • Avaliação da defesa contra M&A e riscos de governança por meio do grau de dispersão dos acionistas minoritários
⚡ Análise de relatórios de eventos relevantes	Capturar sinais de mudanças estratégicas e reestruturação	• Análise de estratégias de reestruturação por meio de decisões de aquisição/alienação de negócios, fusões/incorporações • Identificação de mudanças na estratégia de gestão por meio de contratos de compra e venda de ativos e opções de venda (put-back) • Alerta precoce de crises de gestão, como falência, suspensão de operações e processos de recuperação • Avaliação de riscos legais e impacto financeiro por meio de fatos de ações judiciais
💼 Análise de declarações de registro de valores mobiliários	Análise aprofundada da estrutura de captação de recursos e riscos de endividamento	• Análise das condições de emissão de títulos de dívida (debêntures, debêntures conversíveis, debêntures com bônus de subscrição) • Avaliação de riscos de liquidez e refinanciamento por meio da estrutura de dívidas de curto/longo prazo • Verificação da transparência na gestão de recursos por meio do uso de recursos de ofertas públicas/privadas • Análise da estratégia global de captação de recursos e riscos cambiais por meio de decisões de listagem no exterior

🎯 Funcionalidades avançadas de análise

Extração automática de notas explicativas das demonstrações financeiras: parsing automático das notas explicativas das demonstrações financeiras consolidadas e individuais, armazenando como dados estruturados
Parsing da descrição do negócio: parsing dinâmico da seção II. Descrição do negócio, estruturando por subseções como visão geral do negócio, situação operacional e saúde financeira
Parsing da visão geral da empresa: parsing dinâmico da seção I. Visão geral da empresa, extraindo informações essenciais como histórico da empresa, variações de capital e número total de ações
Busca em dados estruturados: busca semântica por tabelas e parágrafos para localizar imediatamente informações detalhadas relacionadas a palavras-chave específicas (ex.: processos judiciais, passivos contingentes, HBM)
Seleção inteligente de arquivos XML: seleção automática do melhor relatório de negócios em arquivos ZIP, excluindo relatórios de auditoria, maximizando a eficiência da análise

🧠 Sistema de grafo de conhecimento baseado em ontologia

Geração automática de grafo de conhecimento: geração automática de grafo de conhecimento estruturado ao armazenar documentos de divulgação em cache
- Entidades: Corporação, Divulgação, Seção, Subseção, Tabela, Parágrafo
- Relações: extração automática de relações estruturais como corporação-divulgação, divulgação-seção, seção-subseção
- Metadados: inclui número de nós, número de arestas, horário de geração, etc.
Mecanismo de consulta em linguagem natural: busca baseada em relações usando o grafo de conhecimento
- Suporte a consultas em linguagem natural: "subseções da descrição do negócio", "seção de notas explicativas das demonstrações financeiras", etc.
- Exploração de relações estruturais: exploração automática de relações entre seções e hierarquia de subseções
- Descoberta automática de entidades relacionadas: retorna todos os nós e arestas relacionados à consulta
Expansão de sinônimos por domínio: expansão dinâmica de termos para melhorar a precisão da busca
- Separação por domínio: seguro (synonyms_insurance.json), financeiro (synonyms_finance.json), etc.
- Expansão automática: inclusão automática de sinônimos relacionados na busca (ex.: "CSM" → "margem de serviço contratual", "ativos de contrato de seguro")
- Pontuação de correspondência: fornecimento de pontuação de confiança para termos expandidos
Aprendizado de sinônimos com autoaperfeiçoamento: descoberta automática de sinônimos por meio da análise de resultados de busca e do grafo de conhecimento
- Aprendizado automático: análise de padrões de coocorrência nos resultados de busca
- Análise de relações no grafo de conhecimento: cálculo de confiança com base em nós compartilhados e comprimento de caminhos no grafo
- Aprovação automática baseada em confiança: confiança alta (≥0,8) é aprovada automaticamente; confiança baixa é adicionada à fila de revisão manual
- Sistema de revisão manual: gerenciamento de fila e fornecimento de estatísticas

Guia de início rápido

1. Configuração de autenticação

Primeiro, obtenha sua chave de API do OpenDART:

Acesse o OpenDART
Cadastre-se e solicite a chave de API

2. Instalação

# 저장소 복제
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 .

Executando com Docker

Carregar imagem Docker (usar imagem pré-construída)

Você pode usar a imagem pré-construída incluída no repositório:

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

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

Construir imagem Docker

Para construir manualmente:

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

Executar contêiner Docker

Método 1: Passar variáveis de ambiente diretamente (opção -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 arquivo .env (recomendado)

Crie o arquivo .env e configure as variáveis de ambiente:

# .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: Usar o arquivo .env permite gerenciar informações sensíveis, como chaves de API, sem expô-las no código.

Usar Docker Compose (opcional)

Você pode criar o arquivo 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

Executar:

docker-compose up -d

Verificar a conexão

Quando o servidor estiver em execução, você pode acessar os seguintes endpoints:

Endpoint MCP: http://localhost:8000/mcp
Healthcheck: usa o healthcheck integrado do Docker

Verificar logs

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

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

Parar e remover contêiner

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

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

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

Guia de instalação do Python 3.10+

Verificar versão do Python (necessário 3.10 ou superior)

python3 --version

Se a versão do Python for inferior a 3.10, instale o Python 3.10 ou superior seguindo as instruções abaixo:

macOS

Baixe o instalador do Python mais recente no site oficial: https://www.python.org/downloads/macos/
Ou, se usar Homebrew:
```
brew install python@3.10
```
Após a instalação, pode ser necessário usar o comando python3.10.

Windows

Baixe e execute o instalador do Python mais recente no site oficial: https://www.python.org/downloads/windows/
Marque a opção "Add Python to PATH" durante a instalação.
Após a instalação, reinicie o terminal e use o comando python ou python3.

Linux (Ubuntu/Debian)

Atualize a lista de pacotes e instale o Python 3.10:

sudo apt update
sudo apt install python3.10 python3.10-venv python3.10-distutils

Pode ser necessário usar o comando python3.10.

Linux (Fedora/CentOS/RHEL)

Instale o Python 3.10:
```
sudo dnf install python3.10
```

Integração com IDE

O MCP OpenDART foi projetado para ser usado com assistentes de IA por meio da integração com IDE.

Como configurar no Claude Desktop

Clique no menu hambúrguer (☰) > Settings > Developer > botão "Edit Config"
Adicione a seguinte configuração:

{
  "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"
      }
    }
  }
}

Configuração Streamable HTTP (opcional)

Você também pode executar usando transporte HTTP com streamable-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]

Com TRANSPORT="http", o servidor é executado no modo streamable-http

Endpoint: http://HOST:PORT/mcp

[!NOTE]

YOUR_LOCATION: altere para o caminho real onde o ambiente virtual está instalado

API-KEY: altere para a chave de API do OpenDART emitida

Principais variáveis de ambiente

OPENDART_API_KEY: chave de API do OpenDART
OPENDART_BASE_URL: URL base da API (padrão: URL oficial)
HOST: host do servidor (padrão: 0.0.0.0)
PORT: porta do servidor (padrão: 8000)
TRANSPORT: método de transporte (stdio recomendado; se definido como http, suporta streamable-http)
LOG_LEVEL: nível de log (INFO, DEBUG, etc.)
MCP_SERVER_NAME: nome do servidor

Sistema de extração e busca automática de notas explicativas das demonstrações financeiras

Arquitetura do 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[문단 검색 결과]

Estrutura de cache

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_정관에_관한_사항/

Funcionalidades de busca

Busca em tabelas: busca por palavras-chave em cabeçalhos e células de dados
Busca em parágrafos: busca por palavras-chave em parágrafos das notas explicativas das demonstrações financeiras
Busca por seção: busca em notas explicativas das demonstrações financeiras consolidadas, notas explicativas das demonstrações financeiras, descrição do negócio e visão geral da empresa
Classificação de contexto: classificação automática em informações básicas, informações de negócio e informações financeiras
Expansão automática: inclusão automática de todas as subseções ao buscar na descrição do negócio e na visão geral da empresa
Diferenciação de maiúsculas/minúsculas: busca opcional com diferenciação de maiúsculas e minúsculas
Expansão automática de sinônimos: expansão automática de termos de busca com base em dicionários de sinônimos por domínio (ex.: "CSM" → "margem de serviço contratual", "ativos de contrato de seguro")
Consulta ao grafo de conhecimento: exploração de relações estruturais em linguagem natural (ex.: "subseções da descrição do negócio", "seção de notas explicativas das demonstrações financeiras")

Ferramentas

Ferramentas do OpenDART

ds001_disclosure: busca e consulta de informações de divulgação
ds002_periodic: consulta de informações principais de relatórios periódicos
ds003_financial: consulta de informações financeiras de relatórios periódicos
ds004_ownership: consulta de informações abrangentes de participação acionária
ds005_major: consulta de informações principais de relatórios de eventos relevantes
ds006_securities: consulta de informações principais de declarações de registro de valores mobiliários

Lista de ferramentas principais

Categoria	Ferramentas
Informações de divulgação	`get_corporation_code_by_name`, `get_disclosure_list`, `get_corporation_info`, `get_disclosure_document`, `get_corporation_code`
Informações principais de relatórios periódicos	`get_annual_report`, `get_quarterly_report`, `get_semi_annual_report`
Informações financeiras de relatórios periódicos	`get_single_acnt`, `get_multi_acnt`, `get_xbrl_file`, `get_single_acc`, `get_xbrl_taxonomy`, `get_single_index`, `get_multi_index`
Informações abrangentes de participação acionária	`get_major_shareholders`, `get_executive_holdings`
Informações principais de relatórios de eventos relevantes	`get_major_reports`, `get_business_reports`
Informações principais de declarações de registro de valores mobiliários	`get_securities_filing`, `get_prospectus`
Busca em notas explicativas das demonstrações financeiras	`search_financial_notes`
Download de documentos de divulgação	`get_disclosure_document`
Consulta ao grafo de conhecimento	`query_knowledge_graph`

Solução de problemas e depuração

Problemas comuns

Falha de autenticação:
- Verifique se a chave de API é válida e está ativa
- Verifique se a chave de API tem as permissões necessárias
- Verifique se o limite de chamadas de API (20.000/dia) não foi excedido
Problemas de acesso a dados:
- Alguns dados podem exigir permissões adicionais
- Alguns dados podem ter acesso atrasado (até 24 horas)
- Verifique se a empresa está dentro do escopo acessível
Problemas de conexão:
- Verifique a conexão com a internet
- Verifique a disponibilidade do serviço da API do OpenDART
- Verifique se o firewall não está bloqueando a conexão

Ferramentas de depuração

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

# 로그 확인
tail -f opendart.log

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

Segurança

Nunca compartilhe sua chave de API
Guarde o arquivo .env com segurança
Use limites de taxa apropriados
Monitore o uso da API
Armazene dados sensíveis em variáveis de ambiente

Contribuindo

Contribuições são bem-vindas! Para contribuir:

Faça um fork do repositório
Crie um branch de funcionalidade
Faça suas alterações
Envie um pull request

Licença

Este projeto pode ser usado apenas para fins não comerciais, pessoais, de pesquisa, aprendizado e sem fins lucrativos. Uso comercial, redistribuição e uso comercial de obras derivadas são estritamente proibidos. Para mais detalhes, consulte o arquivo LICENSE.

Este projeto não é um produto oficial do OpenDART. OpenDART é uma marca registrada da Financial Supervisory Service.