hurriyet-mcp 0.1.0__tar.gz

hurriyet_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

hurriyet_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

hurriyet_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.5
+Name: hurriyet-mcp
+Version: 0.1.0
+Summary: Unofficial read-only MCP server for Hürriyet news (headlines, full articles, search, latest)
+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
+
+# hurriyet-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/hurriyet-mcp
+
+Unofficial **read-only** MCP server for **Hürriyet** (hurriyet.com.tr) — Türkiye's news: section headlines, full article text, keyword search and the homepage's latest news.
+
+> Part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with Hürriyet.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "hurriyet": {
+      "command": "uvx",
+      "args": ["hurriyet-mcp"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m hurriyet_mcp.server` (needs `mcp<2`, `curl-cffi`, `requests`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `hurriyet_get_headlines` | Latest headlines from a section — `section` (e.g. `gundem`, `ekonomi`, `dunya`, `sporarena`), `limit` (1..30) |
+| `hurriyet_get_article` | Full article text — `url` (hurriyet.com.tr article URL or path) |
+| `hurriyet_search_news` | Search news by keyword — `query`, `limit` (1..30) |
+| `hurriyet_get_latest` | Latest news from the homepage, `limit` (1..30) |
+| `hurriyet_list_categories` | News sections (slug, Turkish name, url) |
+
+Example output (`hurriyet_get_headlines` / "gundem"):
+
+```json
+{"section": "gundem", "count": 10,
+ "articles": [{"title": "Afyonkarahisar'da 8 kişiyi katletmişti! ...",
+   "url": "https://www.hurriyet.com.tr/gundem/...-43369434",
+   "id": "43369434", "section": "gundem", "kind": "article"}]}
+```
+
+Example output (`hurriyet_get_article`):
+
+```json
+{"headline": "6 ilde Telegram üzerinden asılsız ihbar ve şantaj yapan 7 şüpheli tutuklandı",
+ "section": "Gündem", "date_published": "2026-11-07T09:38:51+03:00",
+ "word_count": 143, "body": "İzmir Cumhuriyet Başsavcılığı koordinesinde ..."}
+```
+
+Notes:
+- Articles come from schema.org NewsArticle data (headline, dates, section, word count, body).
+- Search is `/arama/<keyword>`; known keywords redirect to a topic hub (e.g. `/haberleri/futbol`) — the tool reports the `landed_url`.
+- The `/arama/` path is slow under TLS impersonation — the server falls back to plain requests there.
+- Data: hurriyet.com.tr public 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_news.py` — offline, parses real captured fixtures
+- `tests/test_live.py` — 5 cautious live requests against hurriyet.com.tr
+
+## License
+
+MIT

hurriyet_mcp-0.1.0/README-fa.md

@@ -0,0 +1,39 @@
+# hurriyet-mcp 🇹🇷
+
+سرور MCP غیررسمی و **فقط‌خواندنی** برای **Hürriyet** (hurriyet.com.tr) — سایت خبری ترکیه: تیترهای بخش‌ها، متن کامل خبر، جست‌وجوی خبری و آخرین خبرهای صفحه‌ی اصلی.
+
+> بخشی از «کارخانه‌ی MCP ترکیه» (پایپ‌لاین به سبک سپهر). هیچ وابستگی به Hürriyet ندارد.
+
+## برای ایجنت‌های هوش مصنوعی
+
+```json
+{
+  "mcpServers": {
+    "hurriyet": {
+      "command": "uvx",
+      "args": ["hurriyet-mcp"]
+    }
+  }
+}
+```
+
+## ابزارها
+
+| ابزار | توضیح |
+|------|-------|
+| `hurriyet_get_headlines` | آخرین تیترهای یک بخش — `section` (مثلاً `gundem`، ‏`ekonomi`، ‏`dunya`، ‏`sporarena`)، ‏`limit` (۱ تا ۳۰) |
+| `hurriyet_get_article` | متن کامل خبر — `url` (URL خبر hurriyet.com.tr یا مسیر آن) |
+| `hurriyet_search_news` | جست‌وجوی اخبار با کلیدواژه — `query`، ‏`limit` (۱ تا ۳۰) |
+| `hurriyet_get_latest` | آخرین خبرهای صفحه‌ی اصلی، `limit` (۱ تا ۳۰) |
+| `hurriyet_list_categories` | بخش‌های خبری (slug، نام ترکی، url) |
+
+مثال (`hurriyet_get_headlines` / «gundem»): ۳۰ تیتر؛ اولین خبر «Afyonkarahisar'da 8 kişiyi katletmişti! ...». مثال (`hurriyet_get_article`): «6 ilde Telegram üzerinden asılsız ihbar ve şantaj yapan 7 şüpheli tutuklandı» — ۷ نوامبر ۲۰۲۶، ۱۴۳ کلمه.
+
+نکته‌ها:
+- خبرها از داده‌ی schema.org NewsArticle می‌آیند (تیتر، تاریخ‌ها، بخش، تعداد کلمات، متن).
+- جست‌وجو `/arama/<کلیدواژه>` است؛ کلیدواژه‌های شناخته‌شده به صفحه‌ی موضوعی هدایت می‌شوند (مثلاً `/haberleri/futbol`) — ابزار `landed_url` را گزارش می‌کند.
+- داده: صفحات عمومی hurriyet.com.tr — بدون لاگین، بدون کلید، فقط‌خواندنی.
+
+## قوانین
+
+غیررسمی و فقط‌خواندنی — بدون لاگین، بدون کلید، بدون نوشتن. تست‌ها: آفلاین با فیکسچر + تست زنده (۱۲/۱۲ سبز).

hurriyet_mcp-0.1.0/README-tr.md

@@ -0,0 +1,41 @@
+# hurriyet-mcp 🇹🇷
+
+**Hürriyet** (hurriyet.com.tr) için gayriresmî, **salt-okunur** MCP sunucusu — Türkiye'nin haber sitesi: bölüm manşetleri, tam haber metni, anahtar kelime araması ve ana sayfanın son haberleri.
+
+> "Türkiye MCP fabrikası" parçası (Sepehr tarzı pipeline). Hürriyet ile bağlantısı yoktur.
+
+## Yapay zekâ ajanları için
+
+MCP istemcinize ekleyin (stdio):
+
+```json
+{
+  "mcpServers": {
+    "hurriyet": {
+      "command": "uvx",
+      "args": ["hurriyet-mcp"]
+    }
+  }
+}
+```
+
+## Araçlar
+
+| Araç | Açıklama |
+|------|----------|
+| `hurriyet_get_headlines` | Bir bölümün son manşetleri — `section` (örn. `gundem`, `ekonomi`, `dunya`, `sporarena`), `limit` (1..30) |
+| `hurriyet_get_article` | Tam haber metni — `url` (hurriyet.com.tr haber URL'si veya yolu) |
+| `hurriyet_search_news` | Anahtar kelimeyle haber ara — `query`, `limit` (1..30) |
+| `hurriyet_get_latest` | Ana sayfanın son haberleri, `limit` (1..30) |
+| `hurriyet_list_categories` | Haber bölümleri (slug, Türkçe ad, url) |
+
+Örnek (`hurriyet_get_headlines` / "gundem"): 30 manşet; ilk haber "Afyonkarahisar'da 8 kişiyi katletmişti! ..." Örnek (`hurriyet_get_article`): "6 ilde Telegram üzerinden asılsız ihbar ve şantaj yapan 7 şüpheli tutuklandı" — 7 Kasım 2026 09:38, 143 kelime.
+
+Notlar:
+- Haberler schema.org NewsArticle verisinden gelir (başlık, tarihler, bölüm, kelime sayısı, metin).
+- Arama `/arama/<kelime>`; bilinen kelimeler konu sayfasına yönlenir (örn. `/haberleri/futbol`) — araç `landed_url`'yi bildirir.
+- Veri: hurriyet.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 (12/12 yeşil).

hurriyet_mcp-0.1.0/README.md

@@ -0,0 +1,71 @@
+# hurriyet-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/hurriyet-mcp
+
+Unofficial **read-only** MCP server for **Hürriyet** (hurriyet.com.tr) — Türkiye's news: section headlines, full article text, keyword search and the homepage's latest news.
+
+> Part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with Hürriyet.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "hurriyet": {
+      "command": "uvx",
+      "args": ["hurriyet-mcp"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m hurriyet_mcp.server` (needs `mcp<2`, `curl-cffi`, `requests`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `hurriyet_get_headlines` | Latest headlines from a section — `section` (e.g. `gundem`, `ekonomi`, `dunya`, `sporarena`), `limit` (1..30) |
+| `hurriyet_get_article` | Full article text — `url` (hurriyet.com.tr article URL or path) |
+| `hurriyet_search_news` | Search news by keyword — `query`, `limit` (1..30) |
+| `hurriyet_get_latest` | Latest news from the homepage, `limit` (1..30) |
+| `hurriyet_list_categories` | News sections (slug, Turkish name, url) |
+
+Example output (`hurriyet_get_headlines` / "gundem"):
+
+```json
+{"section": "gundem", "count": 10,
+ "articles": [{"title": "Afyonkarahisar'da 8 kişiyi katletmişti! ...",
+   "url": "https://www.hurriyet.com.tr/gundem/...-43369434",
+   "id": "43369434", "section": "gundem", "kind": "article"}]}
+```
+
+Example output (`hurriyet_get_article`):
+
+```json
+{"headline": "6 ilde Telegram üzerinden asılsız ihbar ve şantaj yapan 7 şüpheli tutuklandı",
+ "section": "Gündem", "date_published": "2026-11-07T09:38:51+03:00",
+ "word_count": 143, "body": "İzmir Cumhuriyet Başsavcılığı koordinesinde ..."}
+```
+
+Notes:
+- Articles come from schema.org NewsArticle data (headline, dates, section, word count, body).
+- Search is `/arama/<keyword>`; known keywords redirect to a topic hub (e.g. `/haberleri/futbol`) — the tool reports the `landed_url`.
+- The `/arama/` path is slow under TLS impersonation — the server falls back to plain requests there.
+- Data: hurriyet.com.tr public 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_news.py` — offline, parses real captured fixtures
+- `tests/test_live.py` — 5 cautious live requests against hurriyet.com.tr
+
+## License
+
+MIT

hurriyet_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "hurriyet-mcp"
+version = "0.1.0"
+description = "Unofficial read-only MCP server for Hürriyet news (headlines, full articles, search, latest)"
+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]
+hurriyet-mcp = "hurriyet_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hurriyet_mcp"]

hurriyet_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 Hürriyet news — headlines, full articles, search.","name":"io.github.mohammad-abbasi-sh/hurriyet-mcp","packages":[{"identifier":"hurriyet-mcp","registryBaseUrl":"https://pypi.org","registryType":"pypi","transport":{"type":"stdio"},"version":"0.1.0"}],"repository":{"source":"github","url":"https://github.com/mohammad-abbasi-sh/hurriyet-mcp"},"title":"Hürriyet News","version":"0.1.0","websiteUrl":"https://github.com/mohammad-abbasi-sh/hurriyet-mcp"}

hurriyet_mcp-0.1.0/src/hurriyet_mcp/__init__.py

@@ -0,0 +1,2 @@
+"""hurriyet_mcp — unofficial read-only MCP server for Hürriyet news."""
+__version__ = "0.1.0"

hurriyet_mcp-0.1.0/src/hurriyet_mcp/http.py

@@ -0,0 +1,98 @@
+"""HTTP layer for hurriyet_mcp.
+
+hurriyet.com.tr serves its pages server-rendered with no login and
+no API key. Search is a plain path (``/arama/<keyword>``) — known
+keywords redirect to a topic hub (e.g. /haberleri/futbol), which the
+parser handles the same way. Transport uses curl-cffi chrome120
+impersonation (the proven Turkey-factory pattern) with a
+plain-requests fallback: the /arama/ path timed out twice under
+curl-cffi while plain requests answered in ~3s, so the fallback is
+load-bearing here, not decorative. Requests are kept gentle (one at
+a time, ~1s 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.hurriyet.com.tr"
+TIMEOUT = 60.0
+MIN_INTERVAL = 1.0  # 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
+last_url: str = ""
+
+
+class HurriyetError(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:
+    global last_url
+    _throttle()
+    try:
+        resp = _creq.get(url, impersonate="chrome120", headers=_HEADERS, timeout=TIMEOUT)
+        status, text, final = resp.status_code, resp.text, str(resp.url)
+    except Exception:
+        # Fallback transport: plain requests with a browser UA.
+        try:
+            resp = _plain.get(
+                url, headers={**_HEADERS, "User-Agent": _UA}, timeout=TIMEOUT
+            )
+            status, text, final = resp.status_code, resp.text, resp.url
+        except Exception as e:
+            raise HurriyetError(f"network error fetching {url}: {e}") from e
+    last_url = final
+    if status == 403:
+        raise HurriyetError(
+            "hurriyet.com.tr refused the request (HTTP 403, bot wall) — try again later"
+        )
+    if status == 429:
+        raise HurriyetError(
+            "hurriyet.com.tr rate-limited the request (HTTP 429) — try again later"
+        )
+    if status == 404:
+        raise HurriyetError(f"hurriyet.com.tr has no page at {url} (HTTP 404)")
+    if status != 200:
+        raise HurriyetError(f"hurriyet.com.tr returned HTTP {status} for {url}")
+    return text
+
+
+def fetch_home() -> str:
+    return _get(f"{BASE}/")
+
+
+def fetch_section(section: str) -> str:
+    return _get(f"{BASE}/{section.strip('/')}/")
+
+
+def fetch_search(query: str) -> str:
+    return _get(f"{BASE}/arama/{quote(query)}")
+
+
+def fetch_article(path: str) -> str:
+    path = path.strip()
+    if path.startswith("http"):
+        return _get(path)
+    return _get(f"{BASE}/{path.lstrip('/')}")

hurriyet_mcp-0.1.0/src/hurriyet_mcp/news.py

@@ -0,0 +1,153 @@
+"""Domain logic: parse Hürriyet pages into compact dicts.
+
+Data sources (all public, no login, no key):
+- headlines: /<section>/ (gundem, ekonomi, dunya, sporarena, ...) —
+  server-rendered article links, IDs in the URL slug
+- article:  /<section>/<slug>-<id> — schema.org NewsArticle JSON-LD
+  (headline, dates, section, word count) + articleBody
+- search:   /arama/<keyword> — keyword page; known keywords redirect
+  to a topic hub (/haberleri/<keyword>), parsed the same way
+- latest:   / homepage — the day's article links
+Stdlib parsing only (re / json / html).
+"""
+from __future__ import annotations
+
+import html as _html
+import json
+import re
+
+BASE = "https://www.hurriyet.com.tr"
+
+# Curated news sections (slug -> Turkish display name). Verified present
+# in the homepage nav on 2026-11-07.
+SECTIONS = {
+    "gundem": "Gündem",
+    "ekonomi": "Ekonomi",
+    "dunya": "Dünya",
+    "sporarena": "Spor Arena",
+    "kelebek-magazin": "Kelebek Magazin",
+    "teknoloji": "Teknoloji",
+    "egitim": "Eğitim",
+    "seyahat": "Seyahat",
+    "yasam": "Yaşam",
+    "video": "Video",
+    "astroloji": "Astroloji",
+    "son-dakika-haberleri": "Son Dakika",
+    "avrupa": "Avrupa",
+    "hayat": "Hayat",
+    "kitap-sanat": "Kitap & Sanat",
+}
+
+_ARTICLE_RE = re.compile(r"^/[^\"?]+-\d{6,}/?$")
+
+
+def _clean(text: str | None) -> str:
+    if not text:
+        return ""
+    return re.sub(r"\s+", " ", _html.unescape(str(text))).strip()
+
+
+def _ld_json(html: str, want_type: str) -> dict | None:
+    for m in re.finditer(
+        r'<script type="application/ld\+json">(.*?)</script>', html, re.S
+    ):
+        try:
+            data = json.loads(m.group(1))
+        except (json.JSONDecodeError, ValueError):
+            continue
+        items = data if isinstance(data, list) else [data]
+        for item in items:
+            if not isinstance(item, dict):
+                continue
+            t = item.get("@type")
+            types = t if isinstance(t, list) else [t]
+            if want_type in types:
+                return item
+    return None
+
+
+def parse_article_links(html: str) -> list[dict]:
+    """Titled article links: href /<section>/<slug>-<id> with link text.
+
+    Skips nav/footer chrome (short/empty titles) and dedupes by URL.
+    Gallery links (/galeri-...) are kept and marked kind='gallery'.
+    """
+    out, seen = [], set()
+    for href, inner in re.findall(
+        r'href="(/[^"]+-\d{6,}/?)"[^>]*>(.*?)</a>', html, re.S
+    ):
+        if not _ARTICLE_RE.match(href):
+            continue
+        title = _clean(re.sub(r"<[^>]+>", "", inner))
+        if len(title) < 15 or href in seen:
+            continue
+        seen.add(href)
+        m = re.search(r"-(\d{6,})/?$", href)
+        section = href.strip("/").split("/", 1)[0]
+        out.append(
+            {
+                "title": title,
+                "url": f"{BASE}{href}",
+                "id": m.group(1) if m else "",
+                "section": section,
+                "kind": "gallery" if section.startswith("galeri") else "article",
+            }
+        )
+    return out
+
+
+def parse_article_page(html: str) -> dict:
+    """Parse an article page via its NewsArticle JSON-LD + articleBody."""
+    ld = _ld_json(html, "NewsArticle")
+    if ld is None:
+        raise ValueError("no NewsArticle structured data found on this page")
+    body = _clean(ld.get("articleBody"))
+    if not body:
+        # Fallback: long <p> paragraphs, skipping script/nav junk.
+        paras = []
+        for p in re.findall(r"<p[^>]*>(.*?)</p>", html, re.S):
+            t = _clean(re.sub(r"<[^>]+>", "", p))
+            if len(t) > 120 and "addEventListener" not in t:
+                paras.append(t)
+        body = "\n\n".join(paras)
+    image = ld.get("image")
+    if isinstance(image, dict):
+        image = image.get("url") or ""
+    elif isinstance(image, list):
+        image = image[0] if image else ""
+    author = ld.get("author")
+    if isinstance(author, dict):
+        author = author.get("name") or ""
+    elif isinstance(author, list) and author and isinstance(author[0], dict):
+        author = author[0].get("name") or ""
+    wc = ld.get("wordCount")
+    try:
+        wc = int(wc) if wc is not None else None
+    except (TypeError, ValueError):
+        pass
+    return {
+        "headline": _clean(ld.get("headline")),
+        "section": _clean(ld.get("articleSection")),
+        "date_published": ld.get("datePublished") or "",
+        "date_modified": ld.get("dateModified") or "",
+        "word_count": wc,
+        "keywords": _clean(ld.get("keywords")),
+        "author": _clean(author),
+        "image": image or "",
+        "body": body,
+    }
+
+
+def list_categories(html: str | None = None) -> list[dict]:
+    """News sections. If homepage HTML is given, only sections actually
+    linked from it are returned; otherwise the full curated list."""
+    if html is None:
+        wanted = set(SECTIONS)
+    else:
+        found = set(re.findall(r'href="(?:https://www\.hurriyet\.com\.tr)?/([^"/]+)/"', html))
+        wanted = set(SECTIONS) & found
+    return [
+        {"slug": slug, "name": SECTIONS[slug], "url": f"{BASE}/{slug}/"}
+        for slug in SECTIONS
+        if slug in wanted
+    ]

hurriyet_mcp-0.1.0/src/hurriyet_mcp/server.py

@@ -0,0 +1,128 @@
+"""MCP server: unofficial read-only access to Hürriyet news."""
+from __future__ import annotations
+
+import json
+
+from mcp.server.fastmcp import FastMCP
+
+from . import http as _http
+from . import news as _N
+
+mcp = FastMCP("hurriyet-mcp")
+
+INSTRUCTIONS = """\
+Unofficial read-only MCP server for Hürriyet (hurriyet.com.tr), \
+Türkiye's news site — section headlines, full articles, keyword \
+search and the homepage's latest news. Articles come from the \
+site's server-rendered pages with schema.org NewsArticle data \
+(headline, dates, section, word count, body). Search is \
+/arama/<keyword>; known keywords redirect to a topic hub \
+(e.g. /haberleri/futbol) and the tool reports the final URL it \
+landed on. No login, no API key. Read-only; transport uses Chrome \
+TLS impersonation with a plain-requests fallback (the /arama/ path \
+is slow under impersonation); requests are spaced ~1s 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 hurriyet_get_headlines(section: str = "gundem", limit: int = 10) -> str:
+    """Latest headlines from a Hürriyet section.
+    section: e.g. "gundem", "ekonomi", "dunya", "sporarena",
+    "kelebek-magazin", "teknoloji" (see hurriyet_list_categories).
+    limit 1..30."""
+    try:
+        s = section.strip().strip("/").lower()
+        if s not in _N.SECTIONS:
+            raise ValueError(
+                f"unknown section {section!r}; known: {', '.join(_N.SECTIONS)}"
+            )
+        _validate_limit(limit)
+        rows = _N.parse_article_links(_http.fetch_section(s))
+    except (ValueError, _http.HurriyetError) as e:
+        return _err(e)
+    return json.dumps(
+        {"section": s, "count": len(rows[:limit]), "articles": rows[:limit]},
+        ensure_ascii=False,
+    )
+
+
+@mcp.tool()
+def hurriyet_get_article(url: str) -> str:
+    """Full article text. url: a hurriyet.com.tr article URL
+    (or its path, e.g. /gundem/<slug>-<id>)."""
+    try:
+        if not url or not url.strip():
+            raise ValueError("url must not be empty")
+        art = _N.parse_article_page(_http.fetch_article(url.strip()))
+    except (ValueError, _http.HurriyetError) as e:
+        return _err(e)
+    return json.dumps({"url": url.strip(), **art}, ensure_ascii=False)
+
+
+@mcp.tool()
+def hurriyet_search_news(query: str, limit: int = 10) -> str:
+    """Search Hürriyet news by keyword.
+    query: e.g. "deprem", "futbol", "ekonomi". limit 1..30.
+    Known keywords redirect to a topic hub — the returned
+    `landed_url` shows where the search actually landed."""
+    try:
+        if not query or not query.strip():
+            raise ValueError("query must not be empty")
+        _validate_limit(limit)
+        rows = _N.parse_article_links(_http.fetch_search(query.strip()))
+        landed = _http.last_url
+    except (ValueError, _http.HurriyetError) as e:
+        return _err(e)
+    return json.dumps(
+        {
+            "query": query.strip(),
+            "landed_url": landed,
+            "count": len(rows[:limit]),
+            "articles": rows[:limit],
+        },
+        ensure_ascii=False,
+    )
+
+
+@mcp.tool()
+def hurriyet_get_latest(limit: int = 10) -> str:
+    """Latest news from the Hürriyet homepage. limit 1..30."""
+    try:
+        _validate_limit(limit)
+        rows = _N.parse_article_links(_http.fetch_home())
+    except (ValueError, _http.HurriyetError) as e:
+        return _err(e)
+    return json.dumps(
+        {"count": len(rows[:limit]), "articles": rows[:limit]}, ensure_ascii=False
+    )
+
+
+@mcp.tool()
+def hurriyet_list_categories() -> str:
+    """Hürriyet news sections (slug, Turkish name, url)."""
+    try:
+        cats = _N.list_categories(_http.fetch_home())
+    except (ValueError, _http.HurriyetError) as e:
+        return _err(e)
+    return json.dumps({"count": len(cats), "categories": cats}, ensure_ascii=False)
+
+
+def main() -> None:
+    mcp.run()
+
+
+if __name__ == "__main__":
+    import sys
+
+    sys.exit(main())

hurriyet_mcp-0.1.0/tests/fixtures/article.html

@@ -0,0 +1,7 @@
+<html><head><title>6 ilde Telegram üzerinden asılsız ihbar ve şantaj yapan 7 şüpheli tutuklandı - Son Dakika Haber</title></head><body>
+<script type="application/ld+json">{"@context": "https://schema.org","@type": "NewsArticle","inLanguage": "tr-TR","articleSection": "Gündem","mainEntityOfPage": {"@type": "WebPage","@id": "https://www.hurriyet.com.tr/gundem/6-ilde-telegram-uzerinden-asilsiz-ihbar-ve-santaj-yapan-7-supheli-tutuklandi-43369105"},"headline": "6 ilde Telegram üzerinden asılsız ihbar ve şantaj yapan 7 şüpheli tutuklandı","wordCount":"143","keywords":["asılsız ihbar","şantaj","tehdit","Telegram"],"image": {"@type": "ImageObject","url": "https://image.hurimg.com/i/hurriyet/90/1200x675/6aeec764aa7d7bef19766538.jpg","width": "1200","height": "675"},"datePublished":"2026-11-07T09:38:51+03:00","dateModified":"2026-11-07T09:38:51+03:00","copyrightYear": "2026","description":  "İzmir merkezli İstanbul, Antalya, Afyonkarahisar, Diyarbakır, Şanlıurfa ve Muğla'da düzenlenen operasyonda, Telegram üzerinden asılsız ihbar ve şantaj yaptıkları belirlenen 9 şüpheli yakalandı. Adliyeye sevk edilen şüphelilerden 7'si tutuklandı.","articleBody": "İzmir Cumhuriyet Başsavcılığı koordinesinde, İzmir Emniyet Müdürlüğü Organize Suçlarla Mücadele Şube Müdürlüğü ve İstihbarat Şube Müdürlüğü ekipleri çalışma yürüttü. Yapılan çalışmalarda şüphelilerin Telegram uygulamasında grup oluşturduğu tespit edildi.Bu grup üzerinden örgütlü hareket eden şüphelilerin, para karşılığında toplumda infial oluşturabilecek bomba, fuhuş ve terör saldırısı içerikli asılsız ihbarlarda bulunduğu belirlendi. Farklı illerde toplam 45 asılsız ihbar gerçekleştiren şüphelilerin, müştekilere yönelik şantaj ve tehdit eylemleriyle haksız ekonomik menfaat sağladığı tespit edildi.7 TUTUKLAMAİzmir merkezli İstanbul, Antalya, Afyonkarahisar, Diyarbakır, Şanlıurfa ve Muğla'nın Fethiye ilçesinde hava destekli müşterek operasyonlar yapıldı. Operasyonlarda 9 şüpheli yakalanarak gözaltına alındı. Emniyetteki işlemlerinin ardından adli makamlara sevk edilen şüphelilerden 7'si tutuklandı.Bülten Abonelik Formu","author": {"@type": "Person", "name": "Tayibe Önel"},"publisher": {"@type": "Organization","name":"www.hurriyet.com.tr","logo": {"@type": "ImageObject","url": "https://image.hurimg.com/i/hurriyet/100/230x60/590c24950f25442978242248.jpg","width": 230,"height": 60}}} </script>
+<p>document.addEventListener(&#x27;DOMContentLoaded&#x27;, () =&gt; {const isLezizz = document.querySelector(&quot;.header-lezizz&quot;);const loginText = isLezizz ? &quot;Giriş&quot; : &quot;GİRİŞ&quot;;try {if (DM) {DM.auth.oidc.init(&#x27;btn-dm-signin&#x27;, {&#x27;storage&#x27;: &#x27;nostorage&#x27;,&#x27;acr_values&#x27;: &#x27;hurriyet&#x27;,&#x27;onsuccess&#x27;: onSuccess,&#x27;onfailure&#x27;: onFailure});function loadGoogleTapOneJs(src) {let script = document.createElement(&#x27;script&#x27;);script.src = src;script.async = true;script.defer = true;document.head.appendChild(script);}function onSuccess(dmUser) {let full_name = `${dmUser.profile.firstName?.trim()} ${dmUser.profile.lastName?.trim()}`;let parent = DM.auth.clickElement.parentElement;if (parent) {parent.removeChild(DM.auth.clickElement);parent.appendChild(DM.auth.clickElement.cloneNode(true));}const sidebarPremiumBox = document.querySelector(&quot;.sidebar__external--signin&quot;),loginAccount = document.querySelector(&#x27;.header__external--account&#x27;),gmConnectBtn = document.querySelector(&quot;.gm-connect-btn&quot;),gmLoginAfter = document.querySelector(&quot;.login-after&quot;),gmLoginInfoElements = document.querySelectorAll(&quot;#gmUserName&quot;),gmLogoutButtons = document.querySelectorAll(&quot;.gm-connect-box .gm-link&quot;),gmLoginContainers = document.querySelectorAll(&quot;.gm-login-container&quot;),h16Header = document.querySelector(&quot;.h16-header&quot;),backdrop = document.querySelector(&#x27;.header__backdrop&#x27;);let profileLink = &quot;https://hesabim.hurriyet.com.tr/#/profil&quot;;let loginUrl = &quot;https://u.hurriyet.com.tr&quot;;let lastUrl = &quot;?lasturl=https://www.hurriyet.com.tr/gundem/6-ilde-telegram-uzerinden-asilsiz-ihbar-ve-santaj-yapan-7-supheli-tutuklandi-43369105&quot;;if (sidebarPremiumBox) {sidebarPremiumBox.innerHTML = GetShortName(full_name);sidebarPremiumBox.setAttribute(&quot;href&quot;, profileLink);}if (loginAccount) {let parent = loginAccount.parentElement;parent.removeChild(loginAccount);parent.appendChild(loginAccount);const advancedHeader = document.querySelector(&quot;.category-advanced-header&quot;);let userProfile = null;if (advancedHeader) {let shortName = full_name.split(&#x27; &#x27;).map(name =&gt; name[0] + &#x27;&#x27;).join(&#x27;&#x27;);const capitalizeFullName = full_name.toLocaleLowerCase(&#x27;tr-TR&#x27;).split(&#x27; &#x27;).map(word =&gt; word.charAt(0).toLocaleUpperCase(&#x27;tr-TR&#x27;) + word.slice(1)).join(&#x27; &#x27;);userProfile = `${shortName}${capitalizeFullName}Kullanıcı BilgilerimÇıkış Yap`;}else {userProfile = `Profili GörÇıkış Yap`;}loginAccount.classList.add(&#x27;login&#x27;);let shortOrFullName;if (IsMobile()) {shortOrFullName = full_name.split(&#x27; &#x27;).map(name =&gt; name[0] + &#x27;.&#x27;).join(&#x27;&#x27;);} else {shortOrFullName = full_name;}loginAccount.innerHTML = GetShortName(shortOrFullName);loginAccount.setAttribute(&quot;href&quot;, &quot;javascript:;&quot;);loginAccount.innerHTML += userProfile;const mobileUserTarget = document.querySelector(&#x27;.mobile-user-profile-menu&#x27;);if (mobileUserTarget) {mobileUserTarget.innerHTML = userProfile;}loginAccount.addEventListener(&quot;click&quot;, () =&gt; {const isOpened = loginAccount.classList.toggle(&quot;opened&quot;);if (window.innerWidth {setCookie(&quot;firstLogin&quot;, false, -1);setCookie(&quot;isPopupShow&quot;, true, 7);document.location = loginUrl +&quot;/accounts/logout&quot; + lastUrl;});}}if (h16Header) {h16Header.setAttribute(&quot;href&quot;, profileLink);let loginPlaces = document.querySelectorAll(&quot;.login-user&quot;);[].forEach.call(loginPlaces, element =&gt; {element.innerText = GetShortName(full_name)});}trackFirstLogin(dmUser);if (gmConnectBtn &amp;&amp; gmLoginAfter) {gmConnectBtn.remove();gmLoginAfter.remove();[].forEach.call(gmLoginContainers, element =&gt; {element.classList.add(&#x27;gm-show&#x27;);});[].forEach.call(gmLoginInfoElements, element =&gt; {element.innerHTML = GetShortName(full_name);});[].forEach.call(gmLogoutButtons, element =&gt; {element.setAttribute(&quot;href&quot;, &quot;javascript:void(0);&quot;);});}}function onFailure(error) {let loginUrl = &quot;https://u.hurriyet.com.tr&quot;;let lastUrl = &quot;?lasturl=https://www.hurriyet.com.tr/gundem/6-ilde-telegram-uzerinden-asilsiz-ihbar-ve-santaj-yapan-7-supheli-tutuklandi-43369105&quot;;popupShowRule();setCookie(&quot;firstLogin&quot;, false, -1);if (document.getElementById(&#x27;logoutbtn&#x27;) != null) {document.getElementById(&#x27;logoutbtn&#x27;).style.display = &#x27;none&#x27;;}document.getElementById(&#x27;btn-dm-signin&#x27;).innerText = loginText;document.getElementById(&#x27;btn-dm-signin&#x27;).href = loginUrl + &quot;/accounts/login&quot; + lastUrl;let loginAccount = document.querySelector(&#x27;.header__external--account&#x27;);let h16Header = document.querySelector(&quot;.h16-header&quot;);if (loginAccount) {loginAccount.classList.remove(&#x27;login&#x27;);}if (h16Header) {loginAccount.setAttribute(&quot;href&quot;, &quot;javascript:void(0)&quot;);let loginPlaces = document.querySelectorAll(&quot;.login-user&quot;);[].forEach.call(loginPlaces, element =&gt; {element.innerText = loginText;});}window.consoleLog?.(&#x27;onFailure&#x27;, error);}function trackFirstLogin(dmUser) {if (getCookie(&quot;firstLogin&quot;) !== &quot;&quot;) {return;}const actionNames = {7: &quot;google&quot;,5: &quot;twitter&quot;,4: &quot;facebook&quot;,17: &quot;apple&quot;};let action = &quot;manuel&quot;;try {const referrer = dmUser.profile.referrer;action = actionNames[referrer] || action;} catch (e) {window.consoleLog?.(&quot;Error referrer&quot;, e);}const script = document.createElement(&quot;script&quot;);script.innerHTML = `window.dataLayer = window.dataLayer || [];window.dataLayer.push({&#x27;event&#x27;: &#x27;login&#x27;,&#x27;Category&#x27;: &#x27;login&#x27;,&#x27;Action&#x27;: &#x27;${action}&#x27;,&#x27;Label&#x27;: &#x27;hurriyet.com&#x27;});`;document.getElementsByTagName(&#x27;head&#x27;)[0].appendChild(script);setCookie(&quot;firstLogin&quot;, true, 15);};function popupShowRule() {let isReferralValid = false;let isWebSiteFirstVisit = false;let isMainPageAutoReload = false;let documentReferrer = document.referrer;if (documentReferrer.includes(&quot;.hurriyet.com.tr&quot;) || documentReferrer.includes(&quot;localhost&quot;) || documentReferrer == &quot;&quot;) {isReferralValid = true;}if (isReferralValid) {if (getCookie(&quot;isWebSiteFirstVisit&quot;) == &quot;&quot;) {setCookie(&quot;isWebSiteFirstVisit&quot;, true, 1);isWebSiteFirstVisit = true;}if (isWebSiteFirstVisit == false &amp;&amp; getCookie(&quot;isPopupShow&quot;) == &quot;&quot;) {setCookie(&quot;isPopupShow&quot;, true, 7);let googleFastLoginControlText = document.getElementById(&quot;googleFastLoginControl&quot;).value;if (googleFastLoginControlText == 1) {window.consoleLog?.(&quot;OneTap: Mobile, Web On&quot;);loadGoogleTapOneJs(&quot;https://accounts.google.com/gsi/client&quot;);}else if (googleFastLoginControlText == 2 &amp;&amp; IsMobile()) {window.consoleLog?.(&quot;OneTap: Mobile On, Web Off&quot;);loadGoogleTapOneJs(&quot;https://accounts.google.com/gsi/client&quot;);}else if (googleFastLoginControlText == 3 &amp;&amp; !IsMobile()) {window.consoleLog?.(&quot;OneTap: Mobile Off, Web On&quot;);loadGoogleTapOneJs(&quot;https://accounts.google.com/gsi/client&quot;);}}}}function setCookie(cname, cvalue, exdays) {const d = new Date();d.setTime(d.getTime() + (exdays * 24 * 60 * 60 * 1000));let expires = &quot;expires=&quot; + d.toUTCString();document.cookie = cname + &quot;=&quot; + cvalue + &quot;;&quot; + expires + &quot;;path=/&quot;;}function getCookie(cname) {let name = cname + &quot;=&quot;;let decodedCookie = decodeURIComponent(document.cookie);let ca = decodedCookie.split(&#x27;;&#x27;);for (let i = 0; i 1) {for (var i = 1; i #credential_picker_container {z-index: 9999999 !important;}.dm-modal-container {font-family: &#x27;Metropolis Medium&#x27;;}.adserviceOop{position: fixed;top: 0px;left: 0px;width: 0px;height: 0px;}.news-inline-banner {img {@media screen and (max-width: 767px) {max-height: 165px;height: auto;}@media screen and (min-width: 768px) {max-height: 200px;height: auto;width: auto;max-width: 100%;}}}HABERLERGündem Haberleri6 ilde Telegram üzerinden asılsız ihbar ve şantaj yapan 7 şüpheli tutuklandıGüncelleme Tarihi: Kasım 07, 2026 09:38</p>
+<p>Font BoyutuYazıyı BüyütYazıyı KüçültPaylaşNSosyalTwitterFacebookLinkedinWhatsappFlipboardLinki KopyalaİHAOluşturulma Tarihi: Kasım 07, 2026 09:38İzmir merkezli İstanbul, Antalya, Afyonkarahisar, Diyarbakır, Şanlıurfa ve Muğla&#x27;da düzenlenen operasyonda, Telegram üzerinden asılsız ihbar ve şantaj yaptıkları belirlenen 9 şüpheli yakalandı. Adliyeye sevk edilen şüphelilerden 7&#x27;si tutuklandı.Haberlerimizi Google’da Takip EdinGelişmelerden anında haberdar olun.Google’da tercih edilenkaynak olarak ekleyinHaberin Devamıİzmir Cumhuriyet Başsavcılığı koordinesinde, İzmir Emniyet Müdürlüğü Organize Suçlarla Mücadele Şube Müdürlüğü ve İstihbarat Şube Müdürlüğü ekipleri çalışma yürüttü. Yapılan çalışmalarda şüphelilerin Telegram uygulamasında grup oluşturduğu tespit edildi.</p>
+<p>Bu grup üzerinden örgütlü hareket eden şüphelilerin, para karşılığında toplumda infial oluşturabilecek bomba, fuhuş ve terör saldırısı içerikli asılsız ihbarlarda bulunduğu belirlendi. Farklı illerde toplam 45 asılsız ihbar gerçekleştiren şüphelilerin, müştekilere yönelik şantaj ve tehdit eylemleriyle haksız ekonomik menfaat sağladığı tespit edildi.</p>
+<p>İzmir merkezli İstanbul, Antalya, Afyonkarahisar, Diyarbakır, Şanlıurfa ve Muğla&#x27;nın Fethiye ilçesinde hava destekli müşterek operasyonlar yapıldı. Operasyonlarda 9 şüpheli yakalanarak gözaltına alındı. Emniyetteki işlemlerinin ardından adli makamlara sevk edilen şüphelilerden 7&#x27;si tutuklandı.</p>
+</body></html>

hurriyet_mcp-0.1.0/tests/fixtures/gundem.html

@@ -0,0 +1,35 @@
+<html><head><title>Güncel Haberler - Bugün Yaşanan Son Olaylar, Son Dakika Gündem Haber</title></head><body>
+<a href="/gundem/afyonkarahisarda-8-kisiyi-katletmisti-saldirganin-silahi-12-bin-tlye-aldigi-ortaya-cikti-43369434">Afyonkarahisar&#x27;da 8 kişiyi katletmişti! Saldırganın silahı 12 bin TL&#x27;ye aldığı ortaya çıktı</a>
+<a href="/gundem/universitelerde-4-yillik-egitim-suresi-dusuyor-mu-yok-baskani-ozvardan-yeni-aciklama-43369429">Üniversitelerde 4 yıllık eğitim süresi düşüyor mu? YÖK Başkanı Özvar&#x27;dan yeni açıklama</a>
+<a href="/gundem/manisada-annesini-ve-kardesini-olduren-zanli-tutuklandi-neden-tartistigimizi-ve-oldurdugumu-hatirlamiyorum-43369415">Manisa&#x27;da annesini ve kardeşini öldüren zanlı tutuklandı! &#x27;Neden tartıştığımızı ve öldürdüğümü hatırlamıyorum&#x27;</a>
+<a href="/gundem/aydinda-mobilya-fabrikasinda-yangin-ekipler-mudahale-ediyor-43369356">Aydın&#x27;da mobilya fabrikasında yangın: Ekipler müdahale ediyor</a>
+<a href="/gundem/adana-9-gun-boyunca-festival-coskusu-yasayacak-43369338">Adana, 9 gün boyunca festival coşkusu yaşayacak!</a>
+<a href="/galeri-istanbulun-yani-basinda-kar-yagisi-evler-kara-gomuldu-sabah-kalktik-her-taraf-bembeyaz-olmus-43369214">İstanbul&#x27;un yanı başında kar yağışı! Evler kara gömüldü: &#x27;Sabah kalktık her taraf bembeyaz olmuş&#x27;</a>
+<a href="/gundem/emine-erdogandan-81-il-81-kadin-81-hikaye-bize-ozgu-sergisi-acilis-programina-iliskin-paylasim-43369264">Emine Erdoğan&#x27;dan 81 İl, 81 Kadın, 81 Hikaye: Bize Özgü Sergisi Açılış Programı&#x27;na ilişkin paylaşım</a>
+<a href="/gundem/zeytinburnunda-trafikte-yol-verme-kavgasi-otomobilden-inen-surucu-diger-aracin-camini-yumrukladi-43369234">Zeytinburnu&#x27;nda trafikte yol verme kavgası! Otomobilden inen sürücü, diğer aracın camını yumrukladı</a>
+<a href="/gundem/fon-sorusturmasinda-yeni-gelisme-eski-spk-baskan-vekili-enver-usca-dahil-4-kisi-tutuklandi-43369236">Fon soruşturmasında yeni gelişme: Eski SPK Başkan Vekili Enver Usca dahil 4 kişi tutuklandı</a>
+<a href="/gundem/kepengin-uzaktan-kumanda-sifresini-kopyalayip-kuyumcuya-girdi-caldigi-200-yuzuk-sahte-cikti-43369177">Kepengin uzaktan kumanda şifresini kopyalayıp kuyumcuya girdi! Çaldığı 200 yüzük sahte çıktı</a>
+<a href="/galeri-asi-nehrinde-oltaya-takildi-ilk-kez-boyle-bir-turle-karsilastim-ben-yemem-43369179">Asi Nehri&#x27;nde oltaya takıldı: &#x27;İlk kez böyle bir türle karşılaştım, ben yemem&#x27;</a>
+<a href="/gundem/sokak-saticilarina-yonelik-uyusturucu-operasyonu-82-kisi-tutuklandi-43369147">Sokak satıcılarına yönelik uyuşturucu operasyonu: 82 kişi tutuklandı</a>
+<a href="/gundem/super-lotoda-buyuk-ikramiye-heyecani-850-milyon-312-bin-836-tlye-ulasti-43369133">Süper Loto’da büyük ikramiye heyecanı! 850 milyon 312 bin 836 TL’ye ulaştı</a>
+<a href="/gundem/6-ilde-telegram-uzerinden-asilsiz-ihbar-ve-santaj-yapan-7-supheli-tutuklandi-43369105">6 ilde Telegram üzerinden asılsız ihbar ve şantaj yapan 7 şüpheli tutuklandı</a>
+<a href="/gundem/istanbullulara-sabah-surprizi-yagmur-sonrasi-gokkusagi-cikti-43369098">İstanbullulara sabah sürprizi: Yağmur sonrası gökkuşağı çıktı</a>
+<a href="/gundem/kirmizi-bultenle-araniyordu-uyusturucu-baronu-mersinde-yakalandi-43369078">Kırmızı bültenle aranıyordu: Uyuşturucu baronu Mersin&#x27;de yakalandı</a>
+<a href="/gundem/bursada-ayni-yone-giden-otomobiller-carpisti-kaza-ani-kamerada-43369071">Bursa’da aynı yöne giden otomobiller çarpıştı: Kaza anı kamerada</a>
+<a href="/gundem/turkiye-sibirya-soguklarinin-etkisinde-sicakliklar-dusuyor-meteorolojiden-uyari-ustune-uyari-saganak-yagis-kar-zirai-don-ve-43369067">Türkiye Sibirya soğuklarının etkisinde: Sıcaklıklar düşüyor! Meteoroloji&#x27;den uyarı üstüne uyarı: Sağanak yağış, kar, zirai don ve fırtına alarmı</a>
+<a href="/gundem/bursada-eglence-mekanina-tufekli-saldiri-43369065">Bursa’da eğlence mekanına tüfekli saldırı</a>
+<a href="/gundem/tutuklama-gerekcesi-tasfiyeyi-bilerek-islem-yapti-para-ayni-gun-yatti-43369033">Tutuklama gerekçesi: Tasfiyeyi bilerek işlem yaptı para aynı gün yattı</a>
+<a href="/gundem/erdogan-uluslararasi-sistem-iflas-bayragi-cekti-43369044">Cumhurbaşkanı Erdoğan: Uluslararası sistem iflas bayrağı çekti</a>
+<a href="/gundem/tarihi-gecmis-ilaclari-piyasaya-suren-21-supheli-tutuklandi-43369012">Tarihi geçmiş ilaçları piyasaya süren 21 şüpheli tutuklandı</a>
+<a href="/gundem/cinayeti-tum-detaylariyla-anlatti-annem-ve-sevgilisi-beni-zorladi-43369016">Cinayeti tüm detaylarıyla anlattı: Annem ve sevgilisi beni zorladı</a>
+<a href="/gundem/denizolgunun-olumu-bassavcilik-ek-rapor-istedi-43369024">Denizolgun’un ölümü... Başsavcılık ek rapor istedi</a>
+<a href="/gundem/hakan-bahcetepeye-ev-hapsiyle-tahliye-43369026">Hakan Bahçetepe’ye ev hapsiyle tahliye</a>
+<a href="/gundem/kurtulmus-hayati-bir-mesele-43369030">Kurtulmuş: Hayati bir mesele</a>
+<a href="/gundem/yeni-parti-yarin-sandiga-gidiyor-genel-baskanlik-icin-on-secim-43369031">YENİ Parti yarın sandığa gidiyor... Genel Başkanlık için ön seçim</a>
+<a href="/gundem/tedmemden-yesil-egitim-onerileri-43369041">TEDMEM’DEN ‘Yeşil Eğitim’ önerileri</a>
+<a href="/gundem/doluluk-orani-yuzde-61e-cikti-son-10-yilin-rekoru-43369050">Doluluk oranı yüzde 61’e çıktı... Son 10 yılın rekoru</a>
+<a href="/gundem/secil-erzana-212-yil-istendi-43369010">Seçil Erzan’a 212 yıl istendi</a>
+<a href="/galeri-ayetel-kursi-okunusu-ayetel-kursi-duasi-turkce-anlami-ve-diyanet-meali-arapca-yazilisi-faziletleri-ve-bilgiler-42300047">Ayetel Kürsi</a>
+<a href="/galeri-guzel-sozler-2023-ozlu-sozler-ile-en-anlamli-sevgiliye-etkileyici-romantik-resimli-ve-kisa-mesajlar-40792109">Güzel Sözler</a>
+<a href="/ramazan-ozel/namaz-sureleri/yasin-suresi-oku-dinle-yasin-suresi-arapca-turkce-okunusu-ve-meali-6-sayfa-tamami-42681788">Yasin Suresi</a>
+</body></html>

hurriyet_mcp-0.1.0/tests/fixtures/search.html

@@ -0,0 +1,47 @@
+<html><head><title>Futbol Haberleri - Son Dakika Futbol Hakkında Güncel Haber ve Bilgiler </title></head><body>
+<a href="/sporarena/fredden-galatasaray-derbisi-aciklamasi-cilginlik-43369101">Fred&#x27;den Galatasaray derbisi açıklaması: &#x27;Çılgınlık!&#x27;</a>
+<a href="/sporarena/jose-mourinho-yarinki-mac-beni-korkutuyor-43368494">Jose Mourinho: &#x27;Yarınki maç beni korkutuyor!&#x27;</a>
+<a href="/sporarena/senol-gunesten-arda-guler-sozleri-dunyanin-en-iyi-5-oyuncusu-arasinda-gosterilebilecek-bir-yildiz-43368178">Şenol Güneş&#x27;ten Arda Güler sözleri: &#x27;Dünyanın en iyi 5 oyuncusu arasında gösterilebilecek bir yıldız!&#x27;</a>
+<a href="/sporarena/leroy-sane-icin-olay-sozler-galatasaraya-katkisi-cok-sinirli-43366904">Leroy Sane için olay sözler: &#x27;Galatasaray&#x27;a katkısı çok sınırlı!&#x27;</a>
+<a href="/sporarena/aleksey-batrakov-galatasaray-kariyerine-gorkemli-bir-baslangic-yapti-43365723">Aleksey Batrakov, Galatasaray kariyerine görkemli bir başlangıç yaptı</a>
+<a href="/sporarena/galatasaray-2-2-stuttgart-mac-ozeti-uefa-genclik-ligi-43364740">Galatasaray 2-2 Stuttgart maç özeti (UEFA Gençlik Ligi)</a>
+<a href="/sporarena/dort-buyuk-kulubun-futbolculari-kktcli-oyuncularla-dostluk-macina-cikacak-43364532">Dört büyük kulübün futbolcuları KKTC’li oyuncularla dostluk maçına çıkacak</a>
+<a href="/sporarena/osimhen-formunu-yukseltiyor-raphinha-gollerini-ikiser-ikiser-siralamaya-devam-ediyor-iste-misliden-gunun-oyuncu-bahisleri-43364451">Osimhen formunu yükseltiyor, Raphinha gollerini ikişer ikişer sıralamaya devam ediyor! İşte Misli’den günün oyuncu bahisleri</a>
+<a href="/sporarena/vitor-pereira-gecmiste-kararlarimda-bazi-hatalar-yaptim-43363600">Vitor Pereira: &#x27;Geçmişte kararlarımda bazı hatalar yaptım&#x27;</a>
+<a href="/sporarena/genclerbirliginde-ve-atalantada-kotu-gidis-suruyor-kayserisporun-maclari-bol-gollu-geciyor-iste-misliden-gunun-tuyolari-43363160">Gençlerbirliği’nde ve Atalanta’da Kötü Gidiş Sürüyor, Kayserispor’un Maçları Bol Gollü Geçiyor… İşte Misli’den Günün Tüyoları!</a>
+<a href="/sporarena/fernando-musleradan-buyuk-hata-43362367">Fernando Muslera&#x27;dan büyük hata!</a>
+<a href="/sporarena/besiktas-kasimpasaya-konuk-olacak-macin-heyecani-canli-sohbet-ile-mislide-43362231">Beşiktaş, Kasımpaşa&#x27;ya konuk olacak! Maçın heyecanı canlı sohbet ile Misli&#x27;de</a>
+<a href="/avrupa/besiktas-avrupadaki-genclere-sahip-cikacak-43362164">Beşiktaş Avrupa’daki gençlere sahip çıkacak</a>
+<a href="/avrupa/bundesligada-zirve-yarisi-iyice-kizisti-43362159">Bundesliga&#x27;da zirve yarışı iyice kızıştı</a>
+<a href="/sporarena/arda-turan-yasadigimiz-zorluklarin-tamamen-farkindayim-43361407">Arda Turan: &#x27;Yaşadığımız zorlukların tamamen farkındayım!&#x27;</a>
+<a href="/sporarena/trabzonspor-teknik-direktoru-thomas-reis-baskiyi-seviyorum-43360334">Trabzonspor Teknik Direktörü Thomas Reis: &#x27;Baskıyı seviyorum!&#x27;</a>
+<a href="/sporarena/fenerbahcede-samandira-cikarmasi-kuyta-destek-icin-toplandilar-43360099">Fenerbahçe&#x27;de Samandıra çıkarması! Kuyt&#x27;a destek için toplandılar</a>
+<a href="/sporarena/a-milli-takim-teknik-direktoru-sergen-yalcindan-iddialara-yanit-o-aciklamalari-sov-amaciyla-yapmistim-futbolcular-da-bunu-biliyor-43360031">A Milli Takım teknik direktörü Sergen Yalçın&#x27;dan iddialara yanıt: &#x27;O açıklamaları şov amacıyla yapmıştım, futbolcular da bunu biliyor!&#x27;</a>
+<a href="/sporarena/besiktasta-orkun-kokcu-gelismesi-43359519">Beşiktaş&#x27;ta Orkun Kökçü gelişmesi!</a>
+<a href="/sporarena/super-ligde-10-hafta-heyecani-baslayacak-43359077">Süper Lig&#x27;de 10. hafta heyecanı başlayacak</a>
+<a href="/sporarena/ronaldonun-milli-takima-vedasinda-jorge-jesus-etkisi-43369358">Ronaldo&#x27;nun milli takıma vedasında Jorge Jesus etkisi!</a>
+<a href="/sporarena/gedson-fernandesten-batrakov-sozleri-cok-iyi-bir-kulube-gitti-43369229">Gedson Fernandes&#x27;ten Batrakov sözleri: &#x27;Çok iyi bir kulübe gitti!&#x27;</a>
+<a href="/gundem/secil-erzana-212-yil-istendi-43369010">Seçil Erzan’a 212 yıl istendi</a>
+<a href="/sporarena/tff-tahkim-kurulundan-archie-brown-karari-43368940">TFF Tahkim Kurulu&#x27;ndan Archie Brown kararı!</a>
+<a href="/sporarena/fenerbahceden-4-nisan-saldirisiyla-ilgili-aciklama-43368859">Fenerbahçe&#x27;den 4 Nisan saldırısıyla ilgili açıklama!</a>
+<a href="/gundem/son-dakika-fenerbahce-otobusune-saldiriya-iddianame-5-supheli-hakkinda-ceza-istendi-43368834">Son dakika : Fenerbahçe otobüsüne saldırıya iddianame… 5 şüpheli hakkında ceza istendi</a>
+<a href="/sporarena/ahmetcan-kaplan-kimdir-nereli-kac-yasinda-ahmetcan-kaplan-hangi-takimlarda-oynadi-43368718">Ahmetcan Kaplan kimdir, nereli, kaç yaşında? Ahmetcan Kaplan hangi takımlarda oynadı?</a>
+<a href="/spor/videolar/super-lig/video-emre-belozoglu-fenerbahceye-imza-atti-5-sene-onceki-emre-degilim-43368679">Emre Belözoğlu, Fenerbahçe&#x27;ye imza attı: 5 sene önceki Emre değilim</a>
+<a href="/sporarena/serhat-oztasdelen-kimdir-nereli-kac-yasinda-serhat-oztasdelen-hangi-takimlarda-oynadi-43368614">Serhat Öztaşdelen kimdir, nereli, kaç yaşında? Milli Takım Aday Kadrosuna çağrılan Serhat Öztaşdelen hangi takımlarda oynadı?</a>
+<a href="/sporarena/emre-belozoglu-fenerbahceye-imza-atti-5-sene-onceki-emre-degilim-43368560">Emre Belözoğlu, Fenerbahçe&#x27;ye imza attı: 5 sene önceki Emre değilim</a>
+<a href="/spor/videolar/diger/video-sergen-yalcin-a-milli-takim-aday-kadrosunu-acikladi-43368423">Sergen Yalçın, A Milli Takım aday kadrosunu açıkladı</a>
+<a href="/sporarena/sergen-yalcin-a-milli-takim-aday-kadrosunu-acikladi-43368357">Sergen Yalçın, A Milli Takım aday kadrosunu açıkladı! İşte kadroda yer almayan isimler</a>
+<a href="/spor/videolar/diger/video-senol-gunesten-arda-guler-sozleri-dunyanin-en-iyi-5-oyuncusu-arasinda-gosterilebilecek-bir-yildiz-43368340">Şenol Güneş&#x27;ten Arda Güler sözleri: &#x27;Dünyanın en iyi 5 oyuncusu arasında gösterilebilecek bir yıldız!&#x27;</a>
+<a href="/sporarena/fifa-baskani-infantinodan-portekiz-milli-takimini-birakan-ronaldoya-mesaj-43368058">FIFA Başkanı Infantino&#x27;dan Portekiz Milli Takımı&#x27;nı bırakan Ronaldo&#x27;ya mesaj</a>
+<a href="/sporarena/galatasaray-super-ligde-amedsporu-agirlayacak-43368015">Galatasaray, Süper Lig&#x27;de Amedspor&#x27;u ağırlayacak</a>
+<a href="/sporarena/berke-ozerden-sergen-yalcin-ve-milli-takim-aciklamasi-43367578">Berke Özer&#x27;den Sergen Yalçın ve Milli Takım açıklaması!</a>
+<a href="/gundem/bakanliktan-giyilmis-coraplarla-bagis-paylasimina-suc-duyurusu-43367469">Bakanlıktan giyilmiş çoraplarla bağış paylaşımına suç duyurusu</a>
+<a href="/sporarena/galeri-cristiano-ronaldo-milli-takimi-birakti-mi-ronaldodan-portekiz-milli-takim-karari-43367179">Cristiano Ronaldo Portekiz Milli Takımı&#x27;nı bıraktı mı? Ronaldo’dan milli takım kararı!</a>
+<a href="/sporarena/sergen-yalcinin-54-yas-gunu-rivada-kutlandi-43367390">Sergen Yalçın&#x27;ın 54. yaş günü Riva&#x27;da kutlandı</a>
+<a href="/sporarena/burak-yilmazdan-fenerbahce-maci-oncesi-iddiali-aciklama-kazanmak-icin-elimizden-gelenin-fazlasini-yapacagiz-43367209">Burak Yılmaz&#x27;dan Fenerbahçe maçı öncesi iddialı açıklama: &#x27;Kazanmak için elimizden gelenin fazlasını yapacağız!&#x27;</a>
+<a href="/spor/videolar/super-lig/video-burak-yilmaz-fenerbahce-macini-kazanmak-icin-sahaya-cikacagiz-43367195">Burak Yılmaz&#x27;dan Fenerbahçe maçı öncesi iddialı açıklama: &#x27;Kazanmak için elimizden gelenin fazlasını yapacağız!&#x27;</a>
+<a href="/sporarena/fenerbahce-paylasti-emre-belozoglu-ilk-antrenmanina-cikti-43367128">Fenerbahçe paylaştı! Emre Belözoğlu ilk antrenmanına çıktı</a>
+<a href="/sporarena/freiburg-nerenin-takimi-hangi-ligde-oynuyor-freiburg-guncel-kadro-degeri-2026-43367119">Freiburg nerenin takımı, hangi ligde oynuyor? Freiburg güncel kadro değeri 2026!</a>
+<a href="/sporarena/cristiano-ronaldo-milli-takim-kariyerini-noktaladi-43367037">Başbakan ve Federasyon Başkanı kararından döndüremedi: Cristiano Ronaldo milli takım kariyerini noktaladı!</a>
+<a href="/sporarena/bayern-munih-harry-kane-ile-sozlesme-yeniledi-43366995">Bayern Münih, Harry Kane ile sözleşme yeniledi!</a>
+</body></html>

hurriyet_mcp-0.1.0/tests/test_live.py

@@ -0,0 +1,58 @@
+"""Live tests — hit the real hurriyet.com.tr. Cautious: a few requests, then stop.
+
+Run:  pytest tests/test_live.py -v
+Skip: pytest -m "not live"  (or set HURRIYET_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 hurriyet_mcp import http as _http
+from hurriyet_mcp import news as _N
+
+pytestmark = pytest.mark.live
+SKIP = os.environ.get("HURRIYET_SKIP_LIVE") == "1"
+
+
+@pytest.mark.skipif(SKIP, reason="HURRIYET_SKIP_LIVE=1")
+class TestLive(unittest.TestCase):
+    def test_gundem_is_real(self):
+        rows = _N.parse_article_links(_http.fetch_section("gundem"))
+        self.assertGreaterEqual(len(rows), 10)
+        print(f"\nLIVE gundem: {len(rows)} headlines, first = {rows[0]['title'][:80]}")
+        time.sleep(1)
+
+    def test_article_is_real(self):
+        rows = _N.parse_article_links(_http.fetch_section("gundem"))
+        art = _N.parse_article_page(_http.fetch_article(rows[0]["url"]))
+        self.assertTrue(art["headline"])
+        self.assertTrue(art["date_published"])
+        self.assertGreater(len(art["body"]), 100)
+        print(f"\nLIVE article: {art['headline'][:80]} ({art['date_published']}, "
+              f"{len(art['body'])} chars body)")
+        time.sleep(1)
+
+    def test_search_is_real(self):
+        rows = _N.parse_article_links(_http.fetch_search("futbol"))
+        self.assertGreaterEqual(len(rows), 5)
+        print(f"\nLIVE search 'futbol' -> {_http.last_url}: {len(rows)} articles")
+        time.sleep(1)
+
+    def test_home_and_categories_are_real(self):
+        home = _http.fetch_home()
+        rows = _N.parse_article_links(home)
+        cats = _N.list_categories(home)
+        self.assertGreaterEqual(len(rows), 20)
+        self.assertGreaterEqual(len(cats), 12)
+        print(f"\nLIVE home: {len(rows)} links, {len(cats)} categories")
+        time.sleep(1)
+
+    def test_unknown_section_404s(self):
+        with self.assertRaises(_http.HurriyetError):
+            _http.fetch_section("boyle-bir-bolum-yok-xyz123")

hurriyet_mcp-0.1.0/tests/test_news.py

@@ -0,0 +1,71 @@
+"""Offline tests — parse real captured Hürriyet fixtures, no network."""
+import pathlib
+import sys
+import unittest
+
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parent.parent / "src"))
+
+from hurriyet_mcp import news as N
+
+FIX = pathlib.Path(__file__).resolve().parent / "fixtures"
+
+
+class TestArticleLinks(unittest.TestCase):
+    def test_gundem(self):
+        rows = N.parse_article_links((FIX / "gundem.html").read_text(encoding="utf-8"))
+        self.assertEqual(len(rows), 30)
+        first = rows[0]
+        self.assertEqual(first["id"], "43369434")
+        self.assertEqual(first["section"], "gundem")
+        self.assertEqual(first["kind"], "article")
+        self.assertTrue(first["url"].startswith("https://www.hurriyet.com.tr/gundem/"))
+        self.assertIn("Afyonkarahisar", first["title"])
+
+    def test_search_page(self):
+        rows = N.parse_article_links((FIX / "search.html").read_text(encoding="utf-8"))
+        self.assertEqual(len(rows), 45)
+        self.assertTrue(all(r["id"] for r in rows))
+
+    def test_dedupe_and_short_titles(self):
+        html = (
+            '<a href="/gundem/x-y-12345678">Short</a>'
+            '<a href="/gundem/uzun-baslik-haber-ornegi-12345678">Uzun başlıklı haber örneği burada</a>'
+            '<a href="/gundem/uzun-baslik-haber-ornegi-12345678">Uzun başlıklı haber örneği burada</a>'
+        )
+        rows = N.parse_article_links(html)
+        self.assertEqual(len(rows), 1)
+        self.assertEqual(rows[0]["id"], "12345678")
+
+
+class TestArticlePage(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        cls.a = N.parse_article_page((FIX / "article.html").read_text(encoding="utf-8"))
+
+    def test_meta(self):
+        self.assertTrue(self.a["headline"].startswith("6 ilde Telegram"))
+        self.assertEqual(self.a["section"], "Gündem")
+        self.assertEqual(self.a["date_published"], "2026-11-07T09:38:51+03:00")
+        self.assertEqual(self.a["word_count"], 143)
+
+    def test_body(self):
+        self.assertEqual(len(self.a["body"]), 931)
+        self.assertTrue(self.a["body"].startswith("İzmir Cumhuriyet Başsavcılığı"))
+
+    def test_no_newsarticle_raises(self):
+        with self.assertRaises(ValueError):
+            N.parse_article_page("<html><body>no ld here</body></html>")
+
+
+class TestCategories(unittest.TestCase):
+    def test_curated_list(self):
+        cats = N.list_categories()
+        self.assertEqual(len(cats), 15)
+        slugs = [c["slug"] for c in cats]
+        for want in ("gundem", "ekonomi", "dunya", "sporarena", "teknoloji"):
+            self.assertIn(want, slugs)
+        self.assertEqual(cats[0]["name"], "Gündem")
+
+
+if __name__ == "__main__":
+    unittest.main()