korea-dart-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Chris Ryu
+Copyright (c) 2026 gwangjun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# Korea DART MCP
+
+OpenDART 공시 원문을 표 구조 보존 상태로 가져오는 5-tool MCP 서버입니다.
+
+이 서버는 데이터 파이프만 담당합니다. 분석, 가공, 비교, 투자 판단은 MCP가 하지 않고 LLM이 원문과 구조화 데이터를 직접 읽고 수행합니다.
+
+## Tools
+
+| Tool | Purpose |
+|---|---|
+| `find_company` | 회사명, 종목코드, corp_code로 회사를 찾고 상장 여부와 structured financial API 사용 가능 여부를 반환 |
+| `search_disclosures` | 회사/기간/공시유형 A~J/프리셋 기준 공시 목록 검색. 프리셋이 없으면 지정 `kind` 전체 반환 |
+| `read_disclosures` | DART `document.xml` 원문을 `markdown`, `raw`, `toc`로 읽기. Markdown은 표 구조를 보존 |
+| `read_attachment` | DART 뷰어 첨부파일 목록 조회 및 HWP/PDF/DOCX/XLSX 첨부를 Markdown으로 추출 |
+| `get_financials` | 상장사 structured 재무제표 조회. `detail=summary/full`, `fs_div=CFS/OFS` 지원 |
+
+## Design
+
+- 회사명은 `CorpCodeResolver`가 OpenDART `corpCode.xml` 덤프를 SQLite 캐시에 적재해 자동 해결합니다.
+- 공시 원문은 upstream의 DART XML parser를 사용해 heading과 table을 Markdown으로 변환합니다.
+- 큰 사업보고서는 `read_disclosures(format="toc")`로 목차를 먼저 보고, `section_id`, `section_title`, `query`로 필요한 섹션/검색 excerpt만 가져오면 빠릅니다.
+- 첨부파일은 DART viewer HTML에서 `dcm_no`와 download links를 찾아 `kordoc`으로 Markdown 추출합니다.
+- 비상장 회사의 재무제표는 `get_financials`가 아니라 `search_disclosures`와 `read_disclosures`/`read_attachment`로 감사보고서 원문을 읽는 흐름입니다.
+- XBRL/정기보고서/지분/이벤트/리스크/퀄리티 같은 합성·분석 wrapper는 노출하지 않습니다.
+
+## Install
+
+```bash
+npm install
+npm run build
+```
+
+## Run
+
+`DART_API_KEY`가 필요합니다.
+
+```bash
+$env:DART_API_KEY="YOUR_OPEN_DART_KEY"
+npm start
+```
+
+MCP 클라이언트에서는 `build/index.js`를 stdio 서버로 등록하세요.
+
+## Notes
+
+- OpenDART API key: https://opendart.fss.or.kr/
+- OpenDART 일일 호출 한도는 키 기준 20,000건입니다.
+- corp code 캐시 기본 경로는 `~/.korea-dart-mcp/corp_code.sqlite`입니다.
+
+## Credits
+
+원작자 [chrisryugj/korean-dart-mcp](https://github.com/chrisryugj/korean-dart-mcp)를 fork해 이어받았습니다. (MIT License)

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "dotenv/config";

package/build/index.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server/mcp-server.js";
+import { SERVER_NAME, VERSION } from "./version.js";
+async function main() {
+    const args = process.argv.slice(2);
+    // setup 서브커맨드: npx korea-dart-mcp setup
+    if (args[0] === "setup") {
+        const { runSetup } = await import("./setup.js");
+        try {
+            await runSetup();
+        }
+        catch (err) {
+            if (err?.code === "ERR_USE_AFTER_CLOSE")
+                return;
+            throw err;
+        }
+        return;
+    }
+    const apiKey = process.env.DART_API_KEY;
+    if (!apiKey) {
+        console.error(`[${SERVER_NAME}] DART_API_KEY 가 설정되지 않았습니다.\n` +
+            `발급: https://opendart.fss.or.kr/ (가입 → 인증키 신청)\n` +
+            `쉽게 설치: npx -y korea-dart-mcp setup`);
+        process.exit(1);
+    }
+    const server = createServer({ apiKey, cacheDir: process.env.DART_CACHE_DIR });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`[${SERVER_NAME}] v${VERSION} stdio 서버 시작`);
+}
+main().catch((err) => {
+    console.error(`[${SERVER_NAME}] fatal:`, err);
+    process.exit(1);
+});

package/build/lib/corp-code.d.ts

@@ -0,0 +1,53 @@
+/**
+ * corp_code 리졸버
+ *
+ * 문제: LLM은 "삼성전자" 만 아는데, 모든 OpenDART 엔드포인트는 8자리 corp_code 필수.
+ * 해결: 서버 기동 시 `corpCode.xml` 전체 덤프를 내려받아 SQLite 로 인덱싱.
+ *       첫 호출 시 한 번만 받고, 이후는 캐시 디렉터리에서 재사용 (24h TTL).
+ *
+ * 엔드포인트: /api/corpCode.xml  (ZIP → CORPCODE.xml)
+ * 레코드 형식: <list><corp_code>...</corp_code><corp_name>...</corp_name>
+ *              <corp_eng_name>...</corp_eng_name><stock_code>...</stock_code>
+ *              <modify_date>...</modify_date></list>
+ */
+import type { DartClient } from "./dart-client.js";
+export interface CorpRecord {
+    corp_code: string;
+    corp_name: string;
+    corp_eng_name?: string;
+    stock_code?: string;
+    modify_date?: string;
+}
+export interface CorpCodeResolverOptions {
+    /** 캐시 디렉터리 (기본: ~/.korea-dart-mcp) */
+    cacheDir?: string;
+    /** 디스크 캐시를 무시하고 재다운로드 */
+    forceRefresh?: boolean;
+    /** 캐시 TTL (ms, 기본 24h) */
+    ttlMs?: number;
+}
+export declare class CorpCodeResolver {
+    private readonly cacheDir;
+    private readonly dbPath;
+    private readonly forceRefresh;
+    private readonly ttlMs;
+    private db;
+    private initPromise;
+    constructor(opts?: CorpCodeResolverOptions);
+    /** 서버 기동 시 1회 호출. 캐시 유효하면 DB만 열고 끝. */
+    init(client: DartClient): Promise<void>;
+    private doInit;
+    private isCacheFresh;
+    /** 키워드로 회사 검색. alias → 상장사 → 완전일치 → 접두사 → 짧은 이름 → 낮은 종목코드 순. */
+    search(keyword: string, limit?: number): CorpRecord[];
+    byStockCode(code: string): CorpRecord | undefined;
+    byCorpCode(code: string): CorpRecord | undefined;
+    /**
+     * 입력 문자열을 단일 corp_code 로 해석.
+     *  - 8자리 숫자 → byCorpCode
+     *  - 6자리 숫자 → byStockCode
+     *  - 그 외 → search() 상위 1건
+     */
+    resolve(input: string): CorpRecord | undefined;
+    private requireDb;
+}

package/build/lib/corp-code.js

@@ -0,0 +1,239 @@
+/**
+ * corp_code 리졸버
+ *
+ * 문제: LLM은 "삼성전자" 만 아는데, 모든 OpenDART 엔드포인트는 8자리 corp_code 필수.
+ * 해결: 서버 기동 시 `corpCode.xml` 전체 덤프를 내려받아 SQLite 로 인덱싱.
+ *       첫 호출 시 한 번만 받고, 이후는 캐시 디렉터리에서 재사용 (24h TTL).
+ *
+ * 엔드포인트: /api/corpCode.xml  (ZIP → CORPCODE.xml)
+ * 레코드 형식: <list><corp_code>...</corp_code><corp_name>...</corp_name>
+ *              <corp_eng_name>...</corp_eng_name><stock_code>...</stock_code>
+ *              <modify_date>...</modify_date></list>
+ */
+import { mkdirSync, existsSync, unlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import Database from "better-sqlite3";
+import { DOMParser } from "@xmldom/xmldom";
+import { safeUnzipToMemory } from "../utils/safe-zip.js";
+const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000;
+const CORP_CODE_RE = /^\d{8}$/;
+const STOCK_CODE_RE = /^\d{6}$/;
+// 영문 corp_name 으로 등록된 한국 상장사 — 한글 query 로 LIKE 매칭이 안 되어
+// 자회사로 잘못 resolve 되는 케이스 방어. corp_code 는 OpenDART corpCode.xml 검증 필요.
+// "현대차" 같은 약어도 자회사 우선 정렬되는 케이스라 alias 에 포함.
+const KOREAN_ALIAS = {
+    네이버: "00266961", // NAVER
+    현대차: "00164742", // 현대자동차
+};
+export class CorpCodeResolver {
+    constructor(opts = {}) {
+        this.db = null;
+        this.initPromise = null;
+        this.cacheDir = opts.cacheDir ?? join(homedir(), ".korea-dart-mcp");
+        this.dbPath = join(this.cacheDir, "corp_code.sqlite");
+        this.forceRefresh = opts.forceRefresh ?? false;
+        this.ttlMs = opts.ttlMs ?? DEFAULT_TTL_MS;
+    }
+    /** 서버 기동 시 1회 호출. 캐시 유효하면 DB만 열고 끝. */
+    async init(client) {
+        if (this.initPromise)
+            return this.initPromise;
+        this.initPromise = this.doInit(client);
+        return this.initPromise;
+    }
+    async doInit(client) {
+        if (!existsSync(this.cacheDir)) {
+            mkdirSync(this.cacheDir, { recursive: true });
+        }
+        const cacheFresh = !this.forceRefresh && this.isCacheFresh();
+        if (cacheFresh) {
+            this.db = new Database(this.dbPath, { readonly: true });
+            return;
+        }
+        console.error("[corp-code] 덤프 다운로드 중... (수 초 소요)");
+        const zipBuf = await client.getZip("corpCode.xml");
+        const xml = await extractCorpCodeXml(zipBuf);
+        const records = parseCorpCodeXml(xml);
+        console.error(`[corp-code] ${records.length}개 회사 적재 중...`);
+        this.db = buildDatabase(this.dbPath, records);
+        console.error("[corp-code] 준비 완료");
+    }
+    isCacheFresh() {
+        if (!existsSync(this.dbPath))
+            return false;
+        try {
+            const db = new Database(this.dbPath, { readonly: true });
+            const row = db
+                .prepare("SELECT value FROM meta WHERE key = 'updated_at'")
+                .get();
+            db.close();
+            if (!row)
+                return false;
+            const age = Date.now() - Number(row.value);
+            return age < this.ttlMs;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** 키워드로 회사 검색. alias → 상장사 → 완전일치 → 접두사 → 짧은 이름 → 낮은 종목코드 순. */
+    search(keyword, limit = 10) {
+        const db = this.requireDb();
+        const k = keyword.trim();
+        if (!k)
+            return [];
+        // 1. 한글 alias 우선: 영문등록 한국 상장사가 LIKE 매칭에서 누락되는 케이스 방어
+        const aliasCode = KOREAN_ALIAS[k];
+        let aliased;
+        if (aliasCode)
+            aliased = this.byCorpCode(aliasCode);
+        // 2. 일반 LIKE 검색. 동률 정렬 시 stock_code ASC 추가 (낮은 종목코드 = 오래된 대형사 휴리스틱).
+        const like = `%${k}%`;
+        const rows = db
+            .prepare(`SELECT corp_code, corp_name, corp_eng_name, stock_code, modify_date
+         FROM corps
+         WHERE corp_name LIKE ?
+            OR corp_eng_name LIKE ?
+         ORDER BY
+           (stock_code IS NULL OR stock_code = '') ASC,
+           CASE WHEN corp_name = ? THEN 0
+                WHEN corp_name LIKE ? THEN 1
+                ELSE 2 END,
+           length(corp_name) ASC,
+           CASE WHEN stock_code IS NULL OR stock_code = '' THEN 1 ELSE 0 END,
+           stock_code ASC
+         LIMIT ?`)
+            .all(like, like, k, `${k}%`, limit);
+        const normalized = rows.map(normalize);
+        // alias 결과를 1위로 prepend (중복 제거)
+        if (aliased) {
+            const others = normalized.filter((r) => r.corp_code !== aliased.corp_code);
+            return [aliased, ...others].slice(0, limit);
+        }
+        return normalized;
+    }
+    byStockCode(code) {
+        const db = this.requireDb();
+        const row = db
+            .prepare(`SELECT corp_code, corp_name, corp_eng_name, stock_code, modify_date
+         FROM corps WHERE stock_code = ? LIMIT 1`)
+            .get(code);
+        return row ? normalize(row) : undefined;
+    }
+    byCorpCode(code) {
+        const db = this.requireDb();
+        const row = db
+            .prepare(`SELECT corp_code, corp_name, corp_eng_name, stock_code, modify_date
+         FROM corps WHERE corp_code = ? LIMIT 1`)
+            .get(code);
+        return row ? normalize(row) : undefined;
+    }
+    /**
+     * 입력 문자열을 단일 corp_code 로 해석.
+     *  - 8자리 숫자 → byCorpCode
+     *  - 6자리 숫자 → byStockCode
+     *  - 그 외 → search() 상위 1건
+     */
+    resolve(input) {
+        const s = input.trim();
+        if (CORP_CODE_RE.test(s))
+            return this.byCorpCode(s);
+        if (STOCK_CODE_RE.test(s))
+            return this.byStockCode(s);
+        return this.search(s, 1)[0];
+    }
+    requireDb() {
+        if (!this.db) {
+            throw new Error("CorpCodeResolver.init() 을 먼저 호출하세요.");
+        }
+        return this.db;
+    }
+}
+function normalize(row) {
+    return {
+        corp_code: row.corp_code,
+        corp_name: row.corp_name,
+        corp_eng_name: row.corp_eng_name || undefined,
+        stock_code: row.stock_code && row.stock_code.trim() !== "" ? row.stock_code : undefined,
+        modify_date: row.modify_date || undefined,
+    };
+}
+async function extractCorpCodeXml(zipBuf) {
+    // corp_code 전량 덤프는 현재 ~30MB 수준. 장기 성장 대비 총 300MB · 단일 300MB 허용.
+    const entries = await safeUnzipToMemory(zipBuf, {
+        maxTotalBytes: 300 * 1024 * 1024,
+        maxEntryBytes: 300 * 1024 * 1024,
+        maxEntries: 16,
+        filter: (name) => /CORPCODE\.xml$/i.test(name),
+    });
+    const hit = entries[0];
+    if (!hit)
+        throw new Error("CORPCODE.xml not found in zip");
+    return hit.data.toString("utf8");
+}
+function parseCorpCodeXml(xml) {
+    const doc = new DOMParser().parseFromString(xml, "text/xml");
+    const listEls = doc.getElementsByTagName("list");
+    const out = [];
+    for (let i = 0; i < listEls.length; i++) {
+        const el = listEls[i];
+        const code = text(el, "corp_code");
+        const name = text(el, "corp_name");
+        if (!code || !name)
+            continue;
+        out.push({
+            corp_code: code,
+            corp_name: name,
+            corp_eng_name: text(el, "corp_eng_name") || undefined,
+            stock_code: text(el, "stock_code") || undefined,
+            modify_date: text(el, "modify_date") || undefined,
+        });
+    }
+    return out;
+}
+// xmldom 의 Element 타입을 직접 쓰지 않고 duck-typing 으로 접근.
+// DOM lib 을 tsconfig 에 포함시키지 않아 전역 Element 가 없음.
+function text(parent, tag) {
+    const t = parent.getElementsByTagName(tag)[0]?.textContent ?? "";
+    return t.trim();
+}
+function buildDatabase(path, records) {
+    // 파일 삭제는 best-effort. 다른 프로세스가 파일을 잠그고 있어도(라이브 MCP + 스모크 동시 실행 등)
+    // 아래 CREATE TABLE IF NOT EXISTS + DELETE FROM 조합으로 재빌드가 안전하게 동작한다.
+    if (existsSync(path)) {
+        try {
+            unlinkSync(path);
+        }
+        catch {
+            /* ignore — 잠겨 삭제 못 해도 아래 DELETE FROM 으로 초기화됨 */
+        }
+    }
+    const db = new Database(path);
+    db.pragma("journal_mode = WAL");
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS corps (
+      corp_code TEXT PRIMARY KEY,
+      corp_name TEXT NOT NULL,
+      corp_eng_name TEXT,
+      stock_code TEXT,
+      modify_date TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_corps_name ON corps(corp_name);
+    CREATE INDEX IF NOT EXISTS idx_corps_stock ON corps(stock_code) WHERE stock_code IS NOT NULL AND stock_code != '';
+    CREATE TABLE IF NOT EXISTS meta (key TEXT PRIMARY KEY, value TEXT NOT NULL);
+  `);
+    // 기존 파일이 살아남은 경우(삭제 실패 등) 이전 데이터를 비우고 새로 적재한다.
+    db.exec("DELETE FROM corps; DELETE FROM meta;");
+    const insert = db.prepare(`INSERT OR REPLACE INTO corps (corp_code, corp_name, corp_eng_name, stock_code, modify_date)
+     VALUES (?, ?, ?, ?, ?)`);
+    const tx = db.transaction((items) => {
+        for (const r of items) {
+            insert.run(r.corp_code, r.corp_name, r.corp_eng_name ?? null, r.stock_code ?? null, r.modify_date ?? null);
+        }
+    });
+    tx(records);
+    db.prepare("INSERT OR REPLACE INTO meta(key, value) VALUES('updated_at', ?)").run(String(Date.now()));
+    db.prepare("INSERT OR REPLACE INTO meta(key, value) VALUES('count', ?)").run(String(records.length));
+    return db;
+}

package/build/lib/dart-client.d.ts

@@ -0,0 +1,25 @@
+/**
+ * OpenDART HTTP 클라이언트
+ *
+ * Base: https://opendart.fss.or.kr/api/
+ * 인증: 모든 요청에 `crtfc_key` 쿼리파라미터 필수
+ * 응답: JSON (대부분) / ZIP (원문·corp_code·XBRL)
+ * 요율: 일 20,000건 (키 단위 합산)
+ */
+export interface DartClientOptions {
+    apiKey: string;
+    /** 요청 타임아웃 (ms), 기본 30s */
+    timeout?: number;
+}
+export declare class DartClient {
+    private readonly apiKey;
+    private readonly timeout;
+    constructor(opts: DartClientOptions);
+    /** JSON 엔드포인트 호출 */
+    getJson<T = unknown>(path: string, params?: Record<string, string | number | undefined>): Promise<T>;
+    /** ZIP 엔드포인트 호출 (corp_code 덤프, 원문 XML, XBRL 등).
+     *  DART 는 에러 시 Content-Type 은 zip 이지만 바디는 {"status":"013",...} JSON 을 돌려준다. */
+    getZip(path: string, params?: Record<string, string | number | undefined>): Promise<Buffer>;
+    private buildUrl;
+    private fetch;
+}

package/build/lib/dart-client.js

@@ -0,0 +1,71 @@
+/**
+ * OpenDART HTTP 클라이언트
+ *
+ * Base: https://opendart.fss.or.kr/api/
+ * 인증: 모든 요청에 `crtfc_key` 쿼리파라미터 필수
+ * 응답: JSON (대부분) / ZIP (원문·corp_code·XBRL)
+ * 요율: 일 20,000건 (키 단위 합산)
+ */
+const DART_BASE_URL = "https://opendart.fss.or.kr/api";
+export class DartClient {
+    constructor(opts) {
+        this.apiKey = opts.apiKey;
+        this.timeout = opts.timeout ?? 30000;
+    }
+    /** JSON 엔드포인트 호출 */
+    async getJson(path, params = {}) {
+        const url = this.buildUrl(path, params);
+        const res = await this.fetch(url);
+        if (!res.ok) {
+            throw new Error(`DART ${path} → HTTP ${res.status}`);
+        }
+        return (await res.json());
+    }
+    /** ZIP 엔드포인트 호출 (corp_code 덤프, 원문 XML, XBRL 등).
+     *  DART 는 에러 시 Content-Type 은 zip 이지만 바디는 {"status":"013",...} JSON 을 돌려준다. */
+    async getZip(path, params = {}) {
+        const url = this.buildUrl(path, params);
+        const res = await this.fetch(url);
+        if (!res.ok) {
+            throw new Error(`DART ${path} → HTTP ${res.status}`);
+        }
+        const ab = await res.arrayBuffer();
+        const buf = Buffer.from(ab);
+        // PK\x03\x04 (zip local file header) 또는 PK\x05\x06 (empty zip) 으로 시작해야 정상
+        if (buf.length >= 2 && buf[0] === 0x50 && buf[1] === 0x4b)
+            return buf;
+        // JSON 에러 응답 감지
+        const head = buf.subarray(0, Math.min(512, buf.length)).toString("utf8");
+        if (head.trimStart().startsWith("{")) {
+            try {
+                const err = JSON.parse(head);
+                throw new Error(`DART ${path} → [${err.status ?? "?"}] ${err.message ?? head}`);
+            }
+            catch (e) {
+                if (e instanceof Error && e.message.startsWith("DART "))
+                    throw e;
+            }
+        }
+        throw new Error(`DART ${path} → 비-ZIP 응답 (${buf.length}B): ${head.slice(0, 200)}`);
+    }
+    buildUrl(path, params) {
+        const u = new URL(`${DART_BASE_URL}/${path}`);
+        u.searchParams.set("crtfc_key", this.apiKey);
+        for (const [k, v] of Object.entries(params)) {
+            if (v === undefined || v === "")
+                continue;
+            u.searchParams.set(k, String(v));
+        }
+        return u.toString();
+    }
+    async fetch(url) {
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), this.timeout);
+        try {
+            return await fetch(url, { signal: ctrl.signal });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}

package/build/lib/dart-xml.d.ts

@@ -0,0 +1,28 @@
+/**
+ * DART 원문 XML → 마크다운 변환기
+ *
+ * DART 전용 마크업(`dart4.xsd`) 은 공개 표준이 아니지만 구조가 단순해서
+ * 주요 태그만 대응해도 LLM 이 읽을 수 있는 수준의 마크다운을 만들 수 있다.
+ *
+ * 지원 태그:
+ *   DOCUMENT / BODY                       → 루트
+ *   COVER-TITLE / DOCUMENT-NAME           → # 제목
+ *   SECTION-1/2/3                         → 하위 TITLE 의 heading level 제어
+ *   TITLE                                 → ##/###/#### (상위 SECTION 깊이에 따라)
+ *   TABLE, THEAD, TBODY, TR, TH, TD, TU, TE → 표 (단순=마크다운, 병합 셀=HTML)
+ *   P                                     → 단락
+ *   PGBRK                                 → 수평선
+ *   A                                     → 인라인 텍스트 (href 없음)
+ *   IMAGE/IMG                             → 제거
+ *   SUMMARY/EXTRACTION                    → 메타 제거
+ *   COLGROUP/COL                          → 제거 (스타일 전용)
+ *   나머지 (SPAN, COMPANY-NAME 등)         → 텍스트만 유지
+ *
+ * 표 하이브리드 렌더링: 병합 셀(COLSPAN>1 또는 ROWSPAN>1)이 하나라도 있는 표는
+ * 열 의미·세로 병합 구조가 마크다운에서 깨지므로 HTML(<table>, rowspan/colspan)로
+ * 출력한다. 병합 없는 단순 표는 기존 마크다운 표 그대로 유지한다.
+ *
+ * 타입 주석: 본 프로젝트 tsconfig 에 DOM lib 이 없어 xmldom 의 Node/Element 전역이 없다.
+ *            duck-typing 으로 any 처리.
+ */
+export declare function dartXmlToMarkdown(xml: string): string;