scraper2-hj3415 2.4.1__py3-none-any.whl → 2.7.0__py3-none-any.whl

scraper2/app/composition.py

@@ -1,204 +0,0 @@
-# scraper2/app/composition.py
-from __future__ import annotations
-
-import os
-from dataclasses import dataclass
-from typing import Literal, Optional
-
-from pymongo.asynchronous.database import AsyncDatabase
-
-from scraper2.app.ports.browser.browser_factory_port import BrowserFactoryPort
-from scraper2.adapters.out.playwright.browser_factory import PlaywrightBrowserFactory
-
-from scraper2.app.usecases.fetch.fetch_c101 import FetchC101
-from scraper2.app.usecases.fetch.fetch_c103 import FetchC103
-from scraper2.app.usecases.fetch.fetch_c104 import FetchC104
-from scraper2.app.usecases.fetch.fetch_c106 import FetchC106
-from scraper2.app.usecases.fetch.fetch_c108 import FetchC108
-
-from scraper2.app.ports.ingest_port import IngestPort
-from scraper2.app.usecases.ingest.ingest_c101 import IngestC101
-from scraper2.app.usecases.ingest.ingest_c103 import IngestC103
-from scraper2.app.usecases.ingest.ingest_c104 import IngestC104
-from scraper2.app.usecases.ingest.ingest_c106 import IngestC106
-from scraper2.app.usecases.ingest.ingest_c108 import IngestC108
-
-from scraper2.adapters.out.sinks.memory.store import InMemoryStore
-from scraper2.adapters.out.sinks.memory.c101_memory_sink import MemoryC101Sink
-from scraper2.adapters.out.sinks.memory.c103_memory_sink import MemoryC103Sink
-from scraper2.adapters.out.sinks.memory.c104_memory_sink import MemoryC104Sink
-from scraper2.adapters.out.sinks.memory.c106_memory_sink import MemoryC106Sink
-from scraper2.adapters.out.sinks.memory.c108_memory_sink import MemoryC108Sink
-
-from scraper2.adapters.out.sinks.mongo.c101_mongo_sink import MongoC101Sink
-from scraper2.adapters.out.sinks.mongo.c103_mongo_sink import MongoC103Sink
-from scraper2.adapters.out.sinks.mongo.c104_mongo_sink import MongoC104Sink
-from scraper2.adapters.out.sinks.mongo.c106_mongo_sink import MongoC106Sink
-from scraper2.adapters.out.sinks.mongo.c108_mongo_sink import MongoC108Sink
-
-from scraper2.app.ports.sinks.c101_sink_port import C101SinkPort
-from scraper2.app.ports.sinks.c103_sink_port import C103SinkPort
-from scraper2.app.ports.sinks.c104_sink_port import C104SinkPort
-from scraper2.app.ports.sinks.c106_sink_port import C106SinkPort
-from scraper2.app.ports.sinks.c108_sink_port import C108SinkPort
-
-from db2.mongo import Mongo
-
-SinkKind = Literal["memory", "mongo"]
-
-
-def _env_bool(key: str, default: bool) -> bool:
-    v = os.getenv(key)
-    return default if v is None else v.strip().lower() in {"1", "true", "yes", "y", "on"}
-
-
-def _env_int(key: str, default: int) -> int:
-    v = os.getenv(key)
-    if v is None:
-        return default
-    try:
-        return int(v)
-    except ValueError:
-        return default
-
-
-def build_browser_factory() -> BrowserFactoryPort:
-    return PlaywrightBrowserFactory(
-        headless=_env_bool("SCRAPER_HEADLESS", True),
-        timeout_ms=_env_int("SCRAPER_TIMEOUT_MS", 20_000),
-        max_concurrency=_env_int("SCRAPER_MAX_CONCURRENCY", 2),
-    )
-
-
-# -------------------------
-# Bundles
-# -------------------------
-
-@dataclass(frozen=True)
-class FetchUsecases:
-    c101: FetchC101
-    c103: FetchC103
-    c104: FetchC104
-    c106: FetchC106
-    c108: FetchC108
-
-
-@dataclass(frozen=True)
-class Sinks:
-    c101: C101SinkPort
-    c103: C103SinkPort
-    c104: C104SinkPort
-    c106: C106SinkPort
-    c108: C108SinkPort
-
-
-@dataclass(frozen=True)
-class IngestUsecases:
-    c101: IngestPort
-    c103: IngestPort
-    c104: IngestPort
-    c106: IngestPort
-    c108: IngestPort
-
-
-@dataclass(frozen=True)
-class Usecases:
-    fetch: FetchUsecases
-    ingest: IngestUsecases
-    sinks: Sinks
-    store: InMemoryStore | None = None      # ✅ memory일 때만
-    mongo: Mongo | None = None              # ✅ mongo일 때만
-    db: AsyncDatabase | None = None         # ✅ mongo일 때만
-    browser_factory: Optional[BrowserFactoryPort] = None
-
-    async def aclose(self) -> None:
-        if self.browser_factory is not None:
-            await self.browser_factory.aclose()
-
-        if self.mongo is not None:
-            await self.mongo.close()
-
-# -------------------------
-# builders
-# -------------------------
-
-def build_fetch_usecases(*, factory: BrowserFactoryPort) -> FetchUsecases:
-    return FetchUsecases(
-        c101=FetchC101(factory=factory),
-        c103=FetchC103(factory=factory),
-        c104=FetchC104(factory=factory),
-        c106=FetchC106(factory=factory),
-        c108=FetchC108(factory=factory),
-    )
-
-
-@dataclass(frozen=True)
-class MemoryBundle:
-    store: InMemoryStore
-    sinks: Sinks
-
-
-def build_memory_bundle() -> MemoryBundle:
-    store = InMemoryStore()
-    sinks = Sinks(
-        c101=MemoryC101Sink(store),
-        c103=MemoryC103Sink(store),
-        c104=MemoryC104Sink(store),
-        c106=MemoryC106Sink(store),
-        c108=MemoryC108Sink(store),
-    )
-    return MemoryBundle(store=store, sinks=sinks)
-
-# ---- mongo bundle ----
-
-@dataclass(frozen=True)
-class MongoBundle:
-    mongo: Mongo
-    db: AsyncDatabase
-    sinks: Sinks
-
-
-def build_mongo_bundle() -> MongoBundle:
-    mongo = Mongo()        # settings는 db2가 env로 읽음 (DB2_MONGO_URI 등)
-    db = mongo.get_db()
-    sinks = Sinks(
-        c101=MongoC101Sink(db),
-        c103=MongoC103Sink(db),
-        c104=MongoC104Sink(db),
-        c106=MongoC106Sink(db),
-        c108=MongoC108Sink(db),
-    )
-    return MongoBundle(mongo=mongo, db=db, sinks=sinks)
-
-
-def build_ingest_usecases(*, fetch: FetchUsecases, sinks: Sinks) -> IngestUsecases:
-    return IngestUsecases(
-        c101=IngestC101(fetch=fetch.c101, sink=sinks.c101),
-        c103=IngestC103(fetch=fetch.c103, sink=sinks.c103),
-        c104=IngestC104(fetch=fetch.c104, sink=sinks.c104),
-        c106=IngestC106(fetch=fetch.c106, sink=sinks.c106),
-        c108=IngestC108(fetch=fetch.c108, sink=sinks.c108),
-    )
-
-
-def build_usecases(
-    *,
-    factory: BrowserFactoryPort | None = None,
-    sink_kind: SinkKind = "memory",
-) -> Usecases:
-    factory = factory or build_browser_factory()
-    fetch = build_fetch_usecases(factory=factory)
-
-    if sink_kind == "memory":
-        bundle = build_memory_bundle()
-        ingest = build_ingest_usecases(fetch=fetch, sinks=bundle.sinks)
-        return Usecases(fetch=fetch, ingest=ingest, sinks=bundle.sinks, store=bundle.store,
-            browser_factory=factory)
-
-    if sink_kind == "mongo":
-        bundle = build_mongo_bundle()
-        ingest = build_ingest_usecases(fetch=fetch, sinks=bundle.sinks)
-        return Usecases(fetch=fetch, ingest=ingest, sinks=bundle.sinks, mongo=bundle.mongo, db=bundle.db,
-            browser_factory=factory)
-
-    raise ValueError(f"Unknown sink_kind: {sink_kind}")

scraper2/app/parsing/_converters.py

@@ -1,85 +0,0 @@
-from __future__ import annotations
-import re
-from typing import Iterable
-
-
-_EMPTY_VALUES = {"", "-", "N/A", "NA", "null", "None"}
-
-
-def normalize(s: str | None) -> str:
-    if s is None:
-        return ""
-    return s.strip()
-
-
-def _is_empty(s: str) -> bool:
-    return s in _EMPTY_VALUES
-
-
-def to_int(s: str | None) -> int | None:
-    """
-    C101 파서용 정수 변환기
-
-    처리 규칙:
-    - None / '' / '-' / 'N/A' → None
-    - ',', '주', '원', '주식' 제거
-    - '1,234' → 1234
-    """
-    s = normalize(s)
-    if _is_empty(s):
-        return None
-
-    for ch in (",", "원", "주", "주식"):
-        s = s.replace(ch, "")
-
-    try:
-        return int(s)
-    except ValueError:
-        return None
-
-
-def to_float(s: str | None) -> float | None:
-    """
-    C101 파서용 실수 변환기
-
-    처리 규칙:
-    - None / '' / '-' / 'N/A' → None
-    - ',', '%', '원' 제거
-    - '12.34%' → 12.34
-    """
-    s = normalize(s)
-    if _is_empty(s):
-        return None
-
-    for ch in (",", "%", "원"):
-        s = s.replace(ch, "")
-
-    try:
-        return float(s)
-    except ValueError:
-        return None
-
-
-def parse_won(text: str) -> int:
-    """
-    한국 화폐 표현 문자열을 숫자로 변환 (조원, 억원, 만원, 원, 억 등 처리)
-    """
-    units = {
-        "조원": 1_000_000_000_000,
-        "억원": 100_000_000,
-        "억":   100_000_000,
-        "만원": 10_000,
-        "원": 1,
-    }
-
-    text = text.replace(",", "").strip()
-    match = re.match(r"([-+]?[0-9]*\.?[0-9]+)([가-힣]+)", text)
-
-    if not match:
-        raise ValueError(f"형식이 잘못된 금액 문자열: {text}")
-
-    number, unit = match.groups()
-    if unit not in units:
-        raise ValueError(f"알 수 없는 단위: {unit}")
-
-    return int(float(number) * units[unit])

scraper2/app/parsing/_normalize.py

@@ -1,134 +0,0 @@
-# scraper2/app/parsing/_normalize.py
-from __future__ import annotations
-
-import re
-from collections import Counter
-from typing import Any
-
-import numpy as np
-import pandas as pd
-
-
-# -----------------------------
-# 1) 항목(행의 "항목" 값) 정규화
-# -----------------------------
-_IFRS_PATTERN = re.compile(r"\(IFRS[^)]*\)")
-_ETC_PAREN_PATTERN = re.compile(r"\((E|YoY|QoQ)[^)]*\)")
-_BRACKET_PATTERN = re.compile(r"\[[^\]]*\]")  # [구K-IFRS] 등
-_EXTRA_WORDS_PATTERN = re.compile(r"(펼치기|연간컨센서스보기|연간컨센서스닫기)")
-_ALL_PAREN_PATTERN = re.compile(r"\([^)]*\)")  # ★ 모든 괄호 제거
-
-def normalize_c1034_item(text: str | None) -> str:
-    """
-    C103 항목명(행 값) 정규화
-    - 펼치기/컨센서스 제거
-    - 모든 괄호 내용 제거 (발표기준, 연결, 개별 등 포함)
-    - [구K-IFRS] 제거
-    - '*' 제거
-    - 공백 정리
-    """
-    if not text:
-        return ""
-
-    s = str(text)
-
-    # 1) 불필요한 키워드
-    s = _EXTRA_WORDS_PATTERN.sub("", s)
-
-    # 2) 대괄호 제거
-    s = _BRACKET_PATTERN.sub("", s)
-
-    # 3) 모든 괄호 제거 (중요)
-    s = _ALL_PAREN_PATTERN.sub("", s)
-
-    # 4) 별표 제거
-    s = s.replace("*", "")
-
-    # 5) 공백 정리
-    s = re.sub(r"\s+", " ", s).strip()
-
-    return s
-
-
-# -----------------------------
-# 2) 컬럼명 정규화
-# -----------------------------
-_COL_PAREN_PATTERN = re.compile(r"\((IFRS[^)]*|E|YoY|QoQ)[^)]*\)")
-_COL_EXTRA_WORDS = re.compile(r"(연간컨센서스보기|연간컨센서스닫기)")
-_COL_DOTNUM = re.compile(r"\.\d+$")  # pandas 중복 컬럼 suffix 제거용 (.1, .2 ...)
-_COL_MULTI_SPACE = re.compile(r"\s+")
-
-def normalize_c1034_col(col: str | None) -> str:
-    """
-    C103 컬럼명 정규화
-    예)
-      "2024/12 (IFRS연결)  연간컨센서스보기" -> "2024/12"
-      "2025/12(E) (IFRS연결)  연간컨센서스닫기" -> "2025/12"
-      "전년대비 (YoY)" -> "전년대비"
-      "전년대비 (YoY).1" -> "전년대비"  (중복은 후처리에서 _2/_3로 자동 분리)
-    """
-    if col is None:
-        return ""
-
-    s = str(col)
-
-    # 1) pandas가 붙인 .1 같은 suffix 제거 (정규화 충돌은 후단에서 처리)
-    s = _COL_DOTNUM.sub("", s)
-
-    # 2) 컨센서스 문구 제거
-    s = _COL_EXTRA_WORDS.sub("", s)
-
-    # 3) 괄호 주석 제거: (IFRS...), (E), (YoY), (QoQ)
-    s = _COL_PAREN_PATTERN.sub("", s)
-
-    # 4) 공백 정리
-    s = _COL_MULTI_SPACE.sub(" ", s).strip()
-
-    return s
-
-
-def _dedupe_columns(cols: list[str]) -> list[str]:
-    """
-    정규화 후 중복 컬럼명이 생기면 자동으로 _2, _3 ... 붙여서 유니크하게 만든다.
-    예) ["전년대비", "전년대비"] -> ["전년대비", "전년대비_2"]
-    """
-    seen: Counter[str] = Counter()
-    out: list[str] = []
-    for c in cols:
-        c = c or ""
-        seen[c] += 1
-        if seen[c] == 1:
-            out.append(c)
-        else:
-            out.append(f"{c}_{seen[c]}")
-    return out
-
-
-# -----------------------------
-# 3) DataFrame 전체 정규화 + records 변환
-# -----------------------------
-def normalize_c1034_df(df: pd.DataFrame) -> pd.DataFrame:
-    """
-    - 컬럼명 전체 정규화
-    - '항목' 값 정규화
-    - NaN -> None
-    - 중복 컬럼명 자동 분리(_2/_3)
-    """
-    if df is None or df.empty:
-        return df
-
-    df = df.copy()
-
-    # 컬럼명 정규화 + 중복 방지
-    norm_cols = [normalize_c1034_col(c) for c in df.columns.astype(str).tolist()]
-    df.columns = _dedupe_columns(norm_cols)
-
-    # 항목 값 정규화
-    if "항목" in df.columns:
-        df["항목"] = df["항목"].map(normalize_c1034_item)
-
-    # NaN -> None
-    df = df.replace({np.nan: None})
-    return df
-
-

scraper2/app/parsing/c101_parser.py

@@ -1,143 +0,0 @@
-# scraper2/app/parsing/c101_parser.py
-from __future__ import annotations
-
-from scraper2.app.parsing._converters import to_int, to_float, normalize, parse_won
-from scraper2.app.ports.browser.browser_port import BrowserPort
-from typing import Any
-
-
-class C101ParseError(RuntimeError):
-    pass
-
-
-def _after_colon(s: str) -> str:
-    # "업종: XXX" 같은 케이스
-    parts = s.split(":")
-    return parts[1].strip() if len(parts) > 1 else s.strip()
-
-
-async def parse_c101_to_dict(browser: BrowserPort) -> dict[str, Any] | None:
-    """
-    - BrowserPort만 사용
-    - dict만 반환
-    - 실패 시 None (기존 동작 유지)
-    """
-
-    # 날짜 파싱: 텍스트 검색 기반
-    raw_date_str = await browser.text_first_by_text("[기준:")
-    if not raw_date_str:
-        return None
-    날짜 = raw_date_str.replace("[기준:", "").replace("]", "").strip()
-
-    # 1) 재무정보 (1st table)
-    # 여기선 "tbody 존재"만 기다리면 됨
-    await browser.wait("#pArea > div.wrapper-table > div > table > tbody")
-
-    종목명 = normalize(await browser.text(
-        "#pArea > div.wrapper-table > div > table > tbody "
-        "tr:nth-child(1) > td > dl > dt:nth-child(1) > span"
-    ))
-    코드 = normalize(await browser.text(
-        "#pArea > div.wrapper-table > div > table > tbody "
-        "tr:nth-child(1) > td > dl > dt:nth-child(1) > b"
-    ))
-    업종_raw = await browser.text(
-        "#pArea > div.wrapper-table > div > table > tbody "
-        "tr:nth-child(1) > td > dl > dt:nth-child(4)"
-    )
-    업종 = _after_colon(업종_raw)
-
-    eps = to_int(await browser.text(
-        "#pArea > div.wrapper-table > div > table > tbody "
-        "tr:nth-child(3) > td > dl > dt:nth-child(1) > b"
-    ))
-    bps = to_int(await browser.text(
-        "#pArea > div.wrapper-table > div > table > tbody "
-        "tr:nth-child(3) > td > dl > dt:nth-child(2) > b"
-    ))
-    per = to_float(await browser.text(
-        "#pArea > div.wrapper-table > div > table > tbody "
-        "tr:nth-child(3) > td > dl > dt:nth-child(3) > b"
-    ))
-    업종per = to_float(await browser.text(
-        "#pArea > div.wrapper-table > div > table > tbody "
-        "tr:nth-child(3) > td > dl > dt:nth-child(4) > b"
-    ))
-    pbr = to_float(await browser.text(
-        "#pArea > div.wrapper-table > div > table > tbody "
-        "tr:nth-child(3) > td > dl > dt:nth-child(5) > b"
-    ))
-    배당수익률 = to_float(await browser.text(
-        "#pArea > div.wrapper-table > div > table > tbody "
-        "tr:nth-child(3) > td > dl > dt:nth-child(6) > b"
-    ))
-
-    # 2) 주가 정보 (2nd table)
-    await browser.wait("#cTB11 > tbody")
-
-    주가 = to_int(await browser.text("#cTB11 > tbody tr:nth-child(1) > td > strong"))
-
-    전일대비_raw = await browser.text("#cTB11 > tbody tr:nth-child(1) > td > span:nth-child(2)")
-    전일대비 = to_int(전일대비_raw.replace("원", ""))
-
-    수익률_raw = await browser.text("#cTB11 > tbody tr:nth-child(1) > td > span:nth-child(3)")
-    수익률 = to_float(수익률_raw.replace("%", ""))
-
-    최고최저52 = await browser.text("#cTB11 > tbody tr:nth-child(2) > td")
-    최고52, 최저52 = (to_int(x.strip().replace("원", "")) for x in 최고최저52.split("/"))
-
-    거래량거래대금 = await browser.text("#cTB11 > tbody tr:nth-child(4) > td")
-    거래량_str, 거래대금_str = (x.strip() for x in 거래량거래대금.split("/"))
-    거래량 = to_int(거래량_str.replace("주", ""))
-    거래대금 = parse_won(거래대금_str)
-
-    시가총액 = parse_won(await browser.text("#cTB11 > tbody tr:nth-child(5) > td"))
-    베타52주 = to_float(await browser.text("#cTB11 > tbody tr:nth-child(6) > td"))
-
-    발행주식유동비율 = await browser.text("#cTB11 > tbody tr:nth-child(7) > td")
-    발행주식_str, 유동비율_str = (x.strip() for x in 발행주식유동비율.split("/"))
-    발행주식 = to_int(발행주식_str.replace("주", ""))
-    유동비율 = to_float(유동비율_str.replace("%", ""))
-
-    외국인지분율 = to_float((await browser.text("#cTB11 > tbody tr:nth-child(8) > td")).replace("%", ""))
-
-    수익률1M3M6M1Y = await browser.text("#cTB11 > tbody tr:nth-child(9) > td")
-    수익률1M, 수익률3M, 수익률6M, 수익률1Y = (
-        to_float(x.strip().replace("%", "")) for x in 수익률1M3M6M1Y.split("/")
-    )
-
-    # 3) 개요
-    # ul 아래 li들을 전부 읽어서 합치기
-    await browser.wait("#wrapper > div:nth-child(6) > div.cmp_comment > ul")
-    li_texts = await browser.texts("#wrapper > div:nth-child(6) > div.cmp_comment > ul li")
-    개요 = "".join(t.strip() for t in li_texts if t and t.strip())
-
-    return {
-        "종목명": 종목명,
-        "코드": 코드,
-        "날짜": 날짜,
-        "업종": 업종,
-        "eps": eps,
-        "bps": bps,
-        "per": per,
-        "업종per": 업종per,
-        "pbr": pbr,
-        "배당수익률": 배당수익률,
-        "주가": 주가,
-        "전일대비": 전일대비,
-        "수익률": 수익률,
-        "최고52": 최고52,
-        "최저52": 최저52,
-        "거래량": 거래량,
-        "거래대금": 거래대금,
-        "시가총액": 시가총액,
-        "베타52주": 베타52주,
-        "발행주식": 발행주식,
-        "유동비율": 유동비율,
-        "외국인지분율": 외국인지분율,
-        "수익률1M": 수익률1M,
-        "수익률3M": 수익률3M,
-        "수익률6M": 수익률6M,
-        "수익률1Y": 수익률1Y,
-        "개요": 개요,
-    }

scraper2/app/parsing/c103_parser.py

@@ -1,128 +0,0 @@
-# scraper2/app/parsing/c103_parser.py
-from __future__ import annotations
-
-import asyncio
-from io import StringIO
-from typing import Any
-
-import pandas as pd
-
-from scraper2.app.ports.browser.browser_port import BrowserPort
-from scraper2.app.parsing._normalize import normalize_c1034_df
-
-# ---- constants ----
-
-TABLE_XPATH = "xpath=//div[@id='wrapper']//div//table"   # 기존 selector 의도 유지
-TABLE_INDEX = 2  # 너 코드의 nth(2)
-
-
-BTN_SETS: dict[str, list[tuple[str, str]]] = {
-    "손익계산서y": [
-        ("손익계산서", 'xpath=//*[@id="rpt_tab1"]'),
-        ("연간", 'xpath=//*[@id="frqTyp0"]'),
-        ("검색", 'xpath=//*[@id="hfinGubun"]'),
-    ],
-    "재무상태표y": [
-        ("재무상태표", 'xpath=//*[@id="rpt_tab2"]'),
-        ("연간", 'xpath=//*[@id="frqTyp0"]'),
-        ("검색", 'xpath=//*[@id="hfinGubun"]'),
-    ],
-    "현금흐름표y": [
-        ("현금흐름표", 'xpath=//*[@id="rpt_tab3"]'),
-        ("연간", 'xpath=//*[@id="frqTyp0"]'),
-        ("검색", 'xpath=//*[@id="hfinGubun"]'),
-    ],
-    "손익계산서q": [
-        ("손익계산서", 'xpath=//*[@id="rpt_tab1"]'),
-        ("분기", 'xpath=//*[@id="frqTyp1"]'),
-        ("검색", 'xpath=//*[@id="hfinGubun"]'),
-    ],
-    "재무상태표q": [
-        ("재무상태표", 'xpath=//*[@id="rpt_tab2"]'),
-        ("분기", 'xpath=//*[@id="frqTyp1"]'),
-        ("검색", 'xpath=//*[@id="hfinGubun"]'),
-    ],
-    "현금흐름표q": [
-        ("현금흐름표", 'xpath=//*[@id="rpt_tab3"]'),
-        ("분기", 'xpath=//*[@id="frqTyp1"]'),
-        ("검색", 'xpath=//*[@id="hfinGubun"]'),
-    ],
-}
-
-
-# ---- small helpers ----
-
-async def _click_steps(
-    browser: BrowserPort,
-    steps: list[tuple[str, str]],
-    *,
-    jitter_sec: float = 0.6,
-) -> None:
-    """
-    (goto 없음) 현재 페이지에서 탭/라디오/검색 버튼 클릭만 수행.
-    """
-    for _name, selector in steps:
-        await browser.wait(selector)
-        await browser.click(selector)
-        # 서버/클라이언트 부담 줄이기: 작은 지터
-        await asyncio.sleep(0.2 + (jitter_sec * 0.5))
-
-
-def _html_table_to_df(html: str) -> pd.DataFrame:
-    """
-    table outerHTML -> DataFrame
-    """
-    dfs = pd.read_html(StringIO(html), header=0)
-    if not dfs:
-        raise ValueError("pd.read_html() 테이블 파싱 실패")
-    return dfs[0]
-
-
-async def _nth_table_outer_html(browser: BrowserPort, nth: int) -> str:
-    return await browser.outer_html_nth(TABLE_XPATH, nth)
-
-def df_to_c103_records(df: pd.DataFrame) -> list[dict[str, Any]]:
-    """
-    C103 테이블 DataFrame -> 정규화된 records(list[dict])
-    - 항목이 비면 제거
-    """
-    df = normalize_c1034_df(df)
-    if df is None or df.empty:
-        return []
-
-    records: list[dict[str, Any]] = []
-    for r in df.to_dict(orient="records"):
-        item = r.get("항목")
-        if not item:
-            continue
-        records.append(r)
-    return records
-
-# ---- public parser ----
-
-async def parse_c103_to_dict(browser: BrowserPort) -> dict[str, list[dict[str, Any]]]:
-    """
-    C103 파서: dict만 반환
-    {
-      "손익계산서y": [ {...}, ... ],
-      "손익계산서q": [ {...}, ... ],
-      ...
-    }
-    """
-    out: dict[str, list[dict[str, Any]]] = {}
-
-    for key, steps in BTN_SETS.items():
-        # 클릭 → 테이블 로딩 → nth table outerHTML → df → records
-        await _click_steps(browser, steps)
-        await browser.wait(TABLE_XPATH)
-
-        try:
-            html = await _nth_table_outer_html(browser, TABLE_INDEX)
-            df = _html_table_to_df(html)
-            out[key] = df_to_c103_records(df)
-        except Exception:
-            out[key] = []  # 실패는 빈 리스트
-
-    return out
-
-