billiger-mcp 0.1.0__tar.gz

billiger_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

billiger_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

billiger_mcp-0.1.0/.github/workflows/smoke.yml

@@ -0,0 +1,21 @@
+name: Daily live smoke
+
+# One fixed probe per day: catches fingerprint rot / bot-wall changes
+# before users hit them. Fails visibly on 403/timeout.
+on:
+  schedule:
+    - cron: "0 6 * * *"
+  workflow_dispatch:
+
+jobs:
+  smoke:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install
+        run: pip install -e .
+      - name: Smoke probe
+        run: python tests/smoke_live.py

billiger_mcp-0.1.0/LICENSE

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

billiger_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.5
+Name: billiger-mcp
+Version: 0.1.0
+Summary: Unofficial read-only MCP server for billiger.de — German price comparison
+Author: Mohammad Abbasi
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp<2
+Description-Content-Type: text/markdown
+
+# billiger-mcp 🛒
+
+mcp-name: io.github.mohammad-abbasi-sh/billiger-mcp
+
+Unofficial **read-only** MCP server for **[billiger.de](https://www.billiger.de)** — German price comparison from billiger.de (free, no key, no login): search products with best prices, compare shop offers, and today's deals. No key, no login.
+
+> Built by Mohammad Abbasi as part of the "Germany MCP factory". Not affiliated with billiger.de.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "billiger": {
+      "command": "uvx",
+      "args": ["billiger-mcp==0.1.0"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m billiger_mcp.server` (needs `mcp<2`, `httpx`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `billiger_search_prices` | Search billiger.de products by name: best price, offer count, rating — `query`, `limit` 1..20 |
+| `billiger_product_offers` | Compare shop offers for one product (shop, price, shipping, total, delivery) — `product` (billiger.de URL, baseproducts id or slug), `limit` 1..20 |
+| `billiger_best_deals` | Today's deals from the billiger.de home page: product, best price, offer count — `limit` 1..20 |
+| `billiger_health` | Reachability probe (ok / blocked / error) — one polite request |
+
+## Development
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest
+.venv/bin/pip install -e .
+.venv/bin/python -m pytest tests/ -q
+```
+
+## License
+
+MIT
+
+---
+
+Built by [Mohammad Abbasi](https://github.com/mohammad-abbasi-sh) — [Almanibama](https://almanibama.ir) · [mabbasi.ir](https://mabbasi.ir)

billiger_mcp-0.1.0/README-de.md

@@ -0,0 +1,49 @@
+# billiger-mcp 🛒
+
+mcp-name: io.github.mohammad-abbasi-sh/billiger-mcp
+
+Inoffizieller **nur lesender** MCP-Server für **[billiger.de](https://www.billiger.de)** — Deutscher Preisvergleich von billiger.de (kostenlos, kein Schlüssel, kein Login): Produkte mit Bestpreisen suchen, Shop-Angebote vergleichen und Tagesdeals. Kein Schlüssel, keine Anmeldung.
+
+> Gebaut von Mohammad Abbasi als Teil der "Germany MCP factory". Nicht mit billiger.de verbunden.
+
+## Für KI-Agenten
+
+Zur MCP-Client-Konfiguration hinzufügen (stdio):
+
+```json
+{
+  "mcpServers": {
+    "billiger": {
+      "command": "uvx",
+      "args": ["billiger-mcp==0.1.0"]
+    }
+  }
+}
+```
+
+Oder lokal starten: `python -m billiger_mcp.server` (benötigt `mcp<2`, `httpx`).
+
+## Tools
+
+| Tool | Beschreibung |
+|------|-------------|
+| `billiger_search_prices` | Produkte mit Bestpreisen suchen |
+| `billiger_product_offers` | Shop-Angebote für ein Produkt vergleichen |
+| `billiger_best_deals` | Tagesdeals von der Startseite |
+| `billiger_health` | Erreichbarkeitsprüfung (ok / blocked / error) — eine höfliche Anfrage |
+
+## Entwicklung
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest
+.venv/bin/pip install -e .
+.venv/bin/python -m pytest tests/ -q
+```
+
+## Lizenz
+
+MIT
+
+---
+
+Built by [Mohammad Abbasi](https://github.com/mohammad-abbasi-sh) — [Almanibama](https://almanibama.ir) · [mabbasi.ir](https://mabbasi.ir)

billiger_mcp-0.1.0/README-fa.md

@@ -0,0 +1,49 @@
+# billiger-mcp 🛒
+
+mcp-name: io.github.mohammad-abbasi-sh/billiger-mcp
+
+سرور MCP غیررسمی و **فقط‌خواندنی** برای **[billiger.de](https://www.billiger.de)** — مقایسهٔ قیمت آلمان از billiger.de (رایگان، بدون کلید): جست‌وجوی محصولات با بهترین قیمت، مقایسهٔ پیشنهادهای فروشگاه‌ها و تخفیف‌های روز. بدون کلید، بدون ورود.
+
+> ساختهٔ محمد عباسی، بخشی از «کارخانهٔ MCP آلمان». وابسته به billiger.de نیست.
+
+## برای ایجنت‌های هوش مصنوعی
+
+به پیکربندی MCP کلاینت اضافه کنید (stdio):
+
+```json
+{
+  "mcpServers": {
+    "billiger": {
+      "command": "uvx",
+      "args": ["billiger-mcp==0.1.0"]
+    }
+  }
+}
+```
+
+یا به‌صورت محلی اجرا کنید: `python -m billiger_mcp.server` (نیازمند `mcp<2` و `httpx`).
+
+## ابزارها
+
+| ابزار | توضیح |
+|------|-------|
+| `billiger_search_prices` | جست‌وجوی محصولات با بهترین قیمت |
+| `billiger_product_offers` | مقایسهٔ پیشنهادهای فروشگاه‌ها برای یک محصول |
+| `billiger_best_deals` | تخفیف‌های روز از صفحهٔ اصلی |
+| `billiger_health` | بررسی دسترس‌پذیری (ok / blocked / error) — یک درخواست مؤدبانه |
+
+## توسعه
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest
+.venv/bin/pip install -e .
+.venv/bin/python -m pytest tests/ -q
+```
+
+## لایسنس
+
+MIT
+
+---
+
+Built by [Mohammad Abbasi](https://github.com/mohammad-abbasi-sh) — [Almanibama](https://almanibama.ir) · [mabbasi.ir](https://mabbasi.ir)

billiger_mcp-0.1.0/README.md

@@ -0,0 +1,49 @@
+# billiger-mcp 🛒
+
+mcp-name: io.github.mohammad-abbasi-sh/billiger-mcp
+
+Unofficial **read-only** MCP server for **[billiger.de](https://www.billiger.de)** — German price comparison from billiger.de (free, no key, no login): search products with best prices, compare shop offers, and today's deals. No key, no login.
+
+> Built by Mohammad Abbasi as part of the "Germany MCP factory". Not affiliated with billiger.de.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "billiger": {
+      "command": "uvx",
+      "args": ["billiger-mcp==0.1.0"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m billiger_mcp.server` (needs `mcp<2`, `httpx`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `billiger_search_prices` | Search billiger.de products by name: best price, offer count, rating — `query`, `limit` 1..20 |
+| `billiger_product_offers` | Compare shop offers for one product (shop, price, shipping, total, delivery) — `product` (billiger.de URL, baseproducts id or slug), `limit` 1..20 |
+| `billiger_best_deals` | Today's deals from the billiger.de home page: product, best price, offer count — `limit` 1..20 |
+| `billiger_health` | Reachability probe (ok / blocked / error) — one polite request |
+
+## Development
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest
+.venv/bin/pip install -e .
+.venv/bin/python -m pytest tests/ -q
+```
+
+## License
+
+MIT
+
+---
+
+Built by [Mohammad Abbasi](https://github.com/mohammad-abbasi-sh) — [Almanibama](https://almanibama.ir) · [mabbasi.ir](https://mabbasi.ir)

billiger_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "billiger-mcp"
+version = "0.1.0"
+description = "Unofficial read-only MCP server for billiger.de — German price comparison"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+dependencies = [
+    "mcp<2",
+    "httpx>=0.27",
+]
+authors = [{ name = "Mohammad Abbasi" }]
+
+[project.scripts]
+billiger-mcp = "billiger_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/billiger_mcp"]
+
+[tool.pytest.ini_options]
+markers = ["live: tests that hit the real https://www.billiger.de site"]

billiger_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 billiger.de — German price comparison.", "name": "io.github.mohammad-abbasi-sh/billiger-mcp", "packages": [{"identifier": "billiger-mcp", "registryBaseUrl": "https://pypi.org", "registryType": "pypi", "transport": {"type": "stdio"}, "version": "0.1.0"}], "repository": {"source": "github", "url": "https://github.com/mohammad-abbasi-sh/billiger-mcp"}, "title": "billiger.de — German price comparison: best prices, shop offers & deals", "version": "0.1.0", "websiteUrl": "https://github.com/mohammad-abbasi-sh/billiger-mcp"}

billiger_mcp-0.1.0/src/billiger_mcp/__init__.py

@@ -0,0 +1,7 @@
+"""billiger_mcp — unofficial read-only MCP server for billiger.de.
+
+German price comparison from billiger.de (free, no key, no login): search products with best prices, compare shop offers, and today's deals.
+"""
+from __future__ import annotations
+
+__version__ = "0.1.0"

billiger_mcp-0.1.0/src/billiger_mcp/domain.py

@@ -0,0 +1,197 @@
+"""Domain logic: shape billiger.de's server-rendered HTML into
+compact dicts (stdlib only, regex parsers).
+
+Data source: https://www.billiger.de — free, no key, no login.
+The site sits behind Cloudflare: a bare UA + Accept gets the 403
+"Just a moment..." challenge page; the full browser navigation
+header set in http.py (sec-ch-ua / sec-fetch, verified 2026-11-10)
+lets the real HTML through.
+
+Pages (verified 2026-11-10):
+- GET /search?searchstring=<q> — 302s to the matching category
+  page (e.g. /categories/4373/53176-apple-handys-ohne-vertrag) or
+  to /noresult?searchstring=<q> when nothing matches.
+- Product cards (search + home share the structure):
+  <a href="/baseproducts/<id>-<slug>" title="<name>"> …
+  <span class="line-clamp-2…"> <name> </span> …
+  <div … data-bde-price=""> <strong … data-price> <span>ab</span>
+  839,99 €* </strong> </div> … <div> 418 Preise vergleichen </div>
+  rating: <div … style="--rating: 92"></div> <span>(173)</span>
+- GET /baseproducts/<id>-<slug> — product page; offer rows are
+  <div … data-product-id="<offer-id>" data-bde-card=""> …
+  variant <div … title="<variant>">, shop <img alt="Shop <shop>">,
+  seller "Verkäufer: <name>" + --rating, price <span data-price>
+  877,89 €*, "ab 0,00 € Versand", "877,89 € Gesamt",
+  "Lieferzeit: 1-5 Werktage". First 20 offers are SSR; the page
+  total (e.g. 385) is in the meta description.
+- GET / (home) — deals: same product-card structure; 37
+  /baseproducts/ links on 2026-11-10.
+- Price history: NOT in the SSR HTML — the chart is a JS
+  component (data-pricehistory-container, empty server-side) with
+  no data endpoint in the page. No price_history tool: the data
+  is not fetchable read-only from the HTML.
+"""
+from __future__ import annotations
+
+import html as _html
+import re
+from urllib.parse import quote_plus
+
+BASE = "https://www.billiger.de"
+
+_CARD_RE = re.compile(
+    r'<a[^>]+href="/baseproducts/(\d+)-([^"]+)"[^>]*>',
+    re.IGNORECASE)
+_NAME_RE = re.compile(
+    r'<span class="line-clamp-2[^"]*">\s*([^<]+?)\s*</span>')
+_PRICE_RE = re.compile(
+    r'data-(?:sales-)?price[^>]*>(?:\s*<span[^>]*>ab</span>)?\s*([\d.]+,\d{2})\s*€')
+_WAS_PRICE_RE = re.compile(
+    r'line-through">([\d.]+,\d{2})\s*€</span>')
+_OFFERS_RE = re.compile(r'(\d[\d.]*)\s+Preise vergleichen')
+_RATING_RE = re.compile(r'--rating:\s*(\d+)')
+_REVIEWS_RE = re.compile(r'\((\d+)\)')
+
+_OFFER_RE = re.compile(r'data-product-id="(\d+)"')
+_VARIANT_RE = re.compile(
+    r'<div class="order-1[^"]*" title="([^"]+)">')
+_SHOP_RE = re.compile(r'<img[^>]+alt="Shop ([^"]+)"')
+_SELLER_RE = re.compile(r'Verkäufer:\s*([^"<]+)')
+_SHIP_RE = re.compile(r'ab\s+([\d.]+,\d{2})\s*€ Versand')
+_TOTAL_RE = re.compile(r'([\d.]+,\d{2})\s*€ Gesamt')
+_DELIVERY_RE = re.compile(r'Lieferzeit:\s*([^<]+)')
+
+
+def validate_query(query: str) -> str:
+    q = (query or "").strip()
+    if not q:
+        raise ValueError("query must not be empty")
+    if len(q) > 100:
+        raise ValueError("query too long (max 100 characters)")
+    return q
+
+
+def validate_limit(limit: int, maximum: int = 20) -> int:
+    if not 1 <= limit <= maximum:
+        raise ValueError(
+            f"limit out of range: {limit} (expected 1..{maximum})")
+    return limit
+
+
+def search_url(query: str) -> str:
+    return f"{BASE}/search?searchstring={quote_plus(query)}"
+
+
+def resolve_product_url(product: str) -> str:
+    """Full billiger.de URL, a baseproducts slug, or a bare numeric
+    id (the site 301s /baseproducts/<id> to the canonical slug
+    URL)."""
+    p = (product or "").strip()
+    if not p:
+        raise ValueError("product must not be empty")
+    if p.startswith("http"):
+        if "billiger.de/baseproducts/" not in p:
+            raise ValueError(
+                "product URL must be a billiger.de /baseproducts/ URL")
+        return p
+    if p.startswith("/baseproducts/"):
+        return BASE + p
+    m = re.match(r"^(\d+)(?:-([A-Za-z0-9-]+))?$", p)
+    if not m:
+        raise ValueError(
+            "product must be a billiger.de URL, a baseproducts slug "
+            "(e.g. 114326-apple-iphone-17) or a numeric id")
+    if m.group(2):
+        return f"{BASE}/baseproducts/{m.group(1)}-{m.group(2)}"
+    return f"{BASE}/baseproducts/{m.group(1)}"
+
+
+def parse_de_price(text: str) -> float:
+    """German price string ("2.999,00") -> float."""
+    return float(text.replace(".", "").replace(",", "."))
+
+
+def parse_cards(page_html: str) -> list[dict]:
+    """Product cards from a search/category/home page, deduped by
+    product id, in page order. [] when the page has no products
+    (e.g. the /noresult page)."""
+    out: list[dict] = []
+    seen: set[str] = set()
+    for m in _CARD_RE.finditer(page_html):
+        pid, slug = m.group(1), m.group(2)
+        if pid in seen:
+            continue
+        seen.add(pid)
+        chunk = page_html[m.start():m.start() + 2500]
+        name_m = _NAME_RE.search(chunk)
+        price_m = _PRICE_RE.search(chunk)
+        offers_m = _OFFERS_RE.search(chunk)
+        rating_m = _RATING_RE.search(chunk)
+        reviews_m = _REVIEWS_RE.search(chunk)
+        name = _html.unescape(
+            name_m.group(1).strip()) if name_m else None
+        # fallback: the link's title attribute
+        if not name:
+            t = re.search(r'title="([^"]+)"', m.group(0))
+            name = _html.unescape(t.group(1)) if t else slug
+        out.append({
+            "id": pid,
+            "name": name,
+            "url": f"{BASE}/baseproducts/{pid}-{slug}",
+            "price_from_eur": (parse_de_price(price_m.group(1))
+                               if price_m else None),
+            "offers": (int(offers_m.group(1).replace(".", ""))
+                       if offers_m else None),
+            "rating_pct": int(rating_m.group(1)) if rating_m else None,
+            "reviews": int(reviews_m.group(1)) if reviews_m else None,
+        })
+    return out
+
+
+def parse_offers(page_html: str) -> dict:
+    """{product_name, price_from_eur, total_offers, offers: [{shop,
+    seller, variant, price_eur, shipping_eur, total_eur,
+    delivery, shop_rating_pct}]} — first 20 offers are SSR."""
+    name_m = re.search(
+        r'<meta property="og:title" content="([^"]+?)(?:💥|$)', page_html)
+    total_m = re.search(r'–\s*([\d.]+)\s+Angebote', page_html)
+    offers: list[dict] = []
+    for m in _OFFER_RE.finditer(page_html):
+        chunk = page_html[m.start():m.start() + 4500]
+        variant_m = _VARIANT_RE.search(chunk)
+        shop_m = _SHOP_RE.search(chunk)
+        seller_m = _SELLER_RE.search(chunk)
+        price_m = _PRICE_RE.search(chunk)
+        was_m = _WAS_PRICE_RE.search(chunk)
+        ship_m = _SHIP_RE.search(chunk)
+        total_m2 = _TOTAL_RE.search(chunk)
+        deliv_m = _DELIVERY_RE.search(chunk)
+        rating_m = _RATING_RE.search(chunk)
+        if not shop_m and not price_m:
+            continue
+        offers.append({
+            "shop": shop_m.group(1) if shop_m else None,
+            "seller": (seller_m.group(1).strip()
+                       if seller_m else None),
+            "variant": (variant_m.group(1).strip()
+                        if variant_m else None),
+            "price_eur": (parse_de_price(price_m.group(1))
+                          if price_m else None),
+            "was_price_eur": (parse_de_price(was_m.group(1))
+                              if was_m else None),
+            "shipping_eur": (parse_de_price(ship_m.group(1))
+                             if ship_m else None),
+            "total_eur": (parse_de_price(total_m2.group(1))
+                          if total_m2 else None),
+            "delivery": (deliv_m.group(1).strip()
+                         if deliv_m else None),
+            "shop_rating_pct": (int(rating_m.group(1))
+                                if rating_m else None),
+        })
+    return {
+        "product_name": (_html.unescape(name_m.group(1).strip())
+                         if name_m else None),
+        "total_offers": (int(total_m.group(1).replace(".", ""))
+                         if total_m else len(offers)),
+        "offers": offers,
+    }