tabii-mcp 0.1.0__tar.gz

tabii_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

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

@@ -0,0 +1,95 @@
+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: Wait for PyPI
+        # The registry validates that the PyPI package + version exists,
+        # but the PyPI publish workflow runs in parallel with this one.
+        # Poll until the version appears instead of racing it: a 400 here
+        # used to fail silently under continue-on-error and left 40/43
+        # servers unlisted in the registry (2026-11-11).
+        run: |
+          python3 - << 'EOF'
+          import json, sys, time, urllib.request, urllib.error
+          d = json.load(open('server.json'))
+          pkg = d['packages'][0]
+          name = pkg.get('identifier') or pkg.get('name')
+          ver = pkg['version']
+          if not name:
+              print('ERROR: no package identifier/name in server.json')
+              sys.exit(1)
+          url = f'https://pypi.org/pypi/{name}/json'
+          for attempt in range(1, 21):
+              try:
+                  with urllib.request.urlopen(url, timeout=30) as r:
+                      data = json.load(r)
+                  if ver in data.get('releases', {}):
+                      print(f'PyPI {name}=={ver} is live (attempt {attempt})')
+                      sys.exit(0)
+              except urllib.error.HTTPError as e:
+                  print(f'attempt {attempt}: PyPI returned {e.code}')
+              except Exception as e:
+                  print(f'attempt {attempt}: {e}')
+              print(f'attempt {attempt}: {name}=={ver} not on PyPI yet, waiting 30s...')
+              time.sleep(30)
+          print(f'ERROR: {name}=={ver} did not appear on PyPI after 10 minutes')
+          sys.exit(1)
+          EOF
+
+      - 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)
+        # Failures must fail the run visibly: a silent publish failure
+        # once left 40/43 servers unlisted in the registry (2026-11-11).
+        run: |
+          mcp-publisher login github-oidc
+          mcp-publisher publish server.json

tabii_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

tabii_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.

tabii_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.5
+Name: tabii-mcp
+Version: 0.1.0
+Summary: Unofficial read-only MCP server for tabii.com (TRT streaming): catalog search, show details, live channels, people
+Author: Mohammad Abbasi
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: curl-cffi<1.0,>=0.7
+Requires-Dist: mcp<2
+Description-Content-Type: text/markdown
+
+# tabii-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/tabii-mcp
+
+Unofficial **read-only** MCP server for tabii.com, TRT's streaming platform (launched 2023, 11M+ subscribers) — Turkish series, movies, documentaries, kids content and 15 live TRT channels. Catalog search by original Turkish title, full show details (seasons, episodes, cast, languages), live-channel HLS stream URLs, and cast/crew filmographies.
+
+> Built by Mohammad Abbasi as part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with tabii.com or TRT.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "tabii": {
+      "command": "uvx",
+      "args": ["tabii-mcp==0.1.0"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m tabii_mcp.server` (needs `mcp<2`, `curl-cffi`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `tabii_search_content` | Search the catalog by original Turkish title (e.g. "gassal", "mevlana") — `language` ("tr" default, "en", "es", "ar", "ur"), `limit` 1..10; id, slug, localized title, original title, type, year, URL per match |
+| `tabii_get_show` | Full detail of one title — `show_id` or `slug` (e.g. "gassal"); localized title, original title, type, year, genres, age restriction, seasons with episode titles + durations (capped at 60), cast, directors, writers, description, audio/subtitle languages, badges, trailer count, URL |
+| `tabii_homepage` | Current homepage sections (exclusive content, series, movies, documentary, kids) with their titles — `language` |
+| `tabii_live_channels` | The 15 live TRT channels (TRT 1, TRT 2, TRT Belgesel, TRT Haber, TRT Spor, TRT Çocuk, TRT World, ...) with watch URL and public HLS stream URL |
+| `tabii_get_person` | One cast/crew member by numeric person id (e.g. Ahmet Kural is 6774) — name, job title, filmography on tabii |
+| `tabii_health` | Reachability probe (homepage + one public show) — ok / blocked / error |
+
+Example output (`tabii_search_content` / "gassal", language "en"):
+
+```json
+{"id": 438813, "slug": "gassal", "title": "The Late Offices",
+ "original_title": "Gassal", "content_type": "series", "made_year": 2024,
+ "url": "https://www.tabii.com/en/detail/438813/gassal"}
+```
+
+## How it works
+
+tabii.com exposes a public catalog API that needs no login, no API key and no session token: `eu1.tabii.com/apigateway/catalog/v1/public/shows/{id}` and `.../public/persons/{id}` (the authenticated variants — `search/v1`, `catalog/v1/show/{id}` — return HTTP 401 without a Bearer session token and are not used). The homepage is server-rendered Next.js; its `__NEXT_DATA__` JSON carries the featured sections and the 15 live channels with their public HLS URLs. Search scans the site's own sitemaps (EN + TR merged: 1,306 shows, 1,180 people — cached 6h) and resolves the top matches' localized titles through the public shows API. Two things are documented, not worked around: the sitemaps do not cover the whole catalog (some licensed titles, e.g. The Hobbit, and some originals are absent — they are still reachable by id, e.g. via the homepage sections), and genre/category browse pages are client-side shells fed by a login-gated endpoint, so no genre-browse tool is offered. Playback needs a logged-in Tabii Premium session and is out of scope — this server is catalog metadata only. Transport uses Chrome TLS impersonation (`curl-cffi`, rotation); requests are spaced ~0.8s apart; everything is read-only.
+
+## Install
+
+```bash
+uvx tabii-mcp==0.1.0        # run directly (needs uv)
+# or
+pip install tabii-mcp==0.1.0
+tabii-mcp    # starts the MCP server on stdio
+```
+
+## Tests
+
+```bash
+python -m venv .venv && .venv/bin/pip install -e .
+.venv/bin/python -m unittest discover -s tests -v
+```
+
+Offline tests run on recorded fixtures (real pages/API responses fetched 2026-11-11); live tests hit tabii.com and the public API. Tests green at build time (see repo for counts) plus an MCP stdio smoke test.
+
+## Roadmap
+
+- Genre browse if tabii ever publishes a session-free endpoint
+- "New this week" / recently-added feed from the homepage sections
+- Episode-level detail (per-episode description, audio/subtitle tracks)
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+---
+
+Built by [Mohammad Abbasi](https://github.com/mohammad-abbasi-sh) — [Almanibama](https://almanibama.ir) · [mabbasi.ir](https://mabbasi.ir)

tabii_mcp-0.1.0/README-fa.md

@@ -0,0 +1,79 @@
+# tabii-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/tabii-mcp
+
+سرور MCP غیررسمی و **فقط‌خواندنی** برای tabii.com، پلتفرم استریم TRT (راه‌اندازی ۲۰۲۳، بیش از ۱۱ میلیون مشترک) — سریال‌ها، فیلم‌ها، مستندها و محتوای کودکانهٔ ترکی، و ۱۵ کانال زندهٔ TRT. جست‌وجوی کاتالوگ با عنوان اصلی ترکی، جزئیات کامل هر عنوان (فصل‌ها، قسمت‌ها، بازیگران، زبان‌ها)، آدرس استریم HLS کانال‌های زنده و فیلم‌شناسی بازیگران و عوامل.
+
+> ساختهٔ محمد عباسی در چارچوب «کارخانهٔ MCP ترکیه» (خط تولید به سبک سپهر). وابسته به tabii.com یا TRT نیست.
+
+## برای ایجنت‌های هوش مصنوعی
+
+به پیکربندی MCP client خود اضافه کنید (stdio):
+
+```json
+{
+  "mcpServers": {
+    "tabii": {
+      "command": "uvx",
+      "args": ["tabii-mcp==0.1.0"]
+    }
+  }
+}
+```
+
+یا به‌صورت محلی اجرا کنید: `python -m tabii_mcp.server` (نیازمند `mcp<2` و `curl-cffi`).
+
+## ابزارها
+
+| ابزار | توضیح |
+|------|-------|
+| `tabii_search_content` | جست‌وجو در کاتالوگ با عنوان اصلی ترکی (مثل «gassal» یا «mevlana») — `language` (پیش‌فرض «tr»، همچنین «en»، «es»، «ar»، «ur»)، `limit` بین ۱ تا ۱۰؛ برای هر نتیجه: id، slug، عنوان محلی‌شده، عنوان اصلی، نوع، سال و URL |
+| `tabii_get_show` | جزئیات کامل یک عنوان — `show_id` یا `slug` (مثل «gassal»)؛ عنوان محلی‌شده، عنوان اصلی، نوع، سال، ژانرها، محدودیت سنی، فصل‌ها با عنوان و مدت قسمت‌ها (حداکثر ۶۰ قسمت)، بازیگران، کارگردانان، نویسندگان، توضیح، زبان‌های صدا/زیرنویس، نشان‌ها، تعداد تریلر و URL |
+| `tabii_homepage` | بخش‌های فعلی صفحهٔ اصلی (محتوای اختصاصی، سریال، فیلم، مستند، کودک) با عنوان‌هایشان — `language` |
+| `tabii_live_channels` | ۱۵ کانال زندهٔ TRT (TRT 1، TRT 2، TRT Belgesel، TRT Haber، TRT Spor، TRT Çocuk، TRT World و…) — آدرس تماشا و آدرس عمومی استریم HLS |
+| `tabii_get_person` | یک بازیگر/عضو عوامل با شناسهٔ عددی (مثلاً احمد کورال 6774) — نام، سمت و فیلم‌شناسی او در tabii |
+| `tabii_health` | بررسی دسترسی (صفحهٔ اصلی + یک محتوای عمومی) — ok / blocked / error |
+
+نمونهٔ خروجی (`tabii_search_content` / «gassal»، زبان «en»):
+
+```json
+{"id": 438813, "slug": "gassal", "title": "The Late Offices",
+ "original_title": "Gassal", "content_type": "series", "made_year": 2024,
+ "url": "https://www.tabii.com/en/detail/438813/gassal"}
+```
+
+## چطور کار می‌کند؟
+
+tabii.com یک API عمومی کاتالوگ دارد که بدون ورود، کلید API و توکن نشست کار می‌کند: `eu1.tabii.com/apigateway/catalog/v1/public/shows/{id}` و `.../public/persons/{id}` (نسخه‌های نیازمند احراز هویت — `search/v1` و `catalog/v1/show/{id}` — بدون توکن Bearer خطای HTTP 401 می‌دهند و استفاده نمی‌شوند). صفحهٔ اصلی با Next.js سمت سرور ساخته می‌شود؛ JSON داخلی `__NEXT_DATA__` بخش‌های ویژه و ۱۵ کانال زنده را با آدرس‌های عمومی HLS در خود دارد. جست‌وجو نقشهٔ سایت را می‌خواند (EN + TR ادغام‌شده: ۱٬۳۰۶ عنوان و ۱٬۱۸۰ نفر — با ۶ ساعت کش) و عنوان‌های محلی‌شدهٔ بهترین تطابق‌ها را از API عمومی می‌گیرد. دو موضوع دور زده نمی‌شود، مستند می‌شود: نقشهٔ سایت کل کاتالوگ را پوشش نمی‌دهد (برخی عنوان‌های دارای مجوز، مثل هابیت، و برخی آثار اصلی غایب‌اند — با شناسه همچنان قابل دسترسی‌اند، مثلاً از بخش‌های صفحهٔ اصلی) و صفحات ژانر/دسته پوسته‌های سمت کاربرند که از یک endpoint نیازمند ورود تغذیه می‌شوند، پس ابزار مرور ژانر ارائه نمی‌شود. پخش به نشست واردشدهٔ Tabii Premium نیاز دارد و خارج از محدوده است — این سرور فقط فرادادهٔ کاتالوگ می‌دهد. انتقال با جعل TLS کروم انجام می‌شود (`curl-cffi`، چرخشی)؛ درخواست‌ها با فاصلهٔ حدود ۰٫۸ ثانیه ارسال می‌شوند؛ همه‌چیز فقط‌خواندنی است.
+
+## نصب
+
+```bash
+uvx tabii-mcp==0.1.0        # اجرای مستقیم (نیازمند uv)
+# یا
+pip install tabii-mcp==0.1.0
+tabii-mcp    # سرور MCP را روی stdio راه می‌اندازد
+```
+
+## تست‌ها
+
+```bash
+python -m venv .venv && .venv/bin/pip install -e .
+.venv/bin/python -m unittest discover -s tests -v
+```
+
+تست‌های آفلاین با فیکسچرهای ضبط‌شده اجرا می‌شوند (صفحات و پاسخ‌های واقعی API، گرفته‌شده در ۱۱ نوامبر ۲۰۲۶)؛ تست‌های زنده به tabii.com و API عمومی وصل می‌شوند. تست‌ها هنگام ساخت سبز بودند (برای شمار به مخزن نگاه کنید)؛ به‌علاوه یک تست دود MCP روی stdio وجود دارد.
+
+## نقشهٔ راه
+
+- مرور ژانر، اگر tabii روزی endpoint بدون نشست منتشر کند
+- فید «تازه‌های این هفته» / تازه‌اضافه‌شده‌ها از بخش‌های صفحهٔ اصلی
+- جزئیات در سطح قسمت (توضیح هر قسمت، ترک‌های صدا/زیرنویس)
+
+## پروانه
+
+MIT — ببینید [LICENSE](LICENSE).
+
+---
+
+Built by [Mohammad Abbasi](https://github.com/mohammad-abbasi-sh) — [Almanibama](https://almanibama.ir) · [mabbasi.ir](https://mabbasi.ir)

tabii_mcp-0.1.0/README-tr.md

@@ -0,0 +1,79 @@
+# tabii-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/tabii-mcp
+
+TRT'nin dijital yayın platformu tabii.com için resmi olmayan, **salt okunur** MCP sunucusu (2023'te yayına girdi, 11 milyondan fazla abone) — Türkçe diziler, filmler, belgeseller, çocuk içerikleri ve 15 canlı TRT kanalı. Orijinal Türkçe başlığa göre katalog araması, dizi/film detayları (sezonlar, bölümler, oyuncular, diller), canlı kanal HLS yayın adresleri ve oyuncu/ekip filmografileri.
+
+> Mohammad Abbasi tarafından "Turkey MCP factory" (Sepehr tarzı hat) kapsamında geliştirildi. tabii.com veya TRT ile bağlantısı yoktur.
+
+## Yapay zekâ ajanları için
+
+MCP istemci yapılandırmanıza ekleyin (stdio):
+
+```json
+{
+  "mcpServers": {
+    "tabii": {
+      "command": "uvx",
+      "args": ["tabii-mcp==0.1.0"]
+    }
+  }
+}
+```
+
+Veya yerelde çalıştırın: `python -m tabii_mcp.server` (`mcp<2`, `curl-cffi` gerekir).
+
+## Araçlar
+
+| Araç | Açıklama |
+|------|----------|
+| `tabii_search_content` | Katalogda orijinal Türkçe başlığa göre arama (örn. "gassal", "mevlana") — `language` ("tr" varsayılan, "en", "es", "ar", "ur"), `limit` 1..10; her sonuçta id, slug, yerelleştirilmiş başlık, orijinal başlık, tür, yıl ve URL |
+| `tabii_get_show` | Bir içeriğin tüm detayı — `show_id` veya `slug` (örn. "gassal"); yerelleştirilmiş başlık, orijinal başlık, tür, yıl, türler (genre), yaş sınırı, bölüm başlıkları + süreleriyle sezonlar (en fazla 60 bölüm), oyuncular, yönetmenler, senaristler, açıklama, ses/altyazı dilleri, rozetler, fragman sayısı, URL |
+| `tabii_homepage` | Ana sayfadaki güncel bölümler (tabii'ye Özel İçerikler, Dizi, Film, Belgesel, Çocuk) ve içerikleri — `language` |
+| `tabii_live_channels` | 15 canlı TRT kanalı (TRT 1, TRT 2, TRT Belgesel, TRT Haber, TRT Spor, TRT Çocuk, TRT World, ...) — izleme URL'si ve herkese açık HLS yayın adresi |
+| `tabii_get_person` | Bir oyuncu/ekip üyesi, sayısal kişi id'siyle (örn. Ahmet Kural 6774) — ad, görev ve tabii'deki filmografisi |
+| `tabii_health` | Erişilebilirlik kontrolü (ana sayfa + bir herkese açık içerik) — ok / blocked / error |
+
+Örnek çıktı (`tabii_search_content` / "gassal", dil "en"):
+
+```json
+{"id": 438813, "slug": "gassal", "title": "The Late Offices",
+ "original_title": "Gassal", "content_type": "series", "made_year": 2024,
+ "url": "https://www.tabii.com/en/detail/438813/gassal"}
+```
+
+## Nasıl çalışır?
+
+tabii.com, giriş, API anahtarı ve oturum jetonu gerektirmeyen herkese açık bir katalog API'si sunar: `eu1.tabii.com/apigateway/catalog/v1/public/shows/{id}` ve `.../public/persons/{id}` (kimlik doğrulamalı sürümler — `search/v1`, `catalog/v1/show/{id}` — Bearer oturum jetonu olmadan HTTP 401 döner ve kullanılmaz). Ana sayfa sunucu taraflı Next.js ile oluşturulur; `__NEXT_DATA__` JSON'i öne çıkan bölümleri ve 15 canlı kanalı herkese açık HLS adresleriyle birlikte taşır. Arama, sitenin site haritalarını tarar (EN + TR birleştirilmiş: 1.306 içerik, 1.180 kişi — 6 saat önbellekli) ve en iyi eşleşmelerin yerelleştirilmiş başlıklarını herkese açık içerik API'siyle çözer. İki konu aşılmaya çalışılmaz, belgelenir: site haritaları kataloğun tamamını kapsamaz (bazı lisanslı içerikler, örn. Hobbit, ve bazı orijinaller eksik — id ile yine de erişilebilir, örn. ana sayfa bölümlerinden) ve tür/kategori sayfaları giriş gerektiren bir uç noktadan beslenen istemci taraflı kabuklardır, bu yüzden tür tarama aracı sunulmaz. Oynatma, giriş yapmış bir Tabii Premium oturumu gerektirir ve kapsam dışıdır — bu sunucu yalnızca katalog verisi sunar. Aktarım, Chrome TLS taklidi kullanır (`curl-cffi`, dönüşümlü); istekler ~0,8 sn aralıklarla yapılır; her şey salt okunurdur.
+
+## Kurulum
+
+```bash
+uvx tabii-mcp==0.1.0        # doğrudan çalıştır (uv gerekir)
+# veya
+pip install tabii-mcp==0.1.0
+tabii-mcp    # MCP sunucusunu stdio üzerinde başlatır
+```
+
+## Testler
+
+```bash
+python -m venv .venv && .venv/bin/pip install -e .
+.venv/bin/python -m unittest discover -s tests -v
+```
+
+Çevrimdışı testler kayıtlı örneklerle çalışır (11.11.2026'da çekilmiş gerçek sayfalar/API yanıtları); canlı testler tabii.com ve herkese açık API'ye bağlanır. Derleme anında testler geçti (sayılar için depoya bakın); ayrıca bir MCP stdio duman testi vardır.
+
+## Yol haritası
+
+- tabii oturumsuz bir uç nokta yayınlarsa tür tarama
+- Ana sayfa bölümlerinden "bu hafta yeni" / yeni eklenenler akışı
+- Bölüm düzeyinde detay (bölüm açıklaması, ses/altyazı parçaları)
+
+## Lisans
+
+MIT — bkz. [LICENSE](LICENSE).
+
+---
+
+Built by [Mohammad Abbasi](https://github.com/mohammad-abbasi-sh) — [Almanibama](https://almanibama.ir) · [mabbasi.ir](https://mabbasi.ir)

tabii_mcp-0.1.0/README.md

@@ -0,0 +1,79 @@
+# tabii-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/tabii-mcp
+
+Unofficial **read-only** MCP server for tabii.com, TRT's streaming platform (launched 2023, 11M+ subscribers) — Turkish series, movies, documentaries, kids content and 15 live TRT channels. Catalog search by original Turkish title, full show details (seasons, episodes, cast, languages), live-channel HLS stream URLs, and cast/crew filmographies.
+
+> Built by Mohammad Abbasi as part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with tabii.com or TRT.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "tabii": {
+      "command": "uvx",
+      "args": ["tabii-mcp==0.1.0"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m tabii_mcp.server` (needs `mcp<2`, `curl-cffi`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `tabii_search_content` | Search the catalog by original Turkish title (e.g. "gassal", "mevlana") — `language` ("tr" default, "en", "es", "ar", "ur"), `limit` 1..10; id, slug, localized title, original title, type, year, URL per match |
+| `tabii_get_show` | Full detail of one title — `show_id` or `slug` (e.g. "gassal"); localized title, original title, type, year, genres, age restriction, seasons with episode titles + durations (capped at 60), cast, directors, writers, description, audio/subtitle languages, badges, trailer count, URL |
+| `tabii_homepage` | Current homepage sections (exclusive content, series, movies, documentary, kids) with their titles — `language` |
+| `tabii_live_channels` | The 15 live TRT channels (TRT 1, TRT 2, TRT Belgesel, TRT Haber, TRT Spor, TRT Çocuk, TRT World, ...) with watch URL and public HLS stream URL |
+| `tabii_get_person` | One cast/crew member by numeric person id (e.g. Ahmet Kural is 6774) — name, job title, filmography on tabii |
+| `tabii_health` | Reachability probe (homepage + one public show) — ok / blocked / error |
+
+Example output (`tabii_search_content` / "gassal", language "en"):
+
+```json
+{"id": 438813, "slug": "gassal", "title": "The Late Offices",
+ "original_title": "Gassal", "content_type": "series", "made_year": 2024,
+ "url": "https://www.tabii.com/en/detail/438813/gassal"}
+```
+
+## How it works
+
+tabii.com exposes a public catalog API that needs no login, no API key and no session token: `eu1.tabii.com/apigateway/catalog/v1/public/shows/{id}` and `.../public/persons/{id}` (the authenticated variants — `search/v1`, `catalog/v1/show/{id}` — return HTTP 401 without a Bearer session token and are not used). The homepage is server-rendered Next.js; its `__NEXT_DATA__` JSON carries the featured sections and the 15 live channels with their public HLS URLs. Search scans the site's own sitemaps (EN + TR merged: 1,306 shows, 1,180 people — cached 6h) and resolves the top matches' localized titles through the public shows API. Two things are documented, not worked around: the sitemaps do not cover the whole catalog (some licensed titles, e.g. The Hobbit, and some originals are absent — they are still reachable by id, e.g. via the homepage sections), and genre/category browse pages are client-side shells fed by a login-gated endpoint, so no genre-browse tool is offered. Playback needs a logged-in Tabii Premium session and is out of scope — this server is catalog metadata only. Transport uses Chrome TLS impersonation (`curl-cffi`, rotation); requests are spaced ~0.8s apart; everything is read-only.
+
+## Install
+
+```bash
+uvx tabii-mcp==0.1.0        # run directly (needs uv)
+# or
+pip install tabii-mcp==0.1.0
+tabii-mcp    # starts the MCP server on stdio
+```
+
+## Tests
+
+```bash
+python -m venv .venv && .venv/bin/pip install -e .
+.venv/bin/python -m unittest discover -s tests -v
+```
+
+Offline tests run on recorded fixtures (real pages/API responses fetched 2026-11-11); live tests hit tabii.com and the public API. Tests green at build time (see repo for counts) plus an MCP stdio smoke test.
+
+## Roadmap
+
+- Genre browse if tabii ever publishes a session-free endpoint
+- "New this week" / recently-added feed from the homepage sections
+- Episode-level detail (per-episode description, audio/subtitle tracks)
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+---
+
+Built by [Mohammad Abbasi](https://github.com/mohammad-abbasi-sh) — [Almanibama](https://almanibama.ir) · [mabbasi.ir](https://mabbasi.ir)

tabii_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tabii-mcp"
+version = "0.1.0"
+description = "Unofficial read-only MCP server for tabii.com (TRT streaming): catalog search, show details, live channels, people"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+dependencies = [
+    "mcp<2",
+    "curl-cffi>=0.7,<1.0",
+]
+authors = [{ name = "Mohammad Abbasi" }]
+
+[project.scripts]
+tabii-mcp = "tabii_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tabii_mcp"]

tabii_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 tabii.com — TRT streaming catalog, live channels, people.","name":"io.github.mohammad-abbasi-sh/tabii-mcp","packages":[{"identifier":"tabii-mcp","registryBaseUrl":"https://pypi.org","registryType":"pypi","transport":{"type":"stdio"},"version":"0.1.0"}],"repository":{"source":"github","url":"https://github.com/mohammad-abbasi-sh/tabii-mcp"},"title":"tabii (TRT Streaming)","version":"0.1.0","websiteUrl":"https://github.com/mohammad-abbasi-sh/tabii-mcp"}

tabii_mcp-0.1.0/src/tabii_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""tabii_mcp — unofficial read-only MCP server for tabii.com."""
+
+__version__ = "0.1.0"