emko-mcp 0.1.0__tar.gz

emko_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: emko-mcp
+Version: 0.1.0
+Summary: Emko Elektronik ürün manuellerini (PDF) arayıp okuyan MCP sunucusu
+Project-URL: Homepage, https://github.com/OGUZHANCOSKUN/emko-mcp
+Project-URL: Issues, https://github.com/OGUZHANCOSKUN/emko-mcp/issues
+Author: Oğuzhan Coşkun
+License: MIT
+Keywords: claude,datasheet,emko,manual,mcp,pdf
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Documentation
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp>=1.2.0
+Requires-Dist: pypdf>=4.0
+Description-Content-Type: text/markdown
+
+# emko-mcp
+
+Emko Elektronik (www.emkoelektronik.com.tr) ürün manuellerini, broşürlerini ve
+firmware dokümanlarını arayıp okuyabilen bir **MCP (Model Context Protocol)**
+sunucusu. Claude Desktop, Claude Code veya MCP destekleyen herhangi bir istemciye
+bağlanır; PDF'leri arka planda indirip metnini çıkararak modele verir.
+
+## Kurulum
+
+```bash
+pip install emko-mcp
+```
+
+Kurulduktan sonra `emko-mcp` komutu kullanılabilir hale gelir.
+
+## Claude Desktop'a bağlama
+
+`claude_desktop_config.json` dosyanıza şu girişi ekleyin:
+
+```json
+{
+  "mcpServers": {
+    "emko": {
+      "command": "emko-mcp"
+    }
+  }
+}
+```
+
+Config dosyasının yeri:
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+Kaydedip Claude Desktop'ı tamamen kapatıp yeniden açın.
+
+> `emko-mcp` komutu bulunamazsa, tam yolu kullanabilirsiniz. Yolu bulmak için:
+> Windows'ta `where emko-mcp`, macOS/Linux'ta `which emko-mcp`.
+
+## Sağladığı araçlar (tools)
+
+- **`emko_search_manuals`** — Bir anahtar kelimeyle (örn. "Proop", "EtherCAT",
+  "IPERTU") eşleşen dosyaları listeler. İndirmez, sadece adları döndürür.
+- **`emko_get_manual`** — Eşleşen ilk PDF'i indirip metnini çıkarır ve döndürür.
+- **`emko_crawl_category`** — Verilen ürün kategori sayfalarına tek tek girip
+  manuelleri indeksler (Yükleme Merkezi'nde henüz listelenmemiş yeni ürünler için).
+
+## Örnek kullanım
+
+Claude'a şunları sorabilirsiniz:
+
+- "emko_search_manuals ile Proop panellerinin kılavuzlarını bul"
+- "EtherCAT Bus Coupler'ın SDO parametrelerine bak" (Claude uygun tool'u seçer)
+- "IPERTU Slim Plus PLC modülünün kullanım kılavuzunu özetle"
+
+## Notlar
+
+- Bu paket, herkese açık `www.emkoelektronik.com.tr` sayfalarını okur;
+  kimlik doğrulama gerektirmez.
+- Bazı eski broşürler taranmış (görsel) PDF olabilir; bu durumda metin çıkarımı
+  sınırlı olur.
+
+## Lisans
+
+MIT

emko_mcp-0.1.0/README.md

@@ -0,0 +1,64 @@
+# emko-mcp
+
+Emko Elektronik (www.emkoelektronik.com.tr) ürün manuellerini, broşürlerini ve
+firmware dokümanlarını arayıp okuyabilen bir **MCP (Model Context Protocol)**
+sunucusu. Claude Desktop, Claude Code veya MCP destekleyen herhangi bir istemciye
+bağlanır; PDF'leri arka planda indirip metnini çıkararak modele verir.
+
+## Kurulum
+
+```bash
+pip install emko-mcp
+```
+
+Kurulduktan sonra `emko-mcp` komutu kullanılabilir hale gelir.
+
+## Claude Desktop'a bağlama
+
+`claude_desktop_config.json` dosyanıza şu girişi ekleyin:
+
+```json
+{
+  "mcpServers": {
+    "emko": {
+      "command": "emko-mcp"
+    }
+  }
+}
+```
+
+Config dosyasının yeri:
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+Kaydedip Claude Desktop'ı tamamen kapatıp yeniden açın.
+
+> `emko-mcp` komutu bulunamazsa, tam yolu kullanabilirsiniz. Yolu bulmak için:
+> Windows'ta `where emko-mcp`, macOS/Linux'ta `which emko-mcp`.
+
+## Sağladığı araçlar (tools)
+
+- **`emko_search_manuals`** — Bir anahtar kelimeyle (örn. "Proop", "EtherCAT",
+  "IPERTU") eşleşen dosyaları listeler. İndirmez, sadece adları döndürür.
+- **`emko_get_manual`** — Eşleşen ilk PDF'i indirip metnini çıkarır ve döndürür.
+- **`emko_crawl_category`** — Verilen ürün kategori sayfalarına tek tek girip
+  manuelleri indeksler (Yükleme Merkezi'nde henüz listelenmemiş yeni ürünler için).
+
+## Örnek kullanım
+
+Claude'a şunları sorabilirsiniz:
+
+- "emko_search_manuals ile Proop panellerinin kılavuzlarını bul"
+- "EtherCAT Bus Coupler'ın SDO parametrelerine bak" (Claude uygun tool'u seçer)
+- "IPERTU Slim Plus PLC modülünün kullanım kılavuzunu özetle"
+
+## Notlar
+
+- Bu paket, herkese açık `www.emkoelektronik.com.tr` sayfalarını okur;
+  kimlik doğrulama gerektirmez.
+- Bazı eski broşürler taranmış (görsel) PDF olabilir; bu durumda metin çıkarımı
+  sınırlı olur.
+
+## Lisans
+
+MIT

emko_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "emko-mcp"
+version = "0.1.0"
+description = "Emko Elektronik ürün manuellerini (PDF) arayıp okuyan MCP sunucusu"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+    { name = "Oğuzhan Coşkun" },
+]
+keywords = ["mcp", "emko", "manual", "datasheet", "pdf", "claude"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+    "Topic :: Documentation",
+]
+dependencies = [
+    "mcp>=1.2.0",
+    "httpx>=0.27",
+    "pypdf>=4.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/OGUZHANCOSKUN/emko-mcp"
+Issues = "https://github.com/OGUZHANCOSKUN/emko-mcp/issues"
+
+# Kurulunca `emko-mcp` komutu PATH'e eklenir; MCP config'inde command olarak
+# doğrudan bu kullanılabilir.
+[project.scripts]
+emko-mcp = "emko_mcp:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/emko_mcp"]

emko_mcp-0.1.0/src/emko_mcp/__init__.py

@@ -0,0 +1,6 @@
+"""Emko Elektronik ürün manuelleri için MCP sunucusu."""
+
+from .server import main, mcp
+
+__version__ = "0.1.0"
+__all__ = ["main", "mcp", "__version__"]

emko_mcp-0.1.0/src/emko_mcp/server.py

@@ -0,0 +1,430 @@
+"""
+emko_mcp.py — Emko Elektronik ürün manuellerini arayıp getiren MCP sunucusu.
+
+Bulgular (bkz. emko_pdf_indirici.py):
+  - Site tamamen statik render ediyor, tarayıcı otomasyonuna gerek yok.
+  - "İNDİR" butonları <a href> değil, onclick="location.href='downloads?<TOKEN>'"
+    şeklinde JS ile çalışıyor. Sayfadaki <base href> yüzünden bu KÖK dizine
+    çözülüyor -> gerçek adres:
+        https://www.emkoelektronik.com.tr/downloads?<TOKEN>
+
+Bu sunucu iki tool sağlar:
+  1. emko_search_manuals  — bir sayfadaki (varsayılan: Yükleme Merkezi) dosyaları
+     anahtar kelimeyle arar, indirmeden sadece eşleşenleri listeler.
+  2. emko_get_manual      — eşleşen ilk PDF'i indirir, metnini çıkarır ve döner.
+
+Kurulum:
+    pip install "mcp[cli]" httpx pypdf
+
+Çalıştırma (stdio, örn. Claude Desktop / Claude Code'a bağlamak için):
+    python emko_mcp.py
+"""
+
+import re
+import io
+import os
+from typing import List, Optional
+
+import httpx
+from pydantic import BaseModel, Field, ConfigDict
+from mcp.server.fastmcp import FastMCP
+
+try:
+    from pypdf import PdfReader
+except ImportError:
+    PdfReader = None  # metin çıkarımı olmadan da tool'lar çalışabilsin diye
+
+mcp = FastMCP("emko_mcp")
+
+BASE = "https://www.emkoelektronik.com.tr"
+DEFAULT_INDEX_URL = f"{BASE}/tr/e-destek/yukleme-merkezi"
+# İndirme linkleri sayfada onclick="location.href='downloads?<token>'" olarak duruyor.
+# Sitedeki <base href="https://www.emkoelektronik.com.tr/"> etiketi yüzünden bu göreli
+# link KÖK dizine göre çözülüyor -> https://www.emkoelektronik.com.tr/downloads?<token>
+DOWNLOAD_URL = f"{BASE}/downloads"
+
+# Manuel olarak (tarayıcıdan indirip) bu klasöre koyduğunuz PDF'ler için.
+# Ortam değişkeni EMKO_MANUALS_DIR ile değiştirilebilir; yoksa script'in
+# bulunduğu yerdeki "manuals" klasörü kullanılır.
+LOCAL_MANUALS_DIR = os.environ.get(
+    "EMKO_MANUALS_DIR",
+    os.path.join(os.path.dirname(os.path.abspath(__file__)), "manuals"),
+)
+
+HEADERS = {
+    "User-Agent": (
+        "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
+        "(KHTML, like Gecko) Chrome/124.0 Safari/537.36"
+    )
+}
+
+DOWNLOAD_RE = re.compile(r"""location\.href=['"]downloads\?([A-F0-9]+)['"]""")
+
+# Satır içindeki İLK anlamlı <b>...</b> metnini dosya adı olarak alıyoruz.
+# Hem ürün sayfalarında ("Dosya Adı : <b>X.pdf</b> ... <b onclick=...>İNDİR</b>")
+# hem de Yükleme Merkezi'nin tablo satırlarında ("<td><b>X</b></td> ... <button
+# onclick=...><b>İNDİR</b></button>") dosya adı, token'dan önceki ilk bold metindir;
+# sadece "İNDİR", "·" ve "12.34 Mb/Kb" gibi boyut ifadelerini eliyoruz.
+BOLD_RE = re.compile(r"<b>\s*([^<]+?)\s*</b>", re.IGNORECASE)
+SIZE_LIKE_RE = re.compile(r"^[\d.,]+\s*(Kb|Mb|Gb)\.?$", re.IGNORECASE)
+
+# Kategori sayfalarında her ürün kutucuğu bu görselle sarmalanıyor:
+# [![](.../spacer.gif)](https://www.emkoelektronik.com.tr/tr/urunler/<slug>)
+PRODUCT_LINK_RE = re.compile(
+    r"""spacer\.gif['"]?\)\]\((https://www\.emkoelektronik\.com\.tr/tr/urunler/[^)\s]+)\)"""
+)
+
+# Basit bellek-içi önbellek: {index_key: [(token, filename), ...]}
+# index_key ya gerçek bir URL (doğrudan fetch edilir) ya da emko_crawl_category'nin
+# doldurduğu bir "cache_key" ismi olabilir.
+_index_cache: dict[str, list[tuple[str, str]]] = {}
+
+
+def _extract_product_links(html: str) -> list[str]:
+    seen = set()
+    links = []
+    for m in PRODUCT_LINK_RE.finditer(html):
+        url = m.group(1)
+        if url not in seen:
+            seen.add(url)
+            links.append(url)
+    return links
+
+
+async def _crawl_index(
+    start_urls: list[str], max_depth: int = 3
+) -> list[tuple[str, str, str]]:
+    """Kategori sayfalarından başlayıp gerçek ürünlere inene kadar dalar.
+
+    Döndürür: [(token, dosya_adı, bulunduğu_sayfa_url), ...] — aynı token birden
+    fazla üründe geçse bile sadece bir kez döner.
+    """
+    visited: set[str] = set()
+    seen_tokens: set[str] = set()
+    results: list[tuple[str, str, str]] = []
+
+    async def visit(url: str, depth: int):
+        if url in visited or depth > max_depth:
+            return
+        visited.add(url)
+        try:
+            html = await _fetch(url)
+        except httpx.HTTPError:
+            return
+
+        pairs = _extract_entries(html)
+        if pairs:
+            for token, filename in pairs:
+                if token not in seen_tokens:
+                    seen_tokens.add(token)
+                    results.append((token, filename, url))
+        else:
+            for link in _extract_product_links(html):
+                await visit(link, depth + 1)
+
+    for u in start_urls:
+        await visit(u, depth=1)
+    return results
+
+
+async def _fetch(url: str) -> str:
+    async with httpx.AsyncClient(headers=HEADERS, timeout=30, follow_redirects=True) as client:
+        resp = await client.get(url)
+        resp.raise_for_status()
+        return resp.text
+
+
+def _first_meaningful_bold(window: str) -> Optional[str]:
+    for m in BOLD_RE.finditer(window):
+        text = m.group(1).strip()
+        if not text or text == "İNDİR" or text == "·" or SIZE_LIKE_RE.match(text):
+            continue
+        return text
+    return None
+
+
+def _extract_entries(html: str) -> list[tuple[str, str]]:
+    """(token, dosya_adı) çiftlerini döner.
+
+    Her token için, bir önceki token'ın bittiği yerden bu token'a kadarki
+    pencerede ilk anlamlı <b> metnini dosya adı olarak alır. Bu hem ürün
+    sayfalarında ("Dosya Adı : <b>X.pdf</b>") hem de Yükleme Merkezi'nin tablo
+    satırlarında ("<td><b>X</b></td>") doğru çalışır.
+    """
+    entries = []
+    prev_end = 0
+    for m in DOWNLOAD_RE.finditer(html):
+        token = m.group(1)
+        window = html[prev_end:m.start()]
+        filename = _first_meaningful_bold(window) or f"dosya-{token[:10]}.pdf"
+        entries.append((token, filename))
+        prev_end = m.end()
+    return entries
+
+
+async def _get_index(index_url: str, force_refresh: bool = False) -> list[tuple[str, str]]:
+    if force_refresh or index_url not in _index_cache:
+        html = await _fetch(index_url)
+        _index_cache[index_url] = _extract_entries(html)
+    return _index_cache[index_url]
+
+
+def _extract_pdf_text(pdf_bytes: bytes, max_chars: int = 200000) -> str:
+    if PdfReader is None:
+        return "[pypdf kurulu değil — metin çıkarılamadı. `pip install pypdf` çalıştırın.]"
+    # Gelen içerik geçerli bir PDF değilse (site hata sayfası döndürdüyse vs.)
+    # pypdf istisna fırlatır; bunu yakalayıp anlamlı bir mesaja çeviriyoruz.
+    if not pdf_bytes[:5].startswith(b"%PDF"):
+        snippet = pdf_bytes[:200].decode("utf-8", errors="replace")
+        return (
+            "[İndirilen içerik geçerli bir PDF değil (site beklenen dosyayı "
+            f"döndürmedi). İlk baytlar: {snippet!r}]"
+        )
+    try:
+        reader = PdfReader(io.BytesIO(pdf_bytes))
+        parts = [page.extract_text() or "" for page in reader.pages]
+    except Exception as e:
+        return f"[PDF okunamadı: {type(e).__name__}: {e}]"
+    text = "\n".join(parts).strip()
+    if len(text) > max_chars:
+        text = text[:max_chars] + f"\n\n[...metin {len(text)} karakter, {max_chars} karakterde kesildi...]"
+    return text or "[PDF'ten metin çıkarılamadı — muhtemelen taranmış/görsel bir belge.]"
+
+
+class SearchManualsInput(BaseModel):
+    """emko_search_manuals için girdi modeli."""
+
+    model_config = ConfigDict(str_strip_whitespace=True, extra="forbid")
+
+    query: str = Field(
+        ...,
+        description="Dosya adında veya ilişkili ürün bilgisinde aranacak anahtar kelime "
+                    "(örn. 'Proop 7 Lite', 'PIREG', 'EtherCAT').",
+        min_length=1,
+        max_length=200,
+    )
+    index_url: Optional[str] = Field(
+        default=None,
+        description="Aranacak liste sayfası. Boş bırakılırsa Yükleme Merkezi "
+                    "(tüm kategoriler) kullanılır.",
+    )
+    limit: int = Field(default=10, description="Döndürülecek maksimum sonuç sayısı.", ge=1, le=50)
+
+
+@mcp.tool(
+    name="emko_search_manuals",
+    annotations={
+        "title": "Emko manuel/dosya ara",
+        "readOnlyHint": True,
+        "destructiveHint": False,
+        "idempotentHint": True,
+        "openWorldHint": True,
+    },
+)
+async def emko_search_manuals(params: SearchManualsInput) -> str:
+    """Emko Elektronik sitesindeki manuel/broşür/firmware PDF'lerini anahtar kelimeyle arar.
+
+    Dosyayı indirmez — sadece eşleşen dosya adlarını listeler. Belirli bir dosyanın
+    içeriğini okumak için sonradan emko_get_manual çağırın.
+
+    Args:
+        params (SearchManualsInput): query (aranacak kelime), index_url (opsiyonel
+            liste sayfası), limit (maksimum sonuç).
+
+    Returns:
+        str: Eşleşen dosyaların "- <dosya adı>" biçiminde listesi, ya da eşleşme
+            yoksa bunu belirten bir mesaj.
+    """
+    index_url = params.index_url or DEFAULT_INDEX_URL
+    try:
+        entries = await _get_index(index_url)
+    except httpx.HTTPError as e:
+        return f"Hata: Sayfa çekilemedi ({index_url}): {e}"
+
+    q = params.query.lower()
+    matches = [fname for _, fname in entries if q in fname.lower()]
+    # tekrarları kaldır, sırayı koru
+    seen = set()
+    unique_matches = []
+    for m in matches:
+        if m not in seen:
+            seen.add(m)
+            unique_matches.append(m)
+
+    if not unique_matches:
+        return f"'{params.query}' için eşleşen dosya bulunamadı ({len(entries)} dosya tarandı)."
+
+    unique_matches = unique_matches[: params.limit]
+    return "Eşleşen dosyalar:\n" + "\n".join(f"- {m}" for m in unique_matches)
+
+
+class GetManualInput(BaseModel):
+    """emko_get_manual için girdi modeli."""
+
+    model_config = ConfigDict(str_strip_whitespace=True, extra="forbid")
+
+    query: str = Field(
+        ...,
+        description="İndirilecek dosyayı bulmak için anahtar kelime (dosya adının "
+                    "bir parçası yeterli, örn. 'Proop 7 Lite Hızlı Başlangıç').",
+        min_length=1,
+        max_length=200,
+    )
+    index_url: Optional[str] = Field(
+        default=None,
+        description="Aranacak liste sayfası. Boş bırakılırsa Yükleme Merkezi kullanılır.",
+    )
+    max_chars: int = Field(
+        default=200000,
+        description="Döndürülecek maksimum metin uzunluğu. Belge daha uzunsa bu "
+                    "noktada kesilir. Çok büyük bir kılavuzun tamamı gerekiyorsa "
+                    "artırılabilir.",
+        ge=1000,
+        le=1000000,
+    )
+
+
+@mcp.tool(
+    name="emko_get_manual",
+    annotations={
+        "title": "Emko manuel getir ve metnini çıkar",
+        "readOnlyHint": True,
+        "destructiveHint": False,
+        "idempotentHint": True,
+        "openWorldHint": True,
+    },
+)
+async def emko_get_manual(params: GetManualInput) -> str:
+    """Sorguya en iyi uyan PDF'i indirir ve metnini çıkarıp döner.
+
+    Birden fazla dosya eşleşirse ilkini kullanır ve diğer eşleşen dosya adlarını
+    da bilgi amaçlı listeler, böylece gerekirse daha spesifik bir sorguyla tekrar
+    çağrılabilir.
+
+    Args:
+        params (GetManualInput): query (dosya adı/ürün anahtar kelimesi),
+            index_url (opsiyonel liste sayfası).
+
+    Returns:
+        str: Bulunan dosyanın adı, kaç alternatif daha bulunduğu ve PDF'ten
+            çıkarılan metin (çok uzunsa kesilmiş olarak).
+    """
+    index_url = params.index_url or DEFAULT_INDEX_URL
+    try:
+        entries = await _get_index(index_url)
+    except httpx.HTTPError as e:
+        return f"Hata: Sayfa çekilemedi ({index_url}): {e}"
+
+    q = params.query.lower()
+    matches = [(token, fname) for token, fname in entries if q in fname.lower()]
+
+    if not matches:
+        return f"'{params.query}' için eşleşen dosya bulunamadı."
+
+    token, filename = matches[0]
+    download_url = f"{DOWNLOAD_URL}?{token}"
+    # Site, sayfadan gelmeyen doğrudan istekleri 503 ile engelleyebiliyor;
+    # gerçek bir ürün sayfasından tıklanmış gibi görünmek için Referer ekliyoruz.
+    dl_headers = {**HEADERS, "Referer": index_url}
+
+    try:
+        async with httpx.AsyncClient(headers=dl_headers, timeout=60, follow_redirects=True) as client:
+            resp = await client.get(download_url)
+            resp.raise_for_status()
+            pdf_bytes = resp.content
+    except httpx.HTTPError as e:
+        return f"Hata: '{filename}' indirilemedi: {e}"
+
+    text = _extract_pdf_text(pdf_bytes, max_chars=params.max_chars)
+
+    extra = ""
+    if len(matches) > 1:
+        others = ", ".join(f"'{m[1]}'" for m in matches[1:5])
+        extra = f"\n\n(Not: {len(matches) - 1} alternatif dosya daha eşleşti: {others}...)"
+
+    return f"# {filename}\n\n{text}{extra}"
+
+
+class CrawlCategoryInput(BaseModel):
+    """emko_crawl_category için girdi modeli."""
+
+    model_config = ConfigDict(str_strip_whitespace=True, extra="forbid")
+
+    category_urls: List[str] = Field(
+        ...,
+        description="Bir veya daha fazla kategori/alt kategori sayfası URL'i "
+                    "(örn. '.../plc-ve-hmi-paneller/plc-cpu-moduller'). Üst "
+                    "kategori verilirse alt kategoriler otomatik keşfedilir.",
+        min_length=1,
+        max_length=10,
+    )
+    cache_key: str = Field(
+        default="son_tarama",
+        description="Bu taramanın sonucuna daha sonra emko_search_manuals / "
+                    "emko_get_manual çağrılarında index_url olarak vermek için "
+                    "bir isim (örn. 'plc_hmi').",
+        min_length=1,
+        max_length=100,
+    )
+    max_depth: int = Field(
+        default=3,
+        description="Kategori içine ne kadar derine inilebileceği (üst kategori "
+                    "-> alt kategori -> ürün = 3 seviye).",
+        ge=1,
+        le=4,
+    )
+
+
+@mcp.tool(
+    name="emko_crawl_category",
+    annotations={
+        "title": "Emko kategori tara ve manuelleri indeksle",
+        "readOnlyHint": True,
+        "destructiveHint": False,
+        "idempotentHint": True,
+        "openWorldHint": True,
+    },
+)
+async def emko_crawl_category(params: CrawlCategoryInput) -> str:
+    """Verilen kategori sayfa(lar)ındaki her ürüne tek tek girip manuellerini indeksler.
+
+    Yükleme Merkezi'nden farklı olarak, doğrudan ürün kategori sayfalarını (örn.
+    "PLC-CPU Modülleri", "I/O Genişleme Modülleri") tarar — bu sayede Yükleme
+    Merkezi'nde henüz listelenmemiş yeni ürünler de bulunabilir. PDF'leri indirmez,
+    sadece hangi dosyanın hangi üründe olduğunu bulup önbelleğe alır. Aynı manuel
+    birden fazla üründe paylaşılıyorsa yalnızca bir kez listelenir.
+
+    Sonraki adım: bulunan bir dosyanın gerçek içeriğini almak için
+    emko_get_manual(query=..., index_url=<cache_key>) çağırın.
+
+    Args:
+        params (CrawlCategoryInput): category_urls (taranacak sayfalar),
+            cache_key (sonucu saklamak için isim), max_depth (tarama derinliği).
+
+    Returns:
+        str: Bulunan benzersiz manuellerin "- <dosya adı> (kaynak: <ürün url>)"
+            biçiminde listesi, kaç tanesinin bulunduğu ve sonraki adım bilgisi.
+    """
+    entries = await _crawl_index(params.category_urls, max_depth=params.max_depth)
+
+    _index_cache[params.cache_key] = [(t, f) for t, f, _ in entries]
+
+    if not entries:
+        return "Taranan sayfalarda hiç manuel bulunamadı."
+
+    lines = "\n".join(f"- {filename} (kaynak: {src})" for _, filename, src in entries)
+    return (
+        f"{len(entries)} benzersiz manuel bulundu ve '{params.cache_key}' adıyla "
+        f"önbelleğe alındı.\n"
+        f"İçeriğini almak için: emko_get_manual(query=\"...\", index_url=\"{params.cache_key}\")\n\n"
+        f"{lines}"
+    )
+
+
+def main():
+    """Konsol giriş noktası (pyproject.toml -> [project.scripts] emko-mcp)."""
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()