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

scraper2_hj3415/app/ports/browser/capabilities/text.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+
+from typing import Protocol
+
+
+class BrowserTextPort(Protocol):
+    """DOM 조회/텍스트 추출"""
+
+    async def count(self, selector: str) -> int: ...
+
+    async def text_content_first(self, selector: str) -> str: ...
+    async def all_texts(self, selector: str) -> list[str]: ...
+    async def get_text_by_text(self, needle: str) -> str: ...
+
+    async def inner_text(self, selector: str) -> str: ...
+    async def outer_html_nth(self, selector: str, index: int) -> str: ...

scraper2_hj3415/app/ports/browser/capabilities/wait.py

@@ -0,0 +1,51 @@
+from __future__ import annotations
+
+import asyncio
+from typing import Protocol
+
+
+class BrowserWaitPort(Protocol):
+    """대기/동기화 유틸"""
+
+    async def sleep_ms(self, ms: int) -> None:
+        """
+        ms에 1000을 넣으면 1초 쉼.
+        구현체가 없을 때를 대비해 기본 구현 제공.
+        """
+        await asyncio.sleep(ms / 1000)
+
+    async def wait_attached(
+        self,
+        selector: str,
+        *,
+        timeout_ms: int = 10_000,
+    ) -> None: ...
+
+    async def wait_visible(
+        self,
+        selector: str,
+        *,
+        timeout_ms: int = 10_000,
+    ) -> None: ...
+
+    async def wait_table_nth_ready(
+        self,
+        table_selector: str,
+        *,
+        index: int,
+        min_rows: int = 1,
+        timeout_ms: int = 20_000,
+        poll_ms: int = 200,
+    ) -> None: ...
+
+    async def wait_table_text_changed(
+        self,
+        table_selector: str,
+        *,
+        index: int,
+        prev_text: str | None,
+        min_rows: int = 1,
+        min_lines: int = 50,
+        timeout_sec: float = 12.0,
+        poll_sec: float = 0.2,
+    ) -> str: ...

scraper2_hj3415/app/ports/ingest/nfs_ingest_port.py

@@ -0,0 +1,28 @@
+# scraper2_hj3415/app/ports/ingest/nfs_ingest_port.py
+from __future__ import annotations
+from typing import Protocol, Iterable, Optional, TypeVar
+from datetime import datetime
+
+from contracts_hj3415.nfs.nfs_dto import NfsDTO
+
+TDto = TypeVar("TDto", bound=NfsDTO)
+
+
+class NfsIngestPort(Protocol[TDto]):
+    async def execute(
+        self,
+        code: str,
+        *,
+        sleep_sec: float = ...,
+        asof: Optional[datetime] = None,
+    ) -> TDto:
+        ...
+
+    async def execute_many(
+        self,
+        codes: Iterable[str],
+        *,
+        sleep_sec: float = ...,
+        asof: Optional[datetime] = None,
+    ) -> list[TDto]:
+        ...

scraper2_hj3415/app/ports/sinks/nfs_sink_port.py

@@ -0,0 +1,20 @@
+# scraper2_hj3415/app/ports/sinks/nfs_sink_port.py
+from __future__ import annotations
+
+from typing import Protocol, Iterable, TypeVar
+from contracts_hj3415.nfs.types import Endpoint
+from contracts_hj3415.nfs.nfs_dto import NfsDTO
+
+TDto = TypeVar("TDto", bound=NfsDTO)
+
+class NfsSinkPort(Protocol[TDto]):
+    async def write(
+        self, dto: TDto, *, endpoint: Endpoint
+    ) -> None: ...
+
+    async def write_many(
+        self,
+        dtos: Iterable[TDto],
+        *,
+        endpoint: Endpoint
+    ) -> None: ...

scraper2_hj3415/app/ports/site/wisereport_port.py

@@ -0,0 +1,30 @@
+# scraper2_hj3415/app/ports/site/wisereport_port.py
+from __future__ import annotations
+from typing import Protocol
+
+class WiseReportPort(Protocol):
+    async def set_view_c103(
+        self,
+        *,
+        key: str,
+        steps: list[tuple[str, str]],
+        table_selector: str,
+        table_index: int,
+        max_attempts: int = 5,
+        stabilize_timeout_sec: float = 10.0,
+    ) -> None: ...
+
+    async def set_view_c104(
+            self,
+            *,
+            key: str,
+            steps: list[tuple[str, str]],
+            table_selector: str,
+            table_index: int,
+            prev_text_by_idx: dict[int, str | None],
+            max_attempts: int = 5,
+            stabilize_timeout_sec: float = 10.0,
+            min_rows: int = 5,
+            min_lines: int = 30,
+            open_consensus: bool = True,
+    ) -> None: ...

scraper2_hj3415/app/services/fetch/fetch_c101.py

@@ -0,0 +1,59 @@
+# scraper2_hj3415/app/usecases/fetch/fetch_c101.py
+from __future__ import annotations
+
+import asyncio
+import random
+from typing import Iterable
+
+from logging_hj3415 import logger
+from scraper2_hj3415.app.ports.browser.browser_factory_port import BrowserFactoryPort
+from scraper2_hj3415.app.parsing.c101_parser import parse_c101_to_dict
+
+from scraper2_hj3415.app.services.nfs_doc_builders import build_c101_doc_from_parsed
+from scraper2_hj3415.app.domain.endpoint import EndpointKind
+from scraper2_hj3415.app.domain.doc import NfsDoc
+from scraper2_hj3415.app.domain.blocks import BLOCK_KEYS_BY_ENDPOINT
+
+
+class FetchC101:
+    def __init__(self, factory: BrowserFactoryPort):
+        self.factory = factory
+
+    async def _fetch_one(self, code: str, *, sleep_sec: float) -> NfsDoc | None:
+        async with self.factory.lease() as browser:
+            url = f"https://navercomp.wisereport.co.kr/v2/company/c1010001.aspx?cmp_cd={code}"
+            await browser.goto_and_wait_for_stable(url, timeout_ms=10_000)
+
+            if sleep_sec > 0:
+                await asyncio.sleep(sleep_sec + random.uniform(0, 1.0))
+
+            parsed = await parse_c101_to_dict(browser)
+
+            logger.debug(f"parsed data: {parsed}")
+            block_keys = BLOCK_KEYS_BY_ENDPOINT[EndpointKind.C101]
+            if not parsed or all(not (parsed.get(str(bk)) or []) for bk in block_keys):
+                logger.warning(
+                    f"c101 fetch: parsed result empty; return None | code={code}"
+                )
+                return None
+
+            doc = build_c101_doc_from_parsed(
+                code=code, parsed=parsed, keep_empty_blocks=True
+            )
+            logger.debug(f"c101 doc: {doc}")
+            return doc
+
+    async def execute(self, code: str, *, sleep_sec: float = 2.0) -> NfsDoc | None:
+        return await self._fetch_one(code, sleep_sec=sleep_sec)
+
+    async def execute_many(
+        self,
+        codes: Iterable[str],
+        *,
+        sleep_sec: float = 2.0,
+    ) -> list[NfsDoc]:
+        results = await asyncio.gather(
+            *(self._fetch_one(c, sleep_sec=sleep_sec) for c in codes),
+            return_exceptions=False,
+        )
+        return [r for r in results if r is not None]

scraper2_hj3415/app/services/fetch/fetch_c103.py

@@ -0,0 +1,121 @@
+# scraper2_hj3415/app/usecases/fetch/fetch_c103.py
+from __future__ import annotations
+
+import asyncio
+import random
+from typing import Iterable, Any
+
+from logging_hj3415 import logger
+from scraper2_hj3415.app.ports.browser.browser_factory_port import BrowserFactoryPort
+from scraper2_hj3415.app.ports.site.wisereport_port import WiseReportPort
+from scraper2_hj3415.app.adapters.site.wisereport_playwright import WiseReportPlaywright
+
+from scraper2_hj3415.app.parsing.c103_parser import parse_c103_current_table, TABLE_XPATH
+from scraper2_hj3415.app.services.nfs_doc_builders import build_metrics_doc_from_parsed
+
+from scraper2_hj3415.app.domain.endpoint import EndpointKind
+from scraper2_hj3415.app.domain.blocks import BLOCK_KEYS_BY_ENDPOINT
+from scraper2_hj3415.app.domain.doc import NfsDoc
+
+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"]'),
+    ],
+}
+
+TABLE_INDEX = 2
+
+
+class FetchC103:
+    def __init__(self, factory: BrowserFactoryPort):
+        self.factory = factory
+
+    async def _fetch_one(self, code: str, *, sleep_sec: float) -> NfsDoc | None:
+        async with self.factory.lease() as browser:
+            wr: WiseReportPort = WiseReportPlaywright(browser)
+
+            url = (
+                "https://navercomp.wisereport.co.kr/v2/company/c1030001.aspx"
+                f"?cn=&cmp_cd={code}"
+            )
+            await browser.goto_and_wait_for_stable(url, timeout_ms=10_000)
+
+            if sleep_sec > 0:
+                await asyncio.sleep(sleep_sec + random.uniform(0, 1.0))
+
+            parsed: dict[str, list[dict[str, Any]]] = {}
+
+            for key, steps in BTN_SETS.items():
+                try:
+                    # 1) 상태 확정 (분기/연간이 맞는지 헤더로 검증)
+                    await wr.set_view_c103(
+                        key=key,
+                        steps=steps,
+                        table_selector=TABLE_XPATH,
+                        table_index=TABLE_INDEX,
+                    )
+
+                    # 2) 파싱은 “현재 화면 테이블”만
+                    parsed[key] = await parse_c103_current_table(browser)
+
+                except Exception as e:
+                    logger.warning(
+                        f"c103 view/parse failed: key={key} err={type(e).__name__}: {e}"
+                    )
+                    parsed[key] = []
+
+            block_keys = BLOCK_KEYS_BY_ENDPOINT[EndpointKind.C103]
+            if not parsed or all(not (parsed.get(str(bk)) or []) for bk in block_keys):
+                logger.warning(
+                    f"c103 fetch: parsed result empty; return None | code={code}"
+                )
+                return None
+
+            doc = build_metrics_doc_from_parsed(
+                code=code,
+                endpoint_kind=EndpointKind.C103,
+                parsed=parsed,
+                block_keys=block_keys,
+                item_key="항목",
+                raw_label_key="항목_raw",
+                keep_empty_blocks=True,
+            )
+            return doc
+
+    async def execute(self, code: str, *, sleep_sec: float = 2.0) -> NfsDoc | None:
+        return await self._fetch_one(code, sleep_sec=sleep_sec)
+
+    async def execute_many(
+        self, codes: Iterable[str], *, sleep_sec: float = 2.0
+    ) -> list[NfsDoc]:
+        results = await asyncio.gather(
+            *(self._fetch_one(c, sleep_sec=sleep_sec) for c in codes)
+        )
+        return [r for r in results if r is not None]

scraper2_hj3415/app/services/fetch/fetch_c104.py

@@ -0,0 +1,160 @@
+# scraper2_hj3415/app/usecases/fetch/fetch_c104.py
+from __future__ import annotations
+
+import asyncio
+import random
+from typing import Any, Iterable
+
+from logging_hj3415 import logger
+from scraper2_hj3415.app.ports.browser.browser_factory_port import BrowserFactoryPort
+from scraper2_hj3415.app.ports.site.wisereport_port import WiseReportPort
+from scraper2_hj3415.app.adapters.site.wisereport_playwright import WiseReportPlaywright
+
+from scraper2_hj3415.app.parsing.c104_parser import parse_c104_current_table, TABLE_XPATH
+from scraper2_hj3415.app.services.nfs_doc_builders import build_metrics_doc_from_parsed
+
+from scraper2_hj3415.app.domain.endpoint import EndpointKind
+from scraper2_hj3415.app.domain.blocks import BLOCK_KEYS_BY_ENDPOINT
+from scraper2_hj3415.app.domain.doc import NfsDoc
+
+BTN_SETS: dict[str, list[tuple[str, str]]] = {
+    "수익성y": [
+        ("수익성", 'xpath=//*[ @id="val_tab1"]'),
+        ("연간", 'xpath=//*[@id="frqTyp0"]'),
+        ("검색", 'xpath=//*[@id="hfinGubun"]'),
+    ],
+    "성장성y": [
+        ("성장성", 'xpath=//*[ @id="val_tab2"]'),
+        ("연간", 'xpath=//*[@id="frqTyp0"]'),
+        ("검색", 'xpath=//*[@id="hfinGubun"]'),
+    ],
+    "안정성y": [
+        ("안정성", 'xpath=//*[ @id="val_tab3"]'),
+        ("연간", 'xpath=//*[@id="frqTyp0"]'),
+        ("검색", 'xpath=//*[@id="hfinGubun"]'),
+    ],
+    "활동성y": [
+        ("활동성", 'xpath=//*[ @id="val_tab4"]'),
+        ("연간", 'xpath=//*[@id="frqTyp0"]'),
+        ("검색", 'xpath=//*[@id="hfinGubun"]'),
+    ],
+    "가치분석y": [
+        ("가치분석연간", 'xpath=//*[@id="frqTyp0_2"]'),
+        ("가치분석검색", 'xpath=//*[@id="hfinGubun2"]'),
+    ],
+    "수익성q": [
+        ("수익성", 'xpath=//*[ @id="val_tab1"]'),
+        ("분기", 'xpath=//*[@id="frqTyp1"]'),
+        ("검색", 'xpath=//*[@id="hfinGubun"]'),
+    ],
+    "성장성q": [
+        ("성장성", 'xpath=//*[ @id="val_tab2"]'),
+        ("분기", 'xpath=//*[@id="frqTyp1"]'),
+        ("검색", 'xpath=//*[@id="hfinGubun"]'),
+    ],
+    "안정성q": [
+        ("안정성", 'xpath=//*[ @id="val_tab3"]'),
+        ("분기", 'xpath=//*[@id="frqTyp1"]'),
+        ("검색", 'xpath=//*[@id="hfinGubun"]'),
+    ],
+    "활동성q": [
+        ("활동성", 'xpath=//*[ @id="val_tab4"]'),
+        ("분기", 'xpath=//*[@id="frqTyp1"]'),
+        ("검색", 'xpath=//*[@id="hfinGubun"]'),
+    ],
+    "가치분석q": [
+        ("가치분석분기", 'xpath=//*[@id="frqTyp1_2"]'),
+        ("가치분석검색", 'xpath=//*[@id="hfinGubun2"]'),
+    ],
+}
+
+
+def _table_index_for_key(key: str) -> int:
+    # 가치분석은 별도 테이블(보통 index=1)
+    return 1 if key.startswith("가치분석") else 0
+
+
+class FetchC104:
+    def __init__(self, factory: BrowserFactoryPort):
+        self.factory = factory
+
+    async def _fetch_one(self, code: str, *, sleep_sec: float) -> NfsDoc | None:
+        async with self.factory.lease() as browser:
+            wr: WiseReportPort = WiseReportPlaywright(browser)
+
+            url = (
+                "https://navercomp.wisereport.co.kr/v2/company/c1040001.aspx"
+                f"?cn=&cmp_cd={code}"
+            )
+            await browser.goto_and_wait_for_stable(url, timeout_ms=10_000)
+
+            if sleep_sec > 0:
+                await asyncio.sleep(sleep_sec + random.uniform(0, 1.0))
+
+            parsed: dict[str, list[dict[str, Any]]] = {}
+
+            # idx별 안정화 상태 추적
+            prev_text_by_idx: dict[int, str | None] = {0: None, 1: None}
+
+            for key, steps in BTN_SETS.items():
+                idx = _table_index_for_key(key)
+
+                try:
+                    # 1) 상태 확정 (분기/연간이 맞는지 헤더로 검증)
+                    await wr.set_view_c104(
+                        key=key,
+                        steps=steps,
+                        table_selector=TABLE_XPATH,
+                        table_index=idx,
+                        prev_text_by_idx=prev_text_by_idx,
+                        max_attempts=5,
+                        stabilize_timeout_sec=10.0,
+                        min_rows=5,
+                        min_lines=30,
+                        open_consensus=True,
+                    )
+
+                    # 2) 파싱은 “현재 화면의 idx 테이블 1개”만
+                    parsed[key] = await parse_c104_current_table(
+                        browser,
+                        table_index=idx,
+                    )
+
+                except Exception as e:
+                    logger.warning(
+                        f"c104 view/parse failed: key={key} idx={idx} err={type(e).__name__}: {e}"
+                    )
+                    parsed[key] = []
+
+            block_keys = BLOCK_KEYS_BY_ENDPOINT[EndpointKind.C104]
+            if not parsed or all(not (parsed.get(str(bk)) or []) for bk in block_keys):
+                logger.warning(
+                    f"c104 fetch: parsed result empty; return None | code={code}"
+                )
+                return None
+
+            doc = build_metrics_doc_from_parsed(
+                code=code,
+                endpoint_kind=EndpointKind.C104,
+                parsed=parsed,
+                block_keys=block_keys,
+                item_key="항목",
+                raw_label_key="항목_raw",
+                keep_empty_blocks=True,
+            )
+            return doc
+
+    async def execute(self, code: str, *, sleep_sec: float = 2.0) -> NfsDoc | None:
+        return await self._fetch_one(code, sleep_sec=sleep_sec)
+
+    async def execute_many(
+        self,
+        codes: Iterable[str],
+        *,
+        sleep_sec: float = 2.0,
+    ) -> list[NfsDoc]:
+        results = await asyncio.gather(
+            *(self._fetch_one(c, sleep_sec=sleep_sec) for c in codes),
+            return_exceptions=False,
+        )
+        return [r for r in results if r is not None]

scraper2_hj3415/app/services/fetch/fetch_c106.py

@@ -0,0 +1,90 @@
+# scraper2_hj3415/app/usecases/fetch/fetch_c106.py
+from __future__ import annotations
+
+import asyncio
+import random
+from typing import Iterable, Any
+
+from logging_hj3415 import logger
+from scraper2_hj3415.app.ports.browser.browser_factory_port import BrowserFactoryPort
+from scraper2_hj3415.app.parsing.c106_parser import (
+    parse_c106_header_codes,
+    parse_c106_current_table,
+)
+from scraper2_hj3415.app.services.nfs_doc_builders import build_metrics_doc_from_parsed
+from scraper2_hj3415.app.domain.endpoint import EndpointKind
+from scraper2_hj3415.app.domain.doc import NfsDoc
+from scraper2_hj3415.app.domain.blocks import BLOCK_KEYS_BY_ENDPOINT
+
+
+class FetchC106:
+    def __init__(self, factory: BrowserFactoryPort):
+        self.factory = factory
+
+    async def _fetch_one(self, code: str, *, sleep_sec: float) -> NfsDoc | None:
+        async with self.factory.lease() as browser:
+            # 1) 헤더 코드 추출용(기준 페이지)
+            url0 = (
+                "https://navercomp.wisereport.co.kr/v2/company/c1060001.aspx"
+                f"?cn=&cmp_cd={code}"
+            )
+            await browser.goto_and_wait_for_stable(url0, timeout_ms=10_000)
+
+            if sleep_sec > 0:
+                await asyncio.sleep(sleep_sec + random.uniform(0, 1.0))
+
+            header_codes = await parse_c106_header_codes(browser)
+            if not header_codes:
+                logger.warning(f"c106 fetch: header codes empty; code={code}")
+                return None
+
+            base_url = (
+                "https://navercomp.wisereport.co.kr/v2/company/cF6002.aspx"
+                f"?cmp_cd={code}&finGubun=MAIN&sec_cd=FG000&frq="
+            )
+
+            parsed: dict[str, list[dict[str, Any]]] = {}
+
+            for frq in ("q", "y"):
+                url = base_url + frq
+                await browser.goto_and_wait_for_stable(url, timeout_ms=10_000)
+
+                # 기존 지터 유지(필요하면 정책화)
+                await asyncio.sleep(0.5 + random.uniform(0, 0.3))
+
+                parsed[frq] = await parse_c106_current_table(
+                    browser,
+                    columns=header_codes,
+                    table_selector="#cTB611",
+                    table_index=0,
+                    timeout_ms=10_000,
+                )
+
+            logger.debug(f"parsed:\n{parsed}")
+
+            block_keys = BLOCK_KEYS_BY_ENDPOINT[EndpointKind.C106]
+            if not parsed or all(not (parsed.get(str(bk)) or []) for bk in block_keys):
+                logger.warning(f"c106 fetch: parsed result empty; return None | code={code}")
+                return None
+
+            doc = build_metrics_doc_from_parsed(
+                code=code,
+                endpoint_kind=EndpointKind.C106,
+                parsed=parsed,
+                block_keys=block_keys,
+                item_key="항목",
+                raw_label_key="항목_raw",
+                keep_empty_blocks=True,
+            )
+            logger.debug(f"c106 doc: {doc}")
+            return doc
+
+    async def execute(self, code: str, *, sleep_sec: float = 2.0) -> NfsDoc | None:
+        return await self._fetch_one(code, sleep_sec=sleep_sec)
+
+    async def execute_many(self, codes: Iterable[str], *, sleep_sec: float = 2.0) -> list[NfsDoc]:
+        results = await asyncio.gather(
+            *(self._fetch_one(c, sleep_sec=sleep_sec) for c in codes),
+            return_exceptions=False,
+        )
+        return [r for r in results if r is not None]

scraper2_hj3415/app/services/fetch/fetch_c108.py

@@ -0,0 +1,59 @@
+# scraper2_hj3415/app/usecases/fetch/fetch_c108.py
+from __future__ import annotations
+
+import asyncio
+import random
+from typing import Iterable
+
+from logging_hj3415 import logger
+from scraper2_hj3415.app.ports.browser.browser_factory_port import BrowserFactoryPort
+from scraper2_hj3415.app.parsing.c108_parser import parse_c108_to_dict
+from scraper2_hj3415.app.services.nfs_doc_builders import build_c108_doc_from_parsed
+
+from scraper2_hj3415.app.domain.endpoint import EndpointKind
+from scraper2_hj3415.app.domain.doc import NfsDoc
+from scraper2_hj3415.app.domain.blocks import BLOCK_KEYS_BY_ENDPOINT
+
+
+class FetchC108:
+    def __init__(self, factory: BrowserFactoryPort):
+        self.factory = factory
+
+    async def _fetch_one(self, code: str, *, sleep_sec: float) -> NfsDoc | None:
+        async with self.factory.lease() as browser:
+            url = f"https://navercomp.wisereport.co.kr/v2/company/c1080001.aspx?cn=&cmp_cd={code}"
+            await browser.goto_and_wait_for_stable(url, timeout_ms=10_000)
+
+            if sleep_sec > 0:
+                await asyncio.sleep(sleep_sec + random.uniform(0, 1.0))
+
+            parsed = await parse_c108_to_dict(browser=browser)
+
+            logger.debug(f"parsed:\n{parsed}")
+            block_keys = BLOCK_KEYS_BY_ENDPOINT[EndpointKind.C108]
+            if not parsed or all(not (parsed.get(str(bk)) or []) for bk in block_keys):
+                logger.warning(
+                    f"c108 fetch: parsed result empty; return None | code={code}"
+                )
+                return None
+
+            doc = build_c108_doc_from_parsed(
+                code=code, parsed=parsed, keep_empty_blocks=True
+            )
+            logger.debug(f"c108 doc: {doc}")
+            return doc
+
+    async def execute(self, code: str, *, sleep_sec: float = 2.0) -> NfsDoc | None:
+        return await self._fetch_one(code, sleep_sec=sleep_sec)
+
+    async def execute_many(
+        self,
+        codes: Iterable[str],
+        *,
+        sleep_sec: float = 2.0,
+    ) -> list[NfsDoc]:
+        results = await asyncio.gather(
+            *(self._fetch_one(c, sleep_sec=sleep_sec) for c in codes),
+            return_exceptions=False,
+        )
+        return [r for r in results if r is not None]