yemek-com-mcp 0.1.0__tar.gz

yemek_com_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

yemek_com_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

yemek_com_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.5
+Name: yemek-com-mcp
+Version: 0.1.0
+Summary: Unofficial read-only MCP server for Yemek.com Turkish recipes (search, full recipes, categories, daily picks)
+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
+
+# yemek-com-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/yemek-com-mcp
+
+Unofficial **read-only** MCP server for **Yemek.com** — Türkiye's recipe site: search recipes, full recipe details (ingredients, steps, times, servings, ratings), featured categories, the daily "Bugün Ne Pişirsem?" picks, video recipes and the most popular recipes.
+
+> Part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with Yemek.com.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "yemek-com": {
+      "command": "uvx",
+      "args": ["yemek-com-mcp"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m yemek_com_mcp.server` (needs `mcp<2`, `curl-cffi`, `requests`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `yemek_search_recipes` | Search recipes by dish/ingredient — `query`, `limit` (1..30). Uses the site's public search JSON |
+| `yemek_get_recipe` | Full recipe — `slug` (e.g. `mercimek-corbasi`) or a full yemek.com/tarif/... URL |
+| `yemek_list_categories` | Featured recipe categories + recipe counts |
+| `yemek_list_trending` | Today's "Bugün Ne Pişirsem?" picks (15 recipes) |
+| `yemek_list_videos` | Video recipes from the homepage ("Videolu Tarifler") |
+| `yemek_list_popular` | Most popular recipes ("Popüler Yemek Tarifleri") |
+
+Example output (`yemek_search_recipes` / "mercimek"):
+
+```json
+{"query": "mercimek", "total_recipes": 533, "total_posts": 822,
+ "recipes": [{"title": "Lokanta Usulünde: 4 Kişilik Mercimek Çorbası",
+   "slug": "4-kisilik-mercimek-corbasi", "prep_time": "15dk",
+   "category": "ÇORBA", "author": "filizssweetbakery"}]}
+```
+
+Example output (`yemek_get_recipe` / "mercimek-corbasi"):
+
+```json
+{"name": "Mercimek Çorbası (Lokanta Usulü)", "servings": "6 kişilik",
+ "total_time": "PT60M", "rating": 4.3, "rating_count": 230,
+ "ingredients": ["3 yemek kaşığı ayçiçek yağı", "1,5 su bardağı kırmızı ya da sarı mercimek", "..."],
+ "instructions": ["Mercimek çorbası için derin bir tencereye ...", "..."]}
+```
+
+Notes:
+- Search results page in 3 recipes per request — the server paginates automatically.
+- Times are ISO 8601 durations (`PT60M`) or Turkish shorthand (`15dk`); servings are Turkish (`6 kişilik`).
+- Data: yemek.com public pages + public search JSON (`/ara/sonuclar/`) — 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_recipes.py` — offline, parses real captured fixtures
+- `tests/test_live.py` — 5 cautious live requests against yemek.com
+
+## License
+
+MIT

yemek_com_mcp-0.1.0/README-fa.md

@@ -0,0 +1,40 @@
+# yemek-com-mcp 🇹🇷
+
+سرور MCP غیررسمی و **فقط‌خواندنی** برای **Yemek.com** — سایت دستور غذای ترکیه: جست‌وجوی دستورها، جزئیات کامل دستور (مواد، مراحل، زمان، تعداد نفرات، امتیاز)، دسته‌های ویژه، انتخاب‌های روزانه‌ی «Bugün Ne Pişirsem?» (امروز چی بپزم؟)، دستورهای ویدیویی و محبوب‌ترین دستورها.
+
+> بخشی از «کارخانه‌ی MCP ترکیه» (پایپ‌لاین به سبک سپهر). هیچ وابستگی به Yemek.com ندارد.
+
+## برای ایجنت‌های هوش مصنوعی
+
+```json
+{
+  "mcpServers": {
+    "yemek-com": {
+      "command": "uvx",
+      "args": ["yemek-com-mcp"]
+    }
+  }
+}
+```
+
+## ابزارها
+
+| ابزار | توضیح |
+|------|-------|
+| `yemek_search_recipes` | جست‌وجوی دستور با نام غذا یا ماده — `query`، ‏`limit` (۱ تا ۳۰) |
+| `yemek_get_recipe` | دستور کامل — `slug` (مثلاً `mercimek-corbasi`) یا URL کامل yemek.com/tarif/... |
+| `yemek_list_categories` | دسته‌های ویژه‌ی دستورها + تعداد دستور هر دسته |
+| `yemek_list_trending` | انتخاب‌های امروز «Bugün Ne Pişirsem؟» (۱۵ دستور) |
+| `yemek_list_videos` | دستورهای ویدیویی («Videolu Tarifler») |
+| `yemek_list_popular` | محبوب‌ترین دستورها («Popüler Yemek Tarifleri») |
+
+مثال (`yemek_search_recipes` / «mercimek»): ۵۳۳ دستور پیدا شد؛ اولین نتیجه «Lokanta Usulünde: 4 Kişilik Mercimek Çorbası» (آماده‌سازی ۱۵ دقیقه). مثال (`yemek_get_recipe` / «mercimek-corbasi»): ۶ نفره، مجموع ۶۰ دقیقه، امتیاز ۴٫۳ (۲۳۰ رأی)، ۱۲ ماده، ۸ مرحله.
+
+نکته‌ها:
+- نتایج جست‌وجو در هر درخواست ۳ دستور برمی‌گردانند — سرور خودکار صفحه‌بندی می‌کند.
+- زمان‌ها ISO 8601 (`PT60M`) یا مخفف ترکی (`15dk`) هستند؛ تعداد نفرات به ترکی است (`6 kişilik`).
+- داده: صفحات عمومی yemek.com + JSON عمومی جست‌وجو — بدون لاگین، بدون کلید، فقط‌خواندنی.
+
+## قوانین
+
+غیررسمی و فقط‌خواندنی — بدون لاگین، بدون کلید، بدون نوشتن. تست‌ها: آفلاین با فیکسچر + تست زنده (۲۰/۲۰ سبز).

yemek_com_mcp-0.1.0/README-tr.md

@@ -0,0 +1,42 @@
+# yemek-com-mcp 🇹🇷
+
+**Yemek.com** için gayriresmî, **salt-okunur** MCP sunucusu — Türkiye'nin tarif sitesi: tarif arama, tam tarif detayları (malzemeler, adımlar, süreler, porsiyon, puan), öne çıkan kategoriler, günün "Bugün Ne Pişirsem?" seçimleri, videolu tarifler ve en popüler tarifler.
+
+> "Türkiye MCP fabrikası" parçası (Sepehr tarzı pipeline). Yemek.com ile bağlantısı yoktur.
+
+## Yapay zekâ ajanları için
+
+MCP istemcinize ekleyin (stdio):
+
+```json
+{
+  "mcpServers": {
+    "yemek-com": {
+      "command": "uvx",
+      "args": ["yemek-com-mcp"]
+    }
+  }
+}
+```
+
+## Araçlar
+
+| Araç | Açıklama |
+|------|----------|
+| `yemek_search_recipes` | Yemek/malzeme ile tarif ara — `query`, `limit` (1..30). Sitenin herkese açık arama JSON'unu kullanır |
+| `yemek_get_recipe` | Tam tarif — `slug` (örn. `mercimek-corbasi`) veya tam yemek.com/tarif/... URL'si |
+| `yemek_list_categories` | Öne çıkan tarif kategorileri + tarif sayıları |
+| `yemek_list_trending` | Günün "Bugün Ne Pişirsem?" seçimleri (15 tarif) |
+| `yemek_list_videos` | Videolu tarifler ("Videolu Tarifler") |
+| `yemek_list_popular` | En popüler tarifler ("Popüler Yemek Tarifleri") |
+
+Örnek (`yemek_search_recipes` / "mercimek"): 533 tarif bulundu; ilk sonuç "Lokanta Usulünde: 4 Kişilik Mercimek Çorbası" (hazırlık 15dk). Örnek (`yemek_get_recipe` / "mercimek-corbasi"): 6 kişilik, toplam 60dk, puan 4.3 (230 oy), 12 malzeme, 8 adım.
+
+Notlar:
+- Arama sonuçları istek başına 3 tarif döner — sunucu otomatik sayfalar.
+- Süreler ISO 8601 (`PT60M`) veya Türkçe kısaltma (`15dk`); porsiyon Türkçe (`6 kişilik`).
+- Veri: yemek.com herkese açık sayfalar + arama JSON'u — giriş yok, API anahtarı yok, salt-okunur.
+
+## Kurallar
+
+Gayriresmî ve salt-okunur — giriş yok, API anahtarı yok, yazma yok. Testler: çevrimdışı fixture + canlı testler (20/20 yeşil).

yemek_com_mcp-0.1.0/README.md

@@ -0,0 +1,72 @@
+# yemek-com-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/yemek-com-mcp
+
+Unofficial **read-only** MCP server for **Yemek.com** — Türkiye's recipe site: search recipes, full recipe details (ingredients, steps, times, servings, ratings), featured categories, the daily "Bugün Ne Pişirsem?" picks, video recipes and the most popular recipes.
+
+> Part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with Yemek.com.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "yemek-com": {
+      "command": "uvx",
+      "args": ["yemek-com-mcp"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m yemek_com_mcp.server` (needs `mcp<2`, `curl-cffi`, `requests`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `yemek_search_recipes` | Search recipes by dish/ingredient — `query`, `limit` (1..30). Uses the site's public search JSON |
+| `yemek_get_recipe` | Full recipe — `slug` (e.g. `mercimek-corbasi`) or a full yemek.com/tarif/... URL |
+| `yemek_list_categories` | Featured recipe categories + recipe counts |
+| `yemek_list_trending` | Today's "Bugün Ne Pişirsem?" picks (15 recipes) |
+| `yemek_list_videos` | Video recipes from the homepage ("Videolu Tarifler") |
+| `yemek_list_popular` | Most popular recipes ("Popüler Yemek Tarifleri") |
+
+Example output (`yemek_search_recipes` / "mercimek"):
+
+```json
+{"query": "mercimek", "total_recipes": 533, "total_posts": 822,
+ "recipes": [{"title": "Lokanta Usulünde: 4 Kişilik Mercimek Çorbası",
+   "slug": "4-kisilik-mercimek-corbasi", "prep_time": "15dk",
+   "category": "ÇORBA", "author": "filizssweetbakery"}]}
+```
+
+Example output (`yemek_get_recipe` / "mercimek-corbasi"):
+
+```json
+{"name": "Mercimek Çorbası (Lokanta Usulü)", "servings": "6 kişilik",
+ "total_time": "PT60M", "rating": 4.3, "rating_count": 230,
+ "ingredients": ["3 yemek kaşığı ayçiçek yağı", "1,5 su bardağı kırmızı ya da sarı mercimek", "..."],
+ "instructions": ["Mercimek çorbası için derin bir tencereye ...", "..."]}
+```
+
+Notes:
+- Search results page in 3 recipes per request — the server paginates automatically.
+- Times are ISO 8601 durations (`PT60M`) or Turkish shorthand (`15dk`); servings are Turkish (`6 kişilik`).
+- Data: yemek.com public pages + public search JSON (`/ara/sonuclar/`) — 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_recipes.py` — offline, parses real captured fixtures
+- `tests/test_live.py` — 5 cautious live requests against yemek.com
+
+## License
+
+MIT

yemek_com_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "yemek-com-mcp"
+version = "0.1.0"
+description = "Unofficial read-only MCP server for Yemek.com Turkish recipes (search, full recipes, categories, daily picks)"
+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]
+yemek-com-mcp = "yemek_com_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/yemek_com_mcp"]

yemek_com_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 Yemek.com Turkish recipes — search, full recipes, categories.","name":"io.github.mohammad-abbasi-sh/yemek-com-mcp","packages":[{"identifier":"yemek-com-mcp","registryBaseUrl":"https://pypi.org","registryType":"pypi","transport":{"type":"stdio"},"version":"0.1.0"}],"repository":{"source":"github","url":"https://github.com/mohammad-abbasi-sh/yemek-com-mcp"},"title":"Yemek.com Recipes","version":"0.1.0","websiteUrl":"https://github.com/mohammad-abbasi-sh/yemek-com-mcp"}

yemek_com_mcp-0.1.0/src/yemek_com_mcp/__init__.py

@@ -0,0 +1,2 @@
+"""yemek_com_mcp — unofficial read-only MCP server for Yemek.com recipes."""
+__version__ = "0.1.0"

yemek_com_mcp-0.1.0/src/yemek_com_mcp/http.py

@@ -0,0 +1,101 @@
+"""HTTP layer for yemek_com_mcp.
+
+yemek.com serves its pages server-rendered with no login and no API
+key. Search is a public JSON endpoint the site's own search page
+calls (``/ara/sonuclar/?q=...&rows=...``) — no key, no session.
+Transport uses curl-cffi chrome120 impersonation (the proven
+Turkey-factory pattern) with a plain-requests fallback, so one
+transport failing does not break the server. 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://yemek.com"
+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 YemekError(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, accept_json: bool = False) -> str:
+    _throttle()
+    headers = dict(_HEADERS)
+    if accept_json:
+        headers["Accept"] = "application/json, text/plain, */*"
+    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 YemekError(f"network error fetching {url}: {e}") from e
+    if status == 403:
+        raise YemekError("yemek.com refused the request (HTTP 403, bot wall) — try again later")
+    if status == 429:
+        raise YemekError("yemek.com rate-limited the request (HTTP 429) — try again later")
+    if status == 404:
+        raise YemekError(f"yemek.com has no page at {url} (HTTP 404)")
+    if status != 200:
+        raise YemekError(f"yemek.com returned HTTP {status} for {url}")
+    return text
+
+
+def fetch_search_json(query: str, rows: int = 12, recipes_start: int = 0, posts_start: int = 0) -> str:
+    """Public search JSON: /ara/sonuclar/?q=<query>&rows=<n>.
+    Recipes come back 3 per page — paginate with recipes_start."""
+    url = (
+        f"{BASE}/ara/sonuclar/?q={quote(query)}&rows={rows}"
+        f"&recipes_start={recipes_start}&posts_start={posts_start}"
+    )
+    return _get(url, accept_json=True)
+
+
+def fetch_recipe_page(slug: str) -> str:
+    return _get(f"{BASE}/tarif/{slug}/")
+
+
+def fetch_home() -> str:
+    return _get(f"{BASE}/")
+
+
+def fetch_bugun() -> str:
+    return _get(f"{BASE}/bugun-ne-pisirsem/")
+
+
+def fetch_tarif_list(query: str | None = None) -> str:
+    """Server-rendered /tarif/ listing, optionally filtered by ?q=."""
+    url = f"{BASE}/tarif/"
+    if query:
+        url += f"?q={quote(query)}"
+    return _get(url)