enabiz-mcp: Skill for Claude Code

Yeni parser ekle

parsers.py saf HTML→Pydantic model katmanıdır (yan etkisiz). Kırmızı çizgi: sessizce yanlış eşlenmiş kayıt, boş sonuçtan kötüdür — emin değilsen [] dön.

Standart tablo iskeleti

parse_insurance (parsers.py:1119-1139) kanonik örnek:

def parse_<domain>(html: str) -> list[<Model>]:
    soup = BeautifulSoup(html, "html.parser")
    table = soup.select_one("#tbl<Xxx>")        # SADECE tam id — `or` YOK
    out: list[<Model>] = []
    if table is None:
        return out                               # eksik id → boş; tahmin yok
    for tr in _rows(table):                       # tbody VEYA th'siz tr'ler
        tds = [_text(td) for td in tr.find_all("td")]
        if len(tds) < N or not any(tds[:N]):     # N = gerçek kolon sayısının ALTINDA taban
            continue
        out.append(<Model>(
            date=_cell(tds, 0) or "",             # gerekli str alan → `or ""`
            field2=_cell(tds, 1),                 # opsiyonel alan → çıplak _cell
        ))
    return out

Kurallar

• Tabloyu yalnız tam id ile seç. select_one("#id") or soup.find("table") ASLA — a074eee'de tam bu silindi (eksik id'de nav tablosunu sağlık modeline eşliyordu). tests/test_parser_robustness.py:28-39 bunu kilitler.
• Satırları _rows(table) ile gez (parsers.py:168-169), table.select("tbody tr") DEĞİL — sonrakisi tbody'siz tablolarda [] döner. parse_prescriptions bu yüzden düzeltildi (a074eee).
• Satır guard'ı if len(tds) < N or not any(tds[:N]): continue. N gerçek kolon sayısının altında bir tabandır — hiçbir gerçek satırı düşürmemek için; tam kolon sayısına "sıkılaştırma".
• Hücreye _cell(tds, i) (uç geçildiyse None, ""→None), metne _text(el) (get_text(" ", strip=True)). Gerekli str alanına _cell(tds, 0) or "".
• Her değer str/str | None. Sayı/doz/kutu/tarih int/float/bool'a çevrilmez — model sözleşmesi bu (box_count: str | None :334).
• Pydantic model: BaseModel, tek satır Türkçe docstring; alan adı İngilizce snake_case, Field(description=...) Türkçe; opsiyonel str | None = Field(default=None, …), gerekli str = Field(…).