sok-mcp 0.1.0__tar.gz

sok_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,20 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write # required for PyPI trusted publishing (OIDC)
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

sok_mcp-0.1.0/.github/workflows/registry.yml

@@ -0,0 +1,61 @@
+name: Publish to MCP Registry
+
+# Official MCP Registry (registry.modelcontextprotocol.io) via GitHub OIDC.
+# No secret, no interactive login: the runner's OIDC token proves ownership
+# of the io.github.mohammad-abbasi-sh/* namespace.
+# Refs: https://github.com/modelcontextprotocol/registry
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write # required for OIDC -> MCP Registry
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Sync server.json version to tag
+        # Only sync when running on a version tag (v*). On workflow_dispatch
+        # (ref = refs/heads/main) keep the version committed in server.json.
+        run: |
+          VER=""
+          if [[ "$GITHUB_REF" == refs/tags/* ]]; then
+            TAG="${GITHUB_REF#refs/tags/}"
+            VER="${TAG#v}"
+          fi
+          if [ -n "$VER" ]; then
+            python3 - "$VER" << 'EOF'
+          import json, sys
+          ver = sys.argv[1]
+          d = json.load(open('server.json'))
+          d['version'] = ver
+          for pkg in d.get('packages', []):
+              pkg['version'] = ver
+          json.dump(d, open('server.json', 'w'), indent=2, ensure_ascii=False)
+          print('server.json version ->', ver)
+          EOF
+          else
+            echo "No version tag ($GITHUB_REF); keeping server.json version as-is"
+          fi
+
+      - name: Install mcp-publisher
+        run: |
+          curl -sL "https://github.com/modelcontextprotocol/registry/releases/download/v1.8.7/mcp-publisher_linux_amd64.tar.gz" -o /tmp/mcp-publisher.tar.gz
+          tar -xzf /tmp/mcp-publisher.tar.gz -C /tmp
+          sudo mv /tmp/mcp-publisher /usr/local/bin/mcp-publisher
+          mcp-publisher --version
+
+      - name: Validate server.json
+        run: mcp-publisher validate server.json
+
+      - name: Publish to MCP Registry (OIDC)
+        run: |
+          mcp-publisher login github-oidc
+          mcp-publisher publish server.json
+        # A registry outage must never break the release; re-run from Actions if needed.
+        continue-on-error: true

sok_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.5
+Name: sok-mcp
+Version: 0.1.0
+Summary: Unofficial read-only MCP server for ŞOK grocery (sokmarket.com.tr) products, categories, campaigns, prices
+Author: Mohammad Abbasi
+License: MIT
+Requires-Python: >=3.10
+Requires-Dist: curl-cffi>=0.7
+Requires-Dist: mcp<2
+Requires-Dist: requests>=2.32
+Description-Content-Type: text/markdown
+
+# sok-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/sok-mcp
+
+Unofficial **read-only** MCP server for **ŞOK** (sokmarket.com.tr) — one of Türkiye's big discount grocery chains: product search, product details, categories, campaign groups and price statistics.
+
+> Part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with ŞOK.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "sok": {
+      "command": "uvx",
+      "args": ["sok-mcp"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m sok_mcp.server` (needs `mcp<2`, `curl-cffi`, `requests`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `sok_search_products` | Search products by name — `query`, `limit` (1..30, first page only) |
+| `sok_get_product` | Product detail — `slug_or_url` (e.g. `...-p-320230` or a full sokmarket.com.tr URL) |
+| `sok_list_categories` | Store categories (name, slug, id, url) |
+| `sok_category_products` | Products in one category — `category` slug or URL, `limit` (1..30) |
+| `sok_list_promotions` | Current campaign groups from `/kampanyalar` |
+| `sok_price_stats` | Price stats for a search — count, min, max, median, mean in TRY |
+
+Example output (`sok_search_products` / "süt"):
+
+```json
+{"query": "süt", "total": 207,
+ "products": [{"title": "Mis Uht Süt Yarım Yağlı 1 L", "id": "5834",
+   "url": "https://www.sokmarket.com.tr/mis-uht-sut-yarim-yagli-1-l-p-5834",
+   "price_try": 43.5}]}
+```
+
+Example output (`sok_price_stats` / "süt", first page of 10):
+
+```json
+{"query": "süt", "total_matches": 207, "count": 10,
+ "min_try": 16.5, "max_try": 88.5, "median_try": 55.75, "mean_try": 52.05}
+```
+
+Notes:
+- Prices are Turkish Lira (TRY); the site writes them Turkish-style (`43,50₺`).
+- Search/category pages return the first page (~20 products); `total` reports all matches.
+- Data: sokmarket.com.tr public server-rendered pages — no key, no login, read-only.
+
+## Development
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install "mcp<2" curl-cffi requests pytest
+.venv/bin/python -m pytest tests/ -q
+```
+
+- `tests/test_products.py` — offline, parses real captured fixtures
+- `tests/test_live.py` — 5 cautious live requests against sokmarket.com.tr
+
+## License
+
+MIT

sok_mcp-0.1.0/README-fa.md

@@ -0,0 +1,40 @@
+# sok-mcp 🇹🇷
+
+سرور MCP غیررسمی و **فقط‌خواندنی** برای **ŞOK** (sokmarket.com.tr) — یکی از زنجیره‌های بزرگ تخفیفی ترکیه: جست‌وجوی محصول، جزئیات محصول، دسته‌ها، گروه‌های کمپین و آمار قیمت.
+
+> بخشی از «کارخانه‌ی MCP ترکیه» (پایپ‌لاین به سبک سپهر). هیچ وابستگی به ŞOK ندارد.
+
+## برای ایجنت‌های هوش مصنوعی
+
+```json
+{
+  "mcpServers": {
+    "sok": {
+      "command": "uvx",
+      "args": ["sok-mcp"]
+    }
+  }
+}
+```
+
+## ابزارها
+
+| ابزار | توضیح |
+|------|-------|
+| `sok_search_products` | جست‌وجوی محصول با نام — `query`، ‏`limit` (۱ تا ۳۰، فقط صفحه‌ی اول) |
+| `sok_get_product` | جزئیات محصول — `slug_or_url` (مثلاً `...-p-320230` یا URL کامل sokmarket.com.tr) |
+| `sok_list_categories` | دسته‌های فروشگاه (نام، slug، id، url) |
+| `sok_category_products` | محصولات یک دسته — `category` (slug یا URL)، ‏`limit` (۱ تا ۳۰) |
+| `sok_list_promotions` | گروه‌های کمپین فعلی (`/kampanyalar`) |
+| `sok_price_stats` | آمار قیمت یک جست‌وجو — تعداد، کمترین، بیشترین، میانه، میانگین (لیر) |
+
+مثال (`sok_search_products` / «süt»): ۲۰۷ محصول؛ اولین نتیجه «Mis Uht Süt Yarım Yağlı 1 L» — ۴۳٫۵۰ لیر. مثال (`sok_price_stats` / «süt»): صفحه‌ی اول ۱۰ محصول، کمترین ۱۶٫۵۰ لیر، بیشترین ۸۸٫۵۰ لیر، میانه ۵۵٫۷۵ لیر.
+
+نکته‌ها:
+- قیمت‌ها به لیر ترکیه (TRY) هستند؛ سایت به سبک ترکی می‌نویسد (`43,50₺`).
+- صفحه‌های جست‌وجو/دسته فقط صفحه‌ی اول را برمی‌گردانند (~۲۰ محصول)؛ `total` همه‌ی تطابق‌ها را گزارش می‌کند.
+- داده: صفحات عمومی sokmarket.com.tr — بدون لاگین، بدون کلید، فقط‌خواندنی.
+
+## قوانین
+
+غیررسمی و فقط‌خواندنی — بدون لاگین، بدون کلید، بدون نوشتن. تست‌ها: آفلاین با فیکسچر + تست زنده (۱۵/۱۵ سبز).

sok_mcp-0.1.0/README-tr.md

@@ -0,0 +1,42 @@
+# sok-mcp 🇹🇷
+
+**ŞOK** (sokmarket.com.tr) için gayriresmî, **salt-okunur** MCP sunucusu — Türkiye'nin büyük indirim market zincirlerinden biri: ürün arama, ürün detayı, kategoriler, kampanya grupları ve fiyat istatistikleri.
+
+> "Türkiye MCP fabrikası" parçası (Sepehr tarzı pipeline). ŞOK ile bağlantısı yoktur.
+
+## Yapay zekâ ajanları için
+
+MCP istemcinize ekleyin (stdio):
+
+```json
+{
+  "mcpServers": {
+    "sok": {
+      "command": "uvx",
+      "args": ["sok-mcp"]
+    }
+  }
+}
+```
+
+## Araçlar
+
+| Araç | Açıklama |
+|------|----------|
+| `sok_search_products` | İsme göre ürün ara — `query`, `limit` (1..30, yalnızca ilk sayfa) |
+| `sok_get_product` | Ürün detayı — `slug_or_url` (örn. `...-p-320230` veya tam sokmarket.com.tr URL'si) |
+| `sok_list_categories` | Mağaza kategorileri (ad, slug, id, url) |
+| `sok_category_products` | Bir kategorideki ürünler — `category` slug veya URL, `limit` (1..30) |
+| `sok_list_promotions` | Güncel kampanya grupları (`/kampanyalar`) |
+| `sok_price_stats` | Bir aramanın fiyat istatistikleri — adet, min, max, medyan, ortalama (TRY) |
+
+Örnek (`sok_search_products` / "süt"): 207 ürün; ilk sonuç "Mis Uht Süt Yarım Yağlı 1 L" — 43,50₺. Örnek (`sok_price_stats` / "süt"): ilk sayfada 10 ürün, min 16,50₺, max 88,50₺, medyan 55,75₺.
+
+Notlar:
+- Fiyatlar Türk Lirası (TRY); site Türkçe yazar (`43,50₺`).
+- Arama/kategori sayfaları ilk sayfayı döner (~20 ürün); `total` tüm eşleşmeleri bildirir.
+- Veri: sokmarket.com.tr herkese açık sayfalar — giriş yok, API anahtarı yok, salt-okunur.
+
+## Kurallar
+
+Gayriresmî ve salt-okunur — giriş yok, API anahtarı yok, yazma yok. Testler: çevrimdışı fixture + canlı testler (15/15 yeşil).

sok_mcp-0.1.0/README.md

@@ -0,0 +1,70 @@
+# sok-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/sok-mcp
+
+Unofficial **read-only** MCP server for **ŞOK** (sokmarket.com.tr) — one of Türkiye's big discount grocery chains: product search, product details, categories, campaign groups and price statistics.
+
+> Part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with ŞOK.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "sok": {
+      "command": "uvx",
+      "args": ["sok-mcp"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m sok_mcp.server` (needs `mcp<2`, `curl-cffi`, `requests`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `sok_search_products` | Search products by name — `query`, `limit` (1..30, first page only) |
+| `sok_get_product` | Product detail — `slug_or_url` (e.g. `...-p-320230` or a full sokmarket.com.tr URL) |
+| `sok_list_categories` | Store categories (name, slug, id, url) |
+| `sok_category_products` | Products in one category — `category` slug or URL, `limit` (1..30) |
+| `sok_list_promotions` | Current campaign groups from `/kampanyalar` |
+| `sok_price_stats` | Price stats for a search — count, min, max, median, mean in TRY |
+
+Example output (`sok_search_products` / "süt"):
+
+```json
+{"query": "süt", "total": 207,
+ "products": [{"title": "Mis Uht Süt Yarım Yağlı 1 L", "id": "5834",
+   "url": "https://www.sokmarket.com.tr/mis-uht-sut-yarim-yagli-1-l-p-5834",
+   "price_try": 43.5}]}
+```
+
+Example output (`sok_price_stats` / "süt", first page of 10):
+
+```json
+{"query": "süt", "total_matches": 207, "count": 10,
+ "min_try": 16.5, "max_try": 88.5, "median_try": 55.75, "mean_try": 52.05}
+```
+
+Notes:
+- Prices are Turkish Lira (TRY); the site writes them Turkish-style (`43,50₺`).
+- Search/category pages return the first page (~20 products); `total` reports all matches.
+- Data: sokmarket.com.tr public server-rendered pages — no key, no login, read-only.
+
+## Development
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install "mcp<2" curl-cffi requests pytest
+.venv/bin/python -m pytest tests/ -q
+```
+
+- `tests/test_products.py` — offline, parses real captured fixtures
+- `tests/test_live.py` — 5 cautious live requests against sokmarket.com.tr
+
+## License
+
+MIT

sok_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "sok-mcp"
+version = "0.1.0"
+description = "Unofficial read-only MCP server for ŞOK grocery (sokmarket.com.tr) products, categories, campaigns, prices"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+dependencies = [
+    "mcp<2",
+    "curl-cffi>=0.7",
+    "requests>=2.32",
+]
+authors = [{ name = "Mohammad Abbasi" }]
+
+[project.scripts]
+sok-mcp = "sok_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/sok_mcp"]

sok_mcp-0.1.0/server.json

@@ -0,0 +1 @@
+{"$schema":"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json","description":"Unofficial read-only MCP server for ŞOK grocery — products, categories, campaigns, prices.","name":"io.github.mohammad-abbasi-sh/sok-mcp","packages":[{"identifier":"sok-mcp","registryBaseUrl":"https://pypi.org","registryType":"pypi","transport":{"type":"stdio"},"version":"0.1.0"}],"repository":{"source":"github","url":"https://github.com/mohammad-abbasi-sh/sok-mcp"},"title":"ŞOK Grocery","version":"0.1.0","websiteUrl":"https://github.com/mohammad-abbasi-sh/sok-mcp"}

sok_mcp-0.1.0/src/sok_mcp/__init__.py

@@ -0,0 +1,2 @@
+"""sok_mcp — unofficial read-only MCP server for ŞOK grocery (sokmarket.com.tr)."""
+__version__ = "0.1.0"

sok_mcp-0.1.0/src/sok_mcp/http.py

@@ -0,0 +1,93 @@
+"""HTTP layer for sok_mcp.
+
+sokmarket.com.tr is a Next.js storefront that serves its search,
+category and product pages fully server-rendered with no login and
+no API key. Transport uses curl-cffi chrome120 impersonation (the
+proven Turkey-factory pattern) with a plain-requests fallback.
+Requests are kept gentle (one at a time, ~0.8s apart) and read-only.
+"""
+from __future__ import annotations
+
+import time
+from urllib.parse import quote
+
+from curl_cffi import requests as _creq
+import requests as _plain
+
+BASE = "https://www.sokmarket.com.tr"
+TIMEOUT = 30.0
+MIN_INTERVAL = 0.8  # seconds between requests — be polite
+
+_HEADERS = {
+    "Accept-Language": "tr-TR,tr;q=0.9,en;q=0.8",
+    "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
+}
+
+_UA = (
+    "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
+    "(KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
+)
+
+_last_fetch = 0.0
+
+
+class SokError(RuntimeError):
+    pass
+
+
+def _throttle() -> None:
+    global _last_fetch
+    wait = MIN_INTERVAL - (time.monotonic() - _last_fetch)
+    if wait > 0:
+        time.sleep(wait)
+    _last_fetch = time.monotonic()
+
+
+def _get(url: str) -> str:
+    _throttle()
+    try:
+        resp = _creq.get(url, impersonate="chrome120", headers=_HEADERS, timeout=TIMEOUT)
+        status, text = resp.status_code, resp.text
+    except Exception:
+        # Fallback transport: plain requests with a browser UA.
+        try:
+            resp = _plain.get(url, headers={**_HEADERS, "User-Agent": _UA}, timeout=TIMEOUT)
+            status, text = resp.status_code, resp.text
+        except Exception as e:
+            raise SokError(f"network error fetching {url}: {e}") from e
+    if status == 403:
+        raise SokError(
+            "sokmarket.com.tr refused the request (HTTP 403, bot wall) — try again later"
+        )
+    if status == 429:
+        raise SokError(
+            "sokmarket.com.tr rate-limited the request (HTTP 429) — try again later"
+        )
+    if status == 404:
+        raise SokError(f"sokmarket.com.tr has no page at {url} (HTTP 404)")
+    if status != 200:
+        raise SokError(f"sokmarket.com.tr returned HTTP {status} for {url}")
+    return text
+
+
+def fetch_search(query: str) -> str:
+    return _get(f"{BASE}/arama?q={quote(query)}")
+
+
+def fetch_product(path: str) -> str:
+    path = path.strip()
+    if path.startswith("http"):
+        return _get(path)
+    return _get(f"{BASE}/{path.lstrip('/')}")
+
+
+def fetch_home() -> str:
+    return _get(f"{BASE}/")
+
+
+def fetch_category(path: str) -> str:
+    return _get(f"{BASE}/{path.strip().lstrip('/')}")
+
+
+def fetch_campaigns() -> str:
+    return _get(f"{BASE}/kampanyalar")

sok_mcp-0.1.0/src/sok_mcp/products.py

@@ -0,0 +1,156 @@
+"""Domain logic: parse ŞOK (sokmarket.com.tr) pages into compact dicts.
+
+Data sources (all public, no login, no key):
+- search:   /arama?q=<query> — server-rendered product cards
+  ("207 adet ürün listelendi"), title + price per card
+- product:  /<slug>-p-<id> — h1 title, price, related products
+- category: /<slug>-c-<id> — same product-card grid as search
+- home:     / — 19 categories (-c- links) + promo groups (-pgrp-)
+- promos:   /kampanyalar — campaign groups (-pgrp- links)
+Prices are Turkish format ("43,50₺", thousands "1.234,56₺").
+Stdlib parsing only (re / html).
+"""
+from __future__ import annotations
+
+import html as _html
+import re
+import statistics
+
+BASE = "https://www.sokmarket.com.tr"
+
+_CARD_TITLE = "CProductCard-module_title__u8bMW"
+
+
+def _clean(text: str | None) -> str:
+    if not text:
+        return ""
+    return re.sub(r"\s+", " ", _html.unescape(str(text))).strip()
+
+
+def parse_price(text: str | None) -> float | None:
+    """'43,50' / '1.234,56' (Turkish) -> 43.5 / 1234.56."""
+    if not text:
+        return None
+    s = text.strip().replace("₺", "").replace("\xa0", "").strip()
+    s = s.replace(".", "").replace(",", ".")
+    try:
+        return float(s)
+    except ValueError:
+        return None
+
+
+def _price_in(block: str) -> float | None:
+    m = re.search(
+        r'data-testid="(?:discountedPrice|price)">([\d.,]+)<!-- -->\s*₺', block
+    )
+    return parse_price(m.group(1)) if m else None
+
+
+def parse_product_cards(html: str) -> dict:
+    """Product-card grid -> {total, products[{title, slug, id, url, price_try}]}.
+
+    total comes from the "N adet ürün listelendi" line when present.
+    """
+    total = None
+    m = re.search(r"(\d+)(?:<!-- -->)?\s*adet ürün", html)
+    if m:
+        total = int(m.group(1))
+    products, seen = [], set()
+    # Each card is an <a href="/<slug>-p-<id>"> wrapping title + price.
+    for link in re.finditer(r'<a href="(/[^"]+-p-(\d+))">', html):
+        href, pid = link.group(1), link.group(2)
+        if pid in seen:
+            continue
+        block = html[link.start(): link.start() + 4000]
+        t = re.search(
+            rf'<h2 class="{re.escape(_CARD_TITLE)}">(.*?)</h2>', block, re.S
+        )
+        if not t:
+            continue
+        seen.add(pid)
+        products.append(
+            {
+                "title": _clean(t.group(1)),
+                "slug": href.strip("/").rsplit("-p-", 1)[0],
+                "id": pid,
+                "url": f"{BASE}{href}",
+                "price_try": _price_in(block),
+            }
+        )
+    return {"total": total if total is not None else len(products), "products": products}
+
+
+def parse_product_page(html: str) -> dict:
+    """Product detail page: h1 title, price, related products."""
+    h1 = re.search(r"<h1[^>]*>(.*?)</h1>", html, re.S)
+    title = _clean(re.sub(r"<[^>]+>", "", h1.group(1))) if h1 else ""
+    if not title:
+        raise ValueError("no product title found on this page")
+    related = [
+        _clean(t)
+        for t in re.findall(
+            rf'<h2 class="{re.escape(_CARD_TITLE)}">(.*?)</h2>', html, re.S
+        )
+    ]
+    return {
+        "title": title,
+        "price_try": _price_in(html),
+        "related_products": related,
+    }
+
+
+def parse_categories(html: str) -> list[dict]:
+    """Homepage category links: /<slug>-c-<id> with Turkish link text."""
+    out, seen = [], set()
+    for href, _cid, inner in re.findall(
+        r'<a[^>]+href="(/[^"]+-c-(\d+))"[^>]*>(.*?)</a>', html, re.S
+    ):
+        name = _clean(re.sub(r"<[^>]+>", "", inner))
+        if not name or href in seen:
+            continue
+        seen.add(href)
+        out.append(
+            {
+                "name": name,
+                "slug": href.strip("/").rsplit("-c-", 1)[0],
+                "id": href.rsplit("-c-", 1)[-1],
+                "url": f"{BASE}{href}",
+            }
+        )
+    return out
+
+
+def parse_promotions(html: str) -> list[dict]:
+    """Campaign groups: /<slug>-pgrp-<uuid> links with link text."""
+    out, seen = [], set()
+    for href, inner in re.findall(
+        r'<a[^>]+href="(/[^"]+-pgrp-[^"]+)"[^>]*>(.*?)</a>', html, re.S
+    ):
+        name = _clean(re.sub(r"<[^>]+>", "", inner))
+        if not name or href in seen:
+            continue
+        seen.add(href)
+        out.append({"name": name, "slug": href.strip("/").rsplit("-pgrp-", 1)[0], "url": f"{BASE}{href}"})
+    # The /kampanyalar page also links promos without inner text in some
+    # spots; fall back to bare hrefs with a slug-derived name.
+    if not out:
+        for href in sorted(set(re.findall(r'href="(/[^"]+-pgrp-[^"]+)"', html))):
+            slug = href.strip("/").rsplit("-pgrp-", 1)[0]
+            out.append(
+                {"name": slug.replace("-", " "), "slug": slug, "url": f"{BASE}{href}"}
+            )
+    return out
+
+
+def price_stats(products: list[dict]) -> dict:
+    """min / max / median / mean over products that have a price."""
+    prices = sorted(p["price_try"] for p in products if p.get("price_try") is not None)
+    if not prices:
+        return {"count": 0, "min_try": None, "max_try": None, "median_try": None, "mean_try": None}
+    return {
+        "count": len(prices),
+        "min_try": prices[0],
+        "max_try": prices[-1],
+        "median_try": statistics.median(prices),
+        "mean_try": round(statistics.fmean(prices), 2),
+    }

sok_mcp-0.1.0/src/sok_mcp/server.py

@@ -0,0 +1,130 @@
+"""MCP server: unofficial read-only access to ŞOK grocery (sokmarket.com.tr)."""
+from __future__ import annotations
+
+import json
+
+from mcp.server.fastmcp import FastMCP
+
+from . import http as _http
+from . import products as _P
+
+mcp = FastMCP("sok-mcp")
+
+INSTRUCTIONS = """\
+Unofficial read-only MCP server for ŞOK (sokmarket.com.tr), one of \
+Türkiye's big discount grocery chains — product search, product \
+details, categories, campaign groups and price statistics. All \
+pages are server-rendered Next.js with no login and no API key; \
+prices are in Turkish Lira (TRY, Turkish format "43,50₺"). \
+Search/category pages list the first page of results (~20 \
+products); the `total` field reports how many products matched \
+overall. Read-only; transport uses Chrome TLS impersonation with \
+a plain-requests fallback; requests are spaced ~0.8s apart. Built \
+by Mohammad Abbasi (mohammad-abbasi-sh) — Turkey MCP factory.\
+"""
+
+
+def _err(e: Exception) -> str:
+    return json.dumps({"error": str(e)}, ensure_ascii=False)
+
+
+def _validate_limit(limit: int, lo: int = 1, hi: int = 30) -> int:
+    if not lo <= limit <= hi:
+        raise ValueError(f"limit must be between {lo} and {hi}")
+    return limit
+
+
+@mcp.tool()
+def sok_search_products(query: str, limit: int = 20) -> str:
+    """Search ŞOK products by name.
+    query: e.g. "süt", "çay", "peynir". limit 1..30 (first page only;
+    `total` reports all matches). Returns title, slug, id, url and
+    price in TRY per product."""
+    try:
+        if not query or not query.strip():
+            raise ValueError("query must not be empty")
+        _validate_limit(limit)
+        res = _P.parse_product_cards(_http.fetch_search(query.strip()))
+    except (ValueError, _http.SokError) as e:
+        return _err(e)
+    res["products"] = res["products"][:limit]
+    return json.dumps({"query": query.strip(), **res}, ensure_ascii=False)
+
+
+@mcp.tool()
+def sok_get_product(slug_or_url: str) -> str:
+    """Product detail: title, price in TRY, related products.
+    slug_or_url: e.g. "ahmad-tea-classic-earl-grey-demlik-poset-40-li-p-320230"
+    or a full sokmarket.com.tr product URL."""
+    try:
+        s = slug_or_url.strip()
+        if not s:
+            raise ValueError("slug_or_url must not be empty")
+        page = _P.parse_product_page(_http.fetch_product(s))
+    except (ValueError, _http.SokError) as e:
+        return _err(e)
+    return json.dumps({"url": slug_or_url.strip(), **page}, ensure_ascii=False)
+
+
+@mcp.tool()
+def sok_list_categories() -> str:
+    """ŞOK store categories (name, slug, id, url) from the homepage."""
+    try:
+        cats = _P.parse_categories(_http.fetch_home())
+    except (ValueError, _http.SokError) as e:
+        return _err(e)
+    return json.dumps({"count": len(cats), "categories": cats}, ensure_ascii=False)
+
+
+@mcp.tool()
+def sok_category_products(category: str, limit: int = 20) -> str:
+    """Products in one ŞOK category.
+    category: slug like "sut-ve-sut-urunleri-c-460" or a full
+    sokmarket.com.tr category URL. limit 1..30 (first page only)."""
+    try:
+        if not category or not category.strip():
+            raise ValueError("category must not be empty")
+        _validate_limit(limit)
+        res = _P.parse_product_cards(_http.fetch_category(category.strip()))
+    except (ValueError, _http.SokError) as e:
+        return _err(e)
+    res["products"] = res["products"][:limit]
+    return json.dumps({"category": category.strip(), **res}, ensure_ascii=False)
+
+
+@mcp.tool()
+def sok_list_promotions() -> str:
+    """Current ŞOK campaign groups from /kampanyalar
+    (name, slug, url — each links to its discounted products)."""
+    try:
+        promos = _P.parse_promotions(_http.fetch_campaigns())
+    except (ValueError, _http.SokError) as e:
+        return _err(e)
+    return json.dumps({"count": len(promos), "promotions": promos}, ensure_ascii=False)
+
+
+@mcp.tool()
+def sok_price_stats(query: str) -> str:
+    """Price statistics for a search: count, min, max, median, mean in
+    TRY over the first results page. query: e.g. "süt"."""
+    try:
+        if not query or not query.strip():
+            raise ValueError("query must not be empty")
+        res = _P.parse_product_cards(_http.fetch_search(query.strip()))
+        stats = _P.price_stats(res["products"])
+    except (ValueError, _http.SokError) as e:
+        return _err(e)
+    return json.dumps(
+        {"query": query.strip(), "total_matches": res["total"], **stats},
+        ensure_ascii=False,
+    )
+
+
+def main() -> None:
+    mcp.run()
+
+
+if __name__ == "__main__":
+    import sys
+
+    sys.exit(main())

sok_mcp-0.1.0/tests/fixtures/home.html

@@ -0,0 +1,23 @@
+<html><body>
+<a href="/yemeklik-malzemeler-c-1770">Yemeklik Malzemeler</a>
+<a href="/et-ve-tavuk-ve-sarkuteri-c-160">Et &amp; Tavuk &amp; Şarküteri</a>
+<a href="/meyve-ve-sebze-c-20">Meyve &amp; Sebze</a>
+<a href="/sut-ve-sut-urunleri-c-460">Süt &amp; Süt Ürünleri</a>
+<a href="/kahvaltilik-c-890">Kahvaltılık</a>
+<a href="/atistirmaliklar-c-20376">Atıştırmalık</a>
+<a href="/icecek-c-20505">İçecek</a>
+<a href="/ekmek-ve-pastane-c-1250">Ekmek &amp; Pastane</a>
+<a href="/dondurulmus-urunler-c-1550">Dondurulmuş Ürünler</a>
+<a href="/dondurma-c-31102">Dondurma</a>
+<a href="/temizlik-c-20647">Temizlik</a>
+<a href="/kagit-urunler-c-20875">Kağıt Ürünleri</a>
+<a href="/kisisel-bakim-ve-kozmetik-c-20395">Kişisel Bakım &amp; Kozmetik</a>
+<a href="/anne-bebek-ve-cocuk-c-20634">Anne - Bebek &amp; Çocuk</a>
+<a href="/oyuncak-c-20644">Oyuncak</a>
+<a href="/ev-ve-yasam-c-20898">Ev &amp; Yaşam</a>
+<a href="/evcil-dostlar-c-20880">Evcil Dostlar</a>
+<a href="/giyim-ve-ayakkabi-ve-aksesuar-c-20886">Giyim &amp; Aksesuar</a>
+<a href="/elektronik-c-22769">Elektronik</a>
+<a href="/win-kazandiran-urunler-pgrp-f353cf31-f728-425e-a453-5774219a76b8">Kazandırır Alışverişin</a>
+<a href="/50-tl-ve-uzeri-indirimli-urunler-pgrp-11d42a6b-df28-4fe6-b1a3-7ad6b8d7f9a0">Kasa Arkası Ürünler</a>
+</body></html>

sok_mcp-0.1.0/tests/fixtures/kampanyalar.html

@@ -0,0 +1,4 @@
+<html><head><title>Kampanyalar</title></head><body>
+<a href="/win-kazandiran-urunler-pgrp-f353cf31-f728-425e-a453-5774219a76b8">Kazandırır Alışverişin</a>
+<a href="/50-tl-ve-uzeri-indirimli-urunler-pgrp-11d42a6b-df28-4fe6-b1a3-7ad6b8d7f9a0">Kasa Arkası Ürünler</a>
+</body></html>

sok_mcp-0.1.0/tests/fixtures/product.html

@@ -0,0 +1,10 @@
+<html><head><title>Ahmad Tea Classic Earl Grey Demlik Poşet 40&#x27;lı - Cepte Şok</title></head><body>
+<h1 class="ProductMainInfoArea_productName__bKRVD">Ahmad Tea Classic Earl Grey Demlik Poşet 40&#x27;lı</h1>
+<span style="font-size:22px;line-height:20px;font-weight:800" class="CPriceBox-module_price__bYk-c" data-testid="discountedPrice">149,00<!-- -->₺</span>
+
+<h2>Deren Premium Çay 1000 g</h2>
+<h2>Deren Harman Çay 1000 g</h2>
+<h2>Deren Rize Çay 1000 g</h2>
+<h2>Deren Filiz Çay 500 g</h2>
+<h2>Deren Bergamot Aromalı Çay 500 g</h2>
+</body></html>

sok_mcp-0.1.0/tests/fixtures/search.html

@@ -0,0 +1,13 @@
+<html><head><title>Cepte Şok</title></head><body>
+<p>207<!-- --> adet ürün listelendi</p>
+<a href="/mis-uht-sut-yarim-yagli-1-l-p-5834"><div class="CProductCard-module_productCardWrapper__okAmT CProductCard-module_PLPCard__rB4tw"><div class="CQuantityChangerCapsule-module_buttonWrapper__Bed1d CQuantityChangerCapsule-module_singleButtonWrapper__oGhYN CQuantityChangerCapsule-module_small__2YPFl" style="position:absolute;right:8px;top:8px"><button class="CQuantityChangerCapsule-module_plusButton__ABlui CQuantityChangerCapsule-module_small__2YPFl" type="button" style="background-color:#e6eef6;border:1px solid #cddcec"><svg width="14" height="14" viewBox="0 0 12 12" fill="#0551a0" xmlns="http://www.w3.org/2000/svg"><path d="M10.9286 4.92857H7.28571C7.16738 4.92857 7.07143 4.83262 7.07143 4.71429V1.07143C7.07143 0.479736 6.59169 0 6 0C5.40831 0 4.92857 0.479736 4.92857 1.07143V4.71429C4.92857 4.83262 4.83262 4.92857 4.71429 4.92857H1.07143C0.479736 4.92857 0 5.40831 0 6C0 6.59169 0.479736 7.07143 1.07143 7.07143H4.71429C4.83262 7.07143 4.92857 7.16738 4.92857 7.28571V10.9286C4.92857 11.5203 5.40831 12 6 12C6.59169 12 7.07143 11.5203 7.07143 10.9286V7.28571C7.07143 7.16738 7.16738 7.07143 7.28571 7.07143H10.9286C11.5203 7.07143 12 6.59169 12 6C12 5.40831 11.5203 4.92857 10.9286 4.92857Z" fill="#0551a0"></path></svg></button></div><div class="CProductCard-module_productCardContainer__mwUl7"><div class="CProductCard-module_containerTop__35Ma3"><div class="CProductCard-module_imageContainer__aTMdz"><img src="https://images.ceptesok.com/cdn-cgi/image/width=216,height=216,fit=pad,quality=80,format=webp/product-assets/sub-folder/20b8a4b2-4a67-4bb0-a863-e55df8db3631.jpg" alt="product-thumb" style="width:108px;height:108px"/></div><div class="CProductCard-module_infoContainer__F8uxY"><h2 class="CProductCard-module_title__u8bMW">Mis Uht Süt Yarım Yağlı 1 L</h2><div class="CPriceBox-module_cPriceBox__1OWBR CPriceBox-module_productCardPrice__yjBVO"><div class="CPriceBox-module_priceContainer__ZROpc" style="height:26px"><span style="font-size:14px;line-height:16px;font-weight:800" class="CPriceBox-module_price__bYk-c" data-testid="discountedPrice">43,50<!-- -->₺</span></div></div></div></div></div></div></a></div></div>
+<a href="/icim-organik-sut-1-l-p-7796"><div class="CProductCard-module_productCardWrapper__okAmT CProductCard-module_PLPCard__rB4tw"><div class="CQuantityChangerCapsule-module_buttonWrapper__Bed1d CQuantityChangerCapsule-module_singleButtonWrapper__oGhYN CQuantityChangerCapsule-module_small__2YPFl" style="position:absolute;right:8px;top:8px"><button class="CQuantityChangerCapsule-module_plusButton__ABlui CQuantityChangerCapsule-module_small__2YPFl" type="button" style="background-color:#e6eef6;border:1px solid #cddcec"><svg width="14" height="14" viewBox="0 0 12 12" fill="#0551a0" xmlns="http://www.w3.org/2000/svg"><path d="M10.9286 4.92857H7.28571C7.16738 4.92857 7.07143 4.83262 7.07143 4.71429V1.07143C7.07143 0.479736 6.59169 0 6 0C5.40831 0 4.92857 0.479736 4.92857 1.07143V4.71429C4.92857 4.83262 4.83262 4.92857 4.71429 4.92857H1.07143C0.479736 4.92857 0 5.40831 0 6C0 6.59169 0.479736 7.07143 1.07143 7.07143H4.71429C4.83262 7.07143 4.92857 7.16738 4.92857 7.28571V10.9286C4.92857 11.5203 5.40831 12 6 12C6.59169 12 7.07143 11.5203 7.07143 10.9286V7.28571C7.07143 7.16738 7.16738 7.07143 7.28571 7.07143H10.9286C11.5203 7.07143 12 6.59169 12 6C12 5.40831 11.5203 4.92857 10.9286 4.92857Z" fill="#0551a0"></path></svg></button></div><div class="CProductCard-module_productCardContainer__mwUl7"><div class="CProductCard-module_containerTop__35Ma3"><div class="CProductCard-module_imageContainer__aTMdz"><img src="https://images.ceptesok.com/cdn-cgi/image/width=216,height=216,fit=pad,quality=80,format=webp/product-assets/sub-folder/642caf4f-b52d-493f-9813-f5d533f778e5.png" alt="product-thumb" style="width:108px;height:108px"/></div><div class="CProductCard-module_infoContainer__F8uxY"><h2 class="CProductCard-module_title__u8bMW">İçim Organik Süt 1 L</h2><div class="CPriceBox-module_cPriceBox__1OWBR CPriceBox-module_productCardPrice__yjBVO"><div class="CPriceBox-module_priceContainer__ZROpc" style="height:26px"><span style="font-size:14px;line-height:16px;font-weight:800" class="CPriceBox-module_price__bYk-c" data-testid="discountedPrice">88,50<!-- -->₺</span></div></div></div></div></div></div></a></div></div>
+<a href="/mis-uht-sut-yagsiz-1-l-p-5179"><div class="CProductCard-module_productCardWrapper__okAmT CProductCard-module_PLPCard__rB4tw"><div class="CQuantityChangerCapsule-module_buttonWrapper__Bed1d CQuantityChangerCapsule-module_singleButtonWrapper__oGhYN CQuantityChangerCapsule-module_small__2YPFl" style="position:absolute;right:8px;top:8px"><button class="CQuantityChangerCapsule-module_plusButton__ABlui CQuantityChangerCapsule-module_small__2YPFl" type="button" style="background-color:#e6eef6;border:1px solid #cddcec"><svg width="14" height="14" viewBox="0 0 12 12" fill="#0551a0" xmlns="http://www.w3.org/2000/svg"><path d="M10.9286 4.92857H7.28571C7.16738 4.92857 7.07143 4.83262 7.07143 4.71429V1.07143C7.07143 0.479736 6.59169 0 6 0C5.40831 0 4.92857 0.479736 4.92857 1.07143V4.71429C4.92857 4.83262 4.83262 4.92857 4.71429 4.92857H1.07143C0.479736 4.92857 0 5.40831 0 6C0 6.59169 0.479736 7.07143 1.07143 7.07143H4.71429C4.83262 7.07143 4.92857 7.16738 4.92857 7.28571V10.9286C4.92857 11.5203 5.40831 12 6 12C6.59169 12 7.07143 11.5203 7.07143 10.9286V7.28571C7.07143 7.16738 7.16738 7.07143 7.28571 7.07143H10.9286C11.5203 7.07143 12 6.59169 12 6C12 5.40831 11.5203 4.92857 10.9286 4.92857Z" fill="#0551a0"></path></svg></button></div><div class="CProductCard-module_productCardContainer__mwUl7"><div class="CProductCard-module_containerTop__35Ma3"><div class="CProductCard-module_imageContainer__aTMdz"><img src="https://images.ceptesok.com/cdn-cgi/image/width=216,height=216,fit=pad,quality=80,format=webp/product-assets/sub-folder/c87d0ff9-d53f-4956-8def-4099f523abea.jpg" alt="product-thumb" style="width:108px;height:108px"/></div><div class="CProductCard-module_infoContainer__F8uxY"><h2 class="CProductCard-module_title__u8bMW">Mis Uht Süt Yağsız 1 L</h2><div class="CPriceBox-module_cPriceBox__1OWBR CPriceBox-module_productCardPrice__yjBVO"><div class="CPriceBox-module_priceContainer__ZROpc" style="height:26px"><span style="font-size:14px;line-height:16px;font-weight:800" class="CPriceBox-module_price__bYk-c" data-testid="discountedPrice">36,00<!-- -->₺</span></div></div></div></div></div></div></a></div></div>
+<a href="/mis-uht-sut-3-1-yagli-1-l-p-8533"><div class="CProductCard-module_productCardWrapper__okAmT CProductCard-module_PLPCard__rB4tw"><div class="CQuantityChangerCapsule-module_buttonWrapper__Bed1d CQuantityChangerCapsule-module_singleButtonWrapper__oGhYN CQuantityChangerCapsule-module_small__2YPFl" style="position:absolute;right:8px;top:8px"><button class="CQuantityChangerCapsule-module_plusButton__ABlui CQuantityChangerCapsule-module_small__2YPFl" type="button" style="background-color:#e6eef6;border:1px solid #cddcec"><svg width="14" height="14" viewBox="0 0 12 12" fill="#0551a0" xmlns="http://www.w3.org/2000/svg"><path d="M10.9286 4.92857H7.28571C7.16738 4.92857 7.07143 4.83262 7.07143 4.71429V1.07143C7.07143 0.479736 6.59169 0 6 0C5.40831 0 4.92857 0.479736 4.92857 1.07143V4.71429C4.92857 4.83262 4.83262 4.92857 4.71429 4.92857H1.07143C0.479736 4.92857 0 5.40831 0 6C0 6.59169 0.479736 7.07143 1.07143 7.07143H4.71429C4.83262 7.07143 4.92857 7.16738 4.92857 7.28571V10.9286C4.92857 11.5203 5.40831 12 6 12C6.59169 12 7.07143 11.5203 7.07143 10.9286V7.28571C7.07143 7.16738 7.16738 7.07143 7.28571 7.07143H10.9286C11.5203 7.07143 12 6.59169 12 6C12 5.40831 11.5203 4.92857 10.9286 4.92857Z" fill="#0551a0"></path></svg></button></div><div class="CProductCard-module_productCardContainer__mwUl7"><div class="CProductCard-module_containerTop__35Ma3"><div class="CProductCard-module_imageContainer__aTMdz"><img src="https://images.ceptesok.com/cdn-cgi/image/width=216,height=216,fit=pad,quality=80,format=webp/product-assets/sub-folder/691ac110-fa10-46fe-a58a-9126d2c09c64.jpg" alt="product-thumb" style="width:108px;height:108px"/></div><div class="CProductCard-module_infoContainer__F8uxY"><h2 class="CProductCard-module_title__u8bMW">Mis Uht Süt %3.1 Yağlı 1 L</h2><div class="CPriceBox-module_cPriceBox__1OWBR CPriceBox-module_productCardPrice__yjBVO"><div class="CPriceBox-module_priceContainer__ZROpc" style="height:26px"><span style="font-size:14px;line-height:16px;font-weight:800" class="CPriceBox-module_price__bYk-c" data-testid="discountedPrice">52,50<!-- -->₺</span></div></div></div></div></div></div></a></div></div>
+<a href="/mis-bakraclik-sut-tam-yagli-1-l-p-7501"><div class="CProductCard-module_productCardWrapper__okAmT CProductCard-module_PLPCard__rB4tw"><div class="CQuantityChangerCapsule-module_buttonWrapper__Bed1d CQuantityChangerCapsule-module_singleButtonWrapper__oGhYN CQuantityChangerCapsule-module_small__2YPFl" style="position:absolute;right:8px;top:8px"><button class="CQuantityChangerCapsule-module_plusButton__ABlui CQuantityChangerCapsule-module_small__2YPFl" type="button" style="background-color:#e6eef6;border:1px solid #cddcec"><svg width="14" height="14" viewBox="0 0 12 12" fill="#0551a0" xmlns="http://www.w3.org/2000/svg"><path d="M10.9286 4.92857H7.28571C7.16738 4.92857 7.07143 4.83262 7.07143 4.71429V1.07143C7.07143 0.479736 6.59169 0 6 0C5.40831 0 4.92857 0.479736 4.92857 1.07143V4.71429C4.92857 4.83262 4.83262 4.92857 4.71429 4.92857H1.07143C0.479736 4.92857 0 5.40831 0 6C0 6.59169 0.479736 7.07143 1.07143 7.07143H4.71429C4.83262 7.07143 4.92857 7.16738 4.92857 7.28571V10.9286C4.92857 11.5203 5.40831 12 6 12C6.59169 12 7.07143 11.5203 7.07143 10.9286V7.28571C7.07143 7.16738 7.16738 7.07143 7.28571 7.07143H10.9286C11.5203 7.07143 12 6.59169 12 6C12 5.40831 11.5203 4.92857 10.9286 4.92857Z" fill="#0551a0"></path></svg></button></div><div class="CProductCard-module_productCardContainer__mwUl7"><div class="CProductCard-module_containerTop__35Ma3"><div class="CProductCard-module_imageContainer__aTMdz"><img src="https://images.ceptesok.com/cdn-cgi/image/width=216,height=216,fit=pad,quality=80,format=webp/product-assets/sub-folder/ddb7fb6c-e722-4e47-a34b-c925ec43a74f.png" alt="product-thumb" style="width:108px;height:108px"/></div><div class="CProductCard-module_infoContainer__F8uxY"><h2 class="CProductCard-module_title__u8bMW">Mis Bakraçlık Süt Tam Yağlı 1 L</h2><div class="CPriceBox-module_cPriceBox__1OWBR CPriceBox-module_productCardPrice__yjBVO"><div class="CPriceBox-module_priceContainer__ZROpc" style="height:26px"><span style="font-size:14px;line-height:16px;font-weight:800" class="CPriceBox-module_price__bYk-c" data-testid="discountedPrice">64,00<!-- -->₺</span></div></div></div></div></div></div></a></div></div>
+<a href="/mis-pastorize-dogal-icme-sutu-1-l-p-6044"><div class="CProductCard-module_productCardWrapper__okAmT CProductCard-module_PLPCard__rB4tw"><div class="CQuantityChangerCapsule-module_buttonWrapper__Bed1d CQuantityChangerCapsule-module_singleButtonWrapper__oGhYN CQuantityChangerCapsule-module_small__2YPFl" style="position:absolute;right:8px;top:8px"><button class="CQuantityChangerCapsule-module_plusButton__ABlui CQuantityChangerCapsule-module_small__2YPFl" type="button" style="background-color:#e6eef6;border:1px solid #cddcec"><svg width="14" height="14" viewBox="0 0 12 12" fill="#0551a0" xmlns="http://www.w3.org/2000/svg"><path d="M10.9286 4.92857H7.28571C7.16738 4.92857 7.07143 4.83262 7.07143 4.71429V1.07143C7.07143 0.479736 6.59169 0 6 0C5.40831 0 4.92857 0.479736 4.92857 1.07143V4.71429C4.92857 4.83262 4.83262 4.92857 4.71429 4.92857H1.07143C0.479736 4.92857 0 5.40831 0 6C0 6.59169 0.479736 7.07143 1.07143 7.07143H4.71429C4.83262 7.07143 4.92857 7.16738 4.92857 7.28571V10.9286C4.92857 11.5203 5.40831 12 6 12C6.59169 12 7.07143 11.5203 7.07143 10.9286V7.28571C7.07143 7.16738 7.16738 7.07143 7.28571 7.07143H10.9286C11.5203 7.07143 12 6.59169 12 6C12 5.40831 11.5203 4.92857 10.9286 4.92857Z" fill="#0551a0"></path></svg></button></div><div class="CProductCard-module_productCardContainer__mwUl7"><div class="CProductCard-module_containerTop__35Ma3"><div class="CProductCard-module_imageContainer__aTMdz"><img src="https://images.ceptesok.com/cdn-cgi/image/width=216,height=216,fit=pad,quality=80,format=webp/product-assets/sub-folder/e32a6c94-6dd4-487a-a29b-de954e04c9ed.png" alt="product-thumb" style="width:108px;height:108px"/></div><div class="CProductCard-module_infoContainer__F8uxY"><h2 class="CProductCard-module_title__u8bMW">Mis Pastörize Doğal İçme Sütü 1 L</h2><div class="CPriceBox-module_cPriceBox__1OWBR CPriceBox-module_productCardPrice__yjBVO"><div class="CPriceBox-module_priceContainer__ZROpc" style="height:26px"><span style="font-size:14px;line-height:16px;font-weight:800" class="CPriceBox-module_price__bYk-c" data-testid="discountedPrice">59,00<!-- -->₺</span></div></div></div></div></div></div></a></div></div>
+<a href="/sutas-laktozsuz-sut-200-ml-p-635179"><div class="CProductCard-module_productCardWrapper__okAmT CProductCard-module_PLPCard__rB4tw"><div class="CQuantityChangerCapsule-module_buttonWrapper__Bed1d CQuantityChangerCapsule-module_singleButtonWrapper__oGhYN CQuantityChangerCapsule-module_small__2YPFl" style="position:absolute;right:8px;top:8px"><button class="CQuantityChangerCapsule-module_plusButton__ABlui CQuantityChangerCapsule-module_small__2YPFl" type="button" style="background-color:#e6eef6;border:1px solid #cddcec"><svg width="14" height="14" viewBox="0 0 12 12" fill="#0551a0" xmlns="http://www.w3.org/2000/svg"><path d="M10.9286 4.92857H7.28571C7.16738 4.92857 7.07143 4.83262 7.07143 4.71429V1.07143C7.07143 0.479736 6.59169 0 6 0C5.40831 0 4.92857 0.479736 4.92857 1.07143V4.71429C4.92857 4.83262 4.83262 4.92857 4.71429 4.92857H1.07143C0.479736 4.92857 0 5.40831 0 6C0 6.59169 0.479736 7.07143 1.07143 7.07143H4.71429C4.83262 7.07143 4.92857 7.16738 4.92857 7.28571V10.9286C4.92857 11.5203 5.40831 12 6 12C6.59169 12 7.07143 11.5203 7.07143 10.9286V7.28571C7.07143 7.16738 7.16738 7.07143 7.28571 7.07143H10.9286C11.5203 7.07143 12 6.59169 12 6C12 5.40831 11.5203 4.92857 10.9286 4.92857Z" fill="#0551a0"></path></svg></button></div><div class="CProductCard-module_productCardContainer__mwUl7"><div class="CProductCard-module_containerTop__35Ma3"><div class="CProductCard-module_imageContainer__aTMdz"><img src="https://images.ceptesok.com/cdn-cgi/image/width=216,height=216,fit=pad,quality=80,format=webp/product-assets/sub-folder/328bd4bd-f60b-4526-862e-9bb0599a8ece.png" alt="product-thumb" style="width:108px;height:108px"/></div><div class="CProductCard-module_infoContainer__F8uxY"><h2 class="CProductCard-module_title__u8bMW">Sütaş Laktozsuz Süt 200 ml</h2><div class="CPriceBox-module_cPriceBox__1OWBR CPriceBox-module_productCardPrice__yjBVO"><div class="CPriceBox-module_priceContainer__ZROpc" style="height:26px"><span style="font-size:14px;line-height:16px;font-weight:800" class="CPriceBox-module_price__bYk-c" data-testid="discountedPrice">18,50<!-- -->₺</span></div></div></div></div></div></div></a></div></div>
+<a href="/mis-uht-sut-laktozsuz-1-l-p-5764"><div class="CProductCard-module_productCardWrapper__okAmT CProductCard-module_PLPCard__rB4tw"><div class="CQuantityChangerCapsule-module_buttonWrapper__Bed1d CQuantityChangerCapsule-module_singleButtonWrapper__oGhYN CQuantityChangerCapsule-module_small__2YPFl" style="position:absolute;right:8px;top:8px"><button class="CQuantityChangerCapsule-module_plusButton__ABlui CQuantityChangerCapsule-module_small__2YPFl" type="button" style="background-color:#e6eef6;border:1px solid #cddcec"><svg width="14" height="14" viewBox="0 0 12 12" fill="#0551a0" xmlns="http://www.w3.org/2000/svg"><path d="M10.9286 4.92857H7.28571C7.16738 4.92857 7.07143 4.83262 7.07143 4.71429V1.07143C7.07143 0.479736 6.59169 0 6 0C5.40831 0 4.92857 0.479736 4.92857 1.07143V4.71429C4.92857 4.83262 4.83262 4.92857 4.71429 4.92857H1.07143C0.479736 4.92857 0 5.40831 0 6C0 6.59169 0.479736 7.07143 1.07143 7.07143H4.71429C4.83262 7.07143 4.92857 7.16738 4.92857 7.28571V10.9286C4.92857 11.5203 5.40831 12 6 12C6.59169 12 7.07143 11.5203 7.07143 10.9286V7.28571C7.07143 7.16738 7.16738 7.07143 7.28571 7.07143H10.9286C11.5203 7.07143 12 6.59169 12 6C12 5.40831 11.5203 4.92857 10.9286 4.92857Z" fill="#0551a0"></path></svg></button></div><div class="CProductCard-module_productCardContainer__mwUl7"><div class="CProductCard-module_containerTop__35Ma3"><div class="CProductCard-module_imageContainer__aTMdz"><img src="https://images.ceptesok.com/cdn-cgi/image/width=216,height=216,fit=pad,quality=80,format=webp/product-assets/sub-folder/d2400ad5-2c0a-4f50-af14-e3b763a582f0.jpg" alt="product-thumb" style="width:108px;height:108px"/></div><div class="CProductCard-module_infoContainer__F8uxY"><h2 class="CProductCard-module_title__u8bMW">Mis Uht Süt Laktozsuz 1 L</h2><div class="CPriceBox-module_cPriceBox__1OWBR CPriceBox-module_productCardPrice__yjBVO"><div class="CPriceBox-module_priceContainer__ZROpc" style="height:26px"><span style="font-size:14px;line-height:16px;font-weight:800" class="CPriceBox-module_price__bYk-c" data-testid="discountedPrice">62,50<!-- -->₺</span></div></div></div></div></div></div></a></div></div>
+<a href="/icim-rahat-laktozsuz-sut-1-l-p-8430"><div class="CProductCard-module_productCardWrapper__okAmT CProductCard-module_PLPCard__rB4tw"><div class="CQuantityChangerCapsule-module_buttonWrapper__Bed1d CQuantityChangerCapsule-module_singleButtonWrapper__oGhYN CQuantityChangerCapsule-module_small__2YPFl" style="position:absolute;right:8px;top:8px"><button class="CQuantityChangerCapsule-module_plusButton__ABlui CQuantityChangerCapsule-module_small__2YPFl" type="button" style="background-color:#e6eef6;border:1px solid #cddcec"><svg width="14" height="14" viewBox="0 0 12 12" fill="#0551a0" xmlns="http://www.w3.org/2000/svg"><path d="M10.9286 4.92857H7.28571C7.16738 4.92857 7.07143 4.83262 7.07143 4.71429V1.07143C7.07143 0.479736 6.59169 0 6 0C5.40831 0 4.92857 0.479736 4.92857 1.07143V4.71429C4.92857 4.83262 4.83262 4.92857 4.71429 4.92857H1.07143C0.479736 4.92857 0 5.40831 0 6C0 6.59169 0.479736 7.07143 1.07143 7.07143H4.71429C4.83262 7.07143 4.92857 7.16738 4.92857 7.28571V10.9286C4.92857 11.5203 5.40831 12 6 12C6.59169 12 7.07143 11.5203 7.07143 10.9286V7.28571C7.07143 7.16738 7.16738 7.07143 7.28571 7.07143H10.9286C11.5203 7.07143 12 6.59169 12 6C12 5.40831 11.5203 4.92857 10.9286 4.92857Z" fill="#0551a0"></path></svg></button></div><div class="CProductCard-module_productCardContainer__mwUl7"><div class="CProductCard-module_containerTop__35Ma3"><div class="CProductCard-module_imageContainer__aTMdz"><img src="https://images.ceptesok.com/cdn-cgi/image/width=216,height=216,fit=pad,quality=80,format=webp/product-assets/sub-folder/4124dddf-9975-4384-aa45-0f5bce002055.png" alt="product-thumb" style="width:108px;height:108px"/></div><div class="CProductCard-module_infoContainer__F8uxY"><h2 class="CProductCard-module_title__u8bMW">İçim Rahat Laktozsuz Süt 1 L</h2><div class="CPriceBox-module_cPriceBox__1OWBR CPriceBox-module_productCardPrice__yjBVO"><div class="CPriceBox-module_priceContainer__ZROpc" style="height:26px"><span style="font-size:14px;line-height:16px;font-weight:800" class="CPriceBox-module_price__bYk-c" data-testid="discountedPrice">79,50<!-- -->₺</span></div></div></div></div></div></div></a></div></div>
+<a href="/mis-kakaolu-sut-200-ml-p-7284"><div class="CProductCard-module_productCardWrapper__okAmT CProductCard-module_PLPCard__rB4tw"><div class="CQuantityChangerCapsule-module_buttonWrapper__Bed1d CQuantityChangerCapsule-module_singleButtonWrapper__oGhYN CQuantityChangerCapsule-module_small__2YPFl" style="position:absolute;right:8px;top:8px"><button class="CQuantityChangerCapsule-module_plusButton__ABlui CQuantityChangerCapsule-module_small__2YPFl" type="button" style="background-color:#e6eef6;border:1px solid #cddcec"><svg width="14" height="14" viewBox="0 0 12 12" fill="#0551a0" xmlns="http://www.w3.org/2000/svg"><path d="M10.9286 4.92857H7.28571C7.16738 4.92857 7.07143 4.83262 7.07143 4.71429V1.07143C7.07143 0.479736 6.59169 0 6 0C5.40831 0 4.92857 0.479736 4.92857 1.07143V4.71429C4.92857 4.83262 4.83262 4.92857 4.71429 4.92857H1.07143C0.479736 4.92857 0 5.40831 0 6C0 6.59169 0.479736 7.07143 1.07143 7.07143H4.71429C4.83262 7.07143 4.92857 7.16738 4.92857 7.28571V10.9286C4.92857 11.5203 5.40831 12 6 12C6.59169 12 7.07143 11.5203 7.07143 10.9286V7.28571C7.07143 7.16738 7.16738 7.07143 7.28571 7.07143H10.9286C11.5203 7.07143 12 6.59169 12 6C12 5.40831 11.5203 4.92857 10.9286 4.92857Z" fill="#0551a0"></path></svg></button></div><div class="CProductCard-module_productCardContainer__mwUl7"><div class="CProductCard-module_containerTop__35Ma3"><div class="CProductCard-module_imageContainer__aTMdz"><img src="https://images.ceptesok.com/cdn-cgi/image/width=216,height=216,fit=pad,quality=80,format=webp/product-assets/sub-folder/964c914f-6190-4eaa-b8a7-dd0dd9c4e92f.jpg" alt="product-thumb" style="width:108px;height:108px"/></div><div class="CProductCard-module_infoContainer__F8uxY"><h2 class="CProductCard-module_title__u8bMW">Mis Kakaolu Süt 200 ml</h2><div class="CPriceBox-module_cPriceBox__1OWBR CPriceBox-module_productCardPrice__yjBVO"><div class="CPriceBox-module_discountedPriceContainer__nsaTN"><div class="CPriceBox-module_price__bYk-c"><span style="font-size:12px;line-height:16px" data-testid="price">16,50<!-- -->₺</span></div><span style="font-size:18px;line-height:16px" class="CPriceBox-module_discountedPrice__15Ffw" data-testid="discountedPrice">15,00<!-- -->₺</span></div></div></div></div></div></div></a></div></div>
+</body></html>

sok_mcp-0.1.0/tests/test_live.py

@@ -0,0 +1,64 @@
+"""Live tests — hit the real sokmarket.com.tr. Cautious: a few requests, then stop.
+
+Run:  pytest tests/test_live.py -v
+Skip: pytest -m "not live"  (or set SOK_SKIP_LIVE=1)
+"""
+import os
+import pathlib
+import sys
+import time
+import unittest
+
+import pytest
+
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parent.parent / "src"))
+
+from sok_mcp import http as _http
+from sok_mcp import products as _P
+
+pytestmark = pytest.mark.live
+SKIP = os.environ.get("SOK_SKIP_LIVE") == "1"
+
+
+@pytest.mark.skipif(SKIP, reason="SOK_SKIP_LIVE=1")
+class TestLive(unittest.TestCase):
+    def test_search_is_real(self):
+        res = _P.parse_product_cards(_http.fetch_search("süt"))
+        self.assertGreaterEqual(res["total"], 50)
+        self.assertGreaterEqual(len(res["products"]), 10)
+        self.assertTrue(all(p["price_try"] for p in res["products"]))
+        print(f"\nLIVE search 'süt': {res['total']} products, "
+              f"first = {res['products'][0]['title']} @ {res['products'][0]['price_try']}₺")
+        time.sleep(1)
+
+    def test_product_is_real(self):
+        res = _P.parse_product_cards(_http.fetch_search("süt"))
+        first = res["products"][0]
+        page = _P.parse_product_page(_http.fetch_product(first["url"]))
+        self.assertEqual(page["title"], first["title"])
+        self.assertEqual(page["price_try"], first["price_try"])
+        print(f"\nLIVE product: {page['title']} @ {page['price_try']}₺, "
+              f"{len(page['related_products'])} related")
+        time.sleep(1)
+
+    def test_home_categories_are_real(self):
+        cats = _P.parse_categories(_http.fetch_home())
+        self.assertGreaterEqual(len(cats), 15)
+        print(f"\nLIVE home: {len(cats)} categories, first = {cats[0]['name']}")
+        time.sleep(1)
+
+    def test_campaigns_are_real(self):
+        promos = _P.parse_promotions(_http.fetch_campaigns())
+        self.assertGreaterEqual(len(promos), 1)
+        print(f"\nLIVE campaigns: {len(promos)} — {[p['name'] for p in promos]}")
+        time.sleep(1)
+
+    def test_category_page_is_real(self):
+        res = _P.parse_product_cards(_http.fetch_category("sut-ve-sut-urunleri-c-460"))
+        self.assertGreaterEqual(len(res["products"]), 10)
+        print(f"\nLIVE category süt: {len(res['products'])} products on first page")
+        time.sleep(1)
+
+
+if __name__ == "__main__":
+    unittest.main()

sok_mcp-0.1.0/tests/test_products.py

@@ -0,0 +1,84 @@
+"""Offline tests — parse real captured ŞOK fixtures, no network."""
+import pathlib
+import sys
+import unittest
+
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parent.parent / "src"))
+
+from sok_mcp import products as P
+
+FIX = pathlib.Path(__file__).resolve().parent / "fixtures"
+
+
+class TestSearchCards(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        cls.res = P.parse_product_cards((FIX / "search.html").read_text(encoding="utf-8"))
+
+    def test_total(self):
+        self.assertEqual(self.res["total"], 207)
+
+    def test_card_count_and_first(self):
+        self.assertEqual(len(self.res["products"]), 10)
+        first = self.res["products"][0]
+        self.assertEqual(first["title"], "Mis Uht Süt Yarım Yağlı 1 L")
+        self.assertEqual(first["id"], "5834")
+        self.assertEqual(first["price_try"], 43.5)
+        self.assertTrue(first["url"].endswith("-p-5834"))
+
+    def test_prices(self):
+        by_id = {p["id"]: p for p in self.res["products"]}
+        self.assertEqual(by_id["7796"]["price_try"], 88.5)
+        self.assertEqual(by_id["5179"]["price_try"], 36.0)
+
+    def test_stats(self):
+        s = P.price_stats(self.res["products"])
+        self.assertEqual(s["count"], 10)
+        self.assertEqual(s["min_try"], 16.5)
+        self.assertEqual(s["max_try"], 88.5)
+        self.assertEqual(s["median_try"], 55.75)
+        self.assertEqual(s["mean_try"], 52.05)
+
+    def test_empty_stats(self):
+        self.assertEqual(P.price_stats([])["count"], 0)
+        self.assertIsNone(P.price_stats([])["min_try"])
+
+
+class TestProductPage(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        cls.p = P.parse_product_page((FIX / "product.html").read_text(encoding="utf-8"))
+
+    def test_title_and_price(self):
+        self.assertEqual(self.p["title"], "Ahmad Tea Classic Earl Grey Demlik Poşet 40'lı")
+        self.assertEqual(self.p["price_try"], 149.0)
+
+    def test_no_title_raises(self):
+        with self.assertRaises(ValueError):
+            P.parse_product_page("<html><body>no h1</body></html>")
+
+
+class TestHomeAndCampaigns(unittest.TestCase):
+    def test_categories(self):
+        cats = P.parse_categories((FIX / "home.html").read_text(encoding="utf-8"))
+        self.assertEqual(len(cats), 19)
+        by_id = {c["id"]: c for c in cats}
+        self.assertEqual(by_id["460"]["name"], "Süt & Süt Ürünleri")
+        self.assertEqual(by_id["20"]["slug"], "meyve-ve-sebze")
+
+    def test_promotions(self):
+        promos = P.parse_promotions((FIX / "kampanyalar.html").read_text(encoding="utf-8"))
+        self.assertEqual(len(promos), 2)
+        names = [p["name"] for p in promos]
+        self.assertIn("Kazandırır Alışverişin", names)
+        self.assertIn("Kasa Arkası Ürünler", names)
+
+    def test_price_parsing(self):
+        self.assertEqual(P.parse_price("43,50"), 43.5)
+        self.assertEqual(P.parse_price("1.234,56"), 1234.56)
+        self.assertIsNone(P.parse_price("fiyat yok"))
+        self.assertIsNone(P.parse_price(None))
+
+
+if __name__ == "__main__":
+    unittest.main()