n11-mcp 0.1.0__tar.gz

n11_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

n11_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

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

n11_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.5
+Name: n11-mcp
+Version: 0.1.0
+Summary: Unofficial read-only MCP server for n11.com shopping (search, product details, reviews, categories, price stats)
+Author: Mohammad Abbasi
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: curl-cffi>=0.7
+Requires-Dist: mcp<2
+Description-Content-Type: text/markdown
+
+# n11-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/n11-mcp
+
+Unofficial **read-only** MCP server for **n11.com**, Türkiye's #3 marketplace — search millions of products, read product details (price, list price, stock, rating, seller, category), read customer reviews, browse the 11 top categories, and get price statistics (min / median / mean / max) for any query.
+
+> Built by Mohammad Abbasi as part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with n11.com.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "n11": {
+      "command": "uvx",
+      "args": ["n11-mcp"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m n11_mcp.server` (needs `mcp<2`, `curl-cffi`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `n11_search` | Search products by keyword — `query` ("iphone", "kablosuz kulaklık"), `sort` ("relevance" / "price_asc" / "price_desc"), `limit` 1..24, `page` 1-based; returns title, price in TRY, list price, brand, SKU, URL, image, stock status |
+| `n11_product_detail` | Detail of one product (`product` = full URL or path with "/urun/…"): name, brand, price in TRY, list price, stock status, rating, review count, seller (company, store name, authorized-store badge, grade, shipment city), category path, description, images |
+| `n11_list_categories` | The 11 top categories: Turkish name, URL, slug |
+| `n11_price_stats` | Price statistics for a query: count, min / median / mean / max price in TRY across the first page |
+| `n11_product_reviews` | Recent customer reviews of one product: reviewer and star rating (n11 does not server-render review bodies) |
+
+Example output (`n11_search` / "iphone"):
+
+```json
+{"query": "iphone", "sort": "relevance", "page": 1, "count": 10, "products": [
+  {"title": "Apple iPhone 17 Pro Max 256 GB (Apple Türkiye Garantili)",
+   "url": "https://www.n11.com/urun/apple-iphone-17-pro-max-256-gb-apple-turkiye-garantili-100816929",
+   "sku": "127340433485", "brand": "Apple", "price_try": 112434.28,
+   "original_price_try": 117119.04, "price_currency": "TRY",
+   "in_stock": true, "image": "https://n11scdn.akamaized.net/…"}, …]}
+```
+
+Example output (`n11_product_detail` / iPhone 17 Pro Max):
+
+```json
+{"name": "Apple iPhone 17 Pro Max 256 GB (Apple Türkiye Garantili) Turuncu 256 GB Fiyatları ve Özellikleri",
+ "sku": "127340433485", "brand": "Apple", "price_try": 112434.28,
+ "original_price_try": 117119.04, "price_currency": "TRY", "in_stock": true,
+ "rating": 5.0, "review_count": 227,
+ "category": "Elektronik > Telefon & Aksesuarları > Cep Telefonu > Apple Cep Telefonu",
+ "seller_company": "SALİM TEKEMEN", "seller": "TKMNBILISIM",
+ "seller_badge": "Yetkili Mağaza", "seller_grade": 100,
+ "shipment_city": "Antalya", "shipment_condition": "Ücretsiz Kargo", …}
+```
+
+Example output (`n11_price_stats` / "iphone"):
+
+```json
+{"query": "iphone", "sort": "relevance", "count": 10, "min_try": 57199.0,
+ "median_try": 106099.49, "mean_try": 100880.09, "max_try": 150999.55}
+```
+
+## How it works
+
+n11.com answers plain HTTP clients, and the transport uses Chrome TLS
+impersonation (`curl-cffi`, `chrome120`) so a stricter bot check does not
+break the server. There is no public JSON API — data comes from the
+site's server-rendered pages: search pages carry a schema.org ItemList
+JSON-LD block (20 products per page), product pages carry a schema.org
+Product JSON-LD block plus a breadcrumb category path and an embedded
+seller JSON object, and the homepage carries the 11 top categories.
+Requests are spaced ~0.8s apart; everything is read-only, no login,
+no API key.
+
+## Install
+
+```bash
+uvx n11-mcp        # run directly (needs uv)
+# or
+pip install n11-mcp
+n11-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 fetched 2026-11-06);
+live tests hit n11.com.
+
+## Roadmap
+
+- Category-scoped search (search within one category slug)
+- Other sellers of the same product (compare prices per seller)
+- Price history (track a SKU over days)
+
+## License
+
+MIT — see [LICENSE](LICENSE).

n11_mcp-0.1.0/README-fa.md

@@ -0,0 +1,85 @@
+# n11-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/n11-mcp
+
+سرور MCP غیررسمی و **فقط‌خواندنی** برای **n11.com**، مارکت‌پلیس شماره‌ی
+۳ ترکیه — جست‌وجو در میلیون‌ها کالا، خواندن جزئیات کالا (قیمت، قیمت
+لیست، موجودی، امتیاز، فروشنده، دسته)، خواندن نظرهای مشتریان، مرور ۱۱
+دسته‌ی اصلی، و گرفتن آمار قیمت (کمترین / میانه / میانگین / بیشترین)
+برای هر جست‌وجو.
+
+> ساخته‌ی محمد عباسی در چارچوب «کارخانه‌ی MCP ترکیه» (به سبک سپهر). هیچ
+> وابستگی‌ای به n11.com ندارد.
+
+## برای ایجنت‌های هوش مصنوعی
+
+به پیکربندی MCP client خود اضافه کنید (stdio):
+
+```json
+{
+  "mcpServers": {
+    "n11": {
+      "command": "uvx",
+      "args": ["n11-mcp"]
+    }
+  }
+}
+```
+
+یا به‌صورت محلی اجرا کنید: `python -m n11_mcp.server`
+(نیازمند `mcp<2` و `curl-cffi`).
+
+## ابزارها
+
+| ابزار | توضیح |
+|------|-------|
+| `n11_search` | جست‌وجوی کالا با کلیدواژه — `query` (مثل «iphone» یا «kablosuz kulaklık»)، `sort` (‏«relevance» / ‏«price_asc» / ‏«price_desc»)، `limit` از ۱ تا ۲۴، `page` از ۱؛ برمی‌گرداند: عنوان، قیمت به لیر، قیمت لیست، برند، SKU، آدرس، عکس، وضعیت موجودی |
+| `n11_product_detail` | جزئیات یک کالا (`product` = آدرس کامل یا مسیر حاوی «/urun/…»): نام، برند، قیمت به لیر، قیمت لیست، وضعیت موجودی، امتیاز، تعداد نظر، فروشنده (شرکت، نام فروشگاه، نشان فروشگاه مجاز، امتیاز فروشنده، شهر ارسال)، مسیر دسته، توضیح، عکس‌ها |
+| `n11_list_categories` | ۱۱ دسته‌ی اصلی: نام ترکی، آدرس، اسلاگ |
+| `n11_price_stats` | آمار قیمت برای یک جست‌وجو: تعداد، کمترین / میانه / میانگین / بیشترین قیمت (لیر) |
+| `n11_product_reviews` | نظرهای اخیر مشتریان برای یک کالا: نویسنده و امتیاز ستاره‌ای (سایت n11 متن نظرها را سمت سرور رندر نمی‌کند) |
+
+نمونه‌ی خروجی (`n11_search` / ‏«iphone»):
+
+```json
+{"query": "iphone", "count": 10, "products": [
+  {"title": "Apple iPhone 17 Pro Max 256 GB (Apple Türkiye Garantili)",
+   "url": "https://www.n11.com/urun/apple-iphone-17-pro-max-256-gb-apple-turkiye-garantili-100816929",
+   "sku": "127340433485", "brand": "Apple", "price_try": 112434.28,
+   "original_price_try": 117119.04, "in_stock": true}, …]}
+```
+
+## چطور کار می‌کند؟
+
+سایت n11.com به کلاینت‌های HTTP ساده جواب می‌دهد؛ با این حال لایه‌ی
+انتقال از جعل TLS کروم (`curl-cffi`، ‏`chrome120`) استفاده می‌کند تا
+یک بررسی ربات سخت‌گیرانه‌تر سرور را از کار نیندازد. API عمومی JSON
+ندارد — داده‌ها از HTML رندرشده‌ی سمت سرور می‌آیند: صفحه‌های جست‌وجو
+بلوک ItemList از نوع JSON-LD دارند (۲۰ کالا در هر صفحه)، صفحه‌های کالا
+JSON-LD از نوع Product به‌همراه مسیر دسته (breadcrumb) و آبجکت JSON
+فروشنده، و صفحه‌ی اصلی ۱۱ دسته‌ی اصلی را دارد. درخواست‌ها با فاصله‌ی
+حدود ۰٫۸ ثانیه فرستاده می‌شوند؛ همه‌چیز فقط‌خواندنی است، بدون لاگین و
+بدون کلید API.
+
+## نصب
+
+```bash
+uvx n11-mcp        # اجرای مستقیم (نیازمند uv)
+# یا
+pip install n11-mcp
+n11-mcp            # اجرای سرور MCP روی stdio
+```
+
+## تست‌ها
+
+```bash
+python -m venv .venv && .venv/bin/pip install -e .
+.venv/bin/python -m unittest discover -s tests -v
+```
+
+تست‌های آفلاین روی نمونه‌های ضبط‌شده از صفحه‌های واقعی اجرا می‌شوند
+(دریافت‌شده در ۲۰۲۶-۱۱-۰۶)؛ تست‌های زنده به n11.com وصل می‌شوند.
+
+## لایسنس
+
+MIT — ببینید [LICENSE](LICENSE).

n11_mcp-0.1.0/README-tr.md

@@ -0,0 +1,85 @@
+# n11-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/n11-mcp
+
+Türkiye'nin 3 numaralı pazaryeri **n11.com** için resmi olmayan,
+**salt okunur** MCP sunucusu — milyonlarca üründe arama yapın, ürün
+detaylarını okuyun (fiyat, liste fiyatı, stok, puan, satıcı, kategori),
+müşteri yorumlarını okuyun, 11 ana kategoriye göz atın ve herhangi bir
+sorgu için fiyat istatistikleri (min / medyan / ortalama / maks) alın.
+
+> Mohammad Abbasi tarafından "Turkey MCP factory" (Sepehr tarzı süreç)
+> kapsamında geliştirildi. n11.com ile bağlantısı yoktur.
+
+## Yapay zekâ ajanları için
+
+MCP istemci yapılandırmanıza ekleyin (stdio):
+
+```json
+{
+  "mcpServers": {
+    "n11": {
+      "command": "uvx",
+      "args": ["n11-mcp"]
+    }
+  }
+}
+```
+
+veya yerel çalıştırın: `python -m n11_mcp.server`
+(`mcp<2`, `curl-cffi` gerekir).
+
+## Araçlar
+
+| Araç | Açıklama |
+|------|----------|
+| `n11_search` | Anahtar kelimeyle ürün arama — `query` ("iphone", "kablosuz kulaklık"), `sort` ("relevance" / "price_asc" / "price_desc"), `limit` 1..24, `page` 1'den başlar; başlık, TL fiyat, liste fiyatı, marka, SKU, URL, görsel, stok durumu döndürür |
+| `n11_product_detail` | Bir ürünün detayı (`product` = "/urun/…" içeren URL veya yol): ad, marka, TL fiyat, liste fiyatı, stok durumu, puan, yorum sayısı, satıcı (şirket, mağaza adı, yetkili mağaza rozeti, satıcı puanı, gönderim şehri), kategori yolu, açıklama, görseller |
+| `n11_list_categories` | 11 ana kategori: Türkçe ad, URL, slug |
+| `n11_price_stats` | Bir sorgunun fiyat istatistikleri: adet, min / medyan / ortalama / maks fiyat (TL) |
+| `n11_product_reviews` | Bir ürünün son müşteri yorumları: yorumcu ve yıldız puanı (n11 yorum metinlerini sunucu taraflı işlemez) |
+
+Örnek çıktı (`n11_search` / "iphone"):
+
+```json
+{"query": "iphone", "count": 10, "products": [
+  {"title": "Apple iPhone 17 Pro Max 256 GB (Apple Türkiye Garantili)",
+   "url": "https://www.n11.com/urun/apple-iphone-17-pro-max-256-gb-apple-turkiye-garantili-100816929",
+   "sku": "127340433485", "brand": "Apple", "price_try": 112434.28,
+   "original_price_try": 117119.04, "in_stock": true}, …]}
+```
+
+## Nasıl çalışır?
+
+n11.com düz HTTP istemcilerine yanıt verir; aktarım yine de Chrome TLS
+taklidi (`curl-cffi`, `chrome120`) kullanır, böylece daha katı bir bot
+kontrolü sunucuyu bozmaz. Herkese açık bir JSON API yoktur — veriler
+sitenin sunucu taraflı işlenmiş HTML sayfalarından gelir: arama
+sayfaları schema.org ItemList JSON-LD bloğu (sayfa başına 20 ürün),
+ürün sayfaları schema.org Product JSON-LD + breadcrumb kategori yolu +
+gömülü satıcı JSON nesnesi, ana sayfa ise 11 ana kategoriyi taşır.
+İstekler ~0.8 sn arayla yapılır; her şey salt okunurdur, giriş
+gerekmez, API anahtarı gerekmez.
+
+## Kurulum
+
+```bash
+uvx n11-mcp        # doğrudan çalıştır (uv gerekir)
+# veya
+pip install n11-mcp
+n11-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ı örnek sayfalarla çalışır (gerçek sayfalar,
+2026-11-06); canlı testler n11.com'a bağlanır.
+
+## Lisans
+
+MIT — bkz. [LICENSE](LICENSE).

n11_mcp-0.1.0/README.md

@@ -0,0 +1,106 @@
+# n11-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/n11-mcp
+
+Unofficial **read-only** MCP server for **n11.com**, Türkiye's #3 marketplace — search millions of products, read product details (price, list price, stock, rating, seller, category), read customer reviews, browse the 11 top categories, and get price statistics (min / median / mean / max) for any query.
+
+> Built by Mohammad Abbasi as part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with n11.com.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "n11": {
+      "command": "uvx",
+      "args": ["n11-mcp"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m n11_mcp.server` (needs `mcp<2`, `curl-cffi`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `n11_search` | Search products by keyword — `query` ("iphone", "kablosuz kulaklık"), `sort` ("relevance" / "price_asc" / "price_desc"), `limit` 1..24, `page` 1-based; returns title, price in TRY, list price, brand, SKU, URL, image, stock status |
+| `n11_product_detail` | Detail of one product (`product` = full URL or path with "/urun/…"): name, brand, price in TRY, list price, stock status, rating, review count, seller (company, store name, authorized-store badge, grade, shipment city), category path, description, images |
+| `n11_list_categories` | The 11 top categories: Turkish name, URL, slug |
+| `n11_price_stats` | Price statistics for a query: count, min / median / mean / max price in TRY across the first page |
+| `n11_product_reviews` | Recent customer reviews of one product: reviewer and star rating (n11 does not server-render review bodies) |
+
+Example output (`n11_search` / "iphone"):
+
+```json
+{"query": "iphone", "sort": "relevance", "page": 1, "count": 10, "products": [
+  {"title": "Apple iPhone 17 Pro Max 256 GB (Apple Türkiye Garantili)",
+   "url": "https://www.n11.com/urun/apple-iphone-17-pro-max-256-gb-apple-turkiye-garantili-100816929",
+   "sku": "127340433485", "brand": "Apple", "price_try": 112434.28,
+   "original_price_try": 117119.04, "price_currency": "TRY",
+   "in_stock": true, "image": "https://n11scdn.akamaized.net/…"}, …]}
+```
+
+Example output (`n11_product_detail` / iPhone 17 Pro Max):
+
+```json
+{"name": "Apple iPhone 17 Pro Max 256 GB (Apple Türkiye Garantili) Turuncu 256 GB Fiyatları ve Özellikleri",
+ "sku": "127340433485", "brand": "Apple", "price_try": 112434.28,
+ "original_price_try": 117119.04, "price_currency": "TRY", "in_stock": true,
+ "rating": 5.0, "review_count": 227,
+ "category": "Elektronik > Telefon & Aksesuarları > Cep Telefonu > Apple Cep Telefonu",
+ "seller_company": "SALİM TEKEMEN", "seller": "TKMNBILISIM",
+ "seller_badge": "Yetkili Mağaza", "seller_grade": 100,
+ "shipment_city": "Antalya", "shipment_condition": "Ücretsiz Kargo", …}
+```
+
+Example output (`n11_price_stats` / "iphone"):
+
+```json
+{"query": "iphone", "sort": "relevance", "count": 10, "min_try": 57199.0,
+ "median_try": 106099.49, "mean_try": 100880.09, "max_try": 150999.55}
+```
+
+## How it works
+
+n11.com answers plain HTTP clients, and the transport uses Chrome TLS
+impersonation (`curl-cffi`, `chrome120`) so a stricter bot check does not
+break the server. There is no public JSON API — data comes from the
+site's server-rendered pages: search pages carry a schema.org ItemList
+JSON-LD block (20 products per page), product pages carry a schema.org
+Product JSON-LD block plus a breadcrumb category path and an embedded
+seller JSON object, and the homepage carries the 11 top categories.
+Requests are spaced ~0.8s apart; everything is read-only, no login,
+no API key.
+
+## Install
+
+```bash
+uvx n11-mcp        # run directly (needs uv)
+# or
+pip install n11-mcp
+n11-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 fetched 2026-11-06);
+live tests hit n11.com.
+
+## Roadmap
+
+- Category-scoped search (search within one category slug)
+- Other sellers of the same product (compare prices per seller)
+- Price history (track a SKU over days)
+
+## License
+
+MIT — see [LICENSE](LICENSE).

n11_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "n11-mcp"
+version = "0.1.0"
+description = "Unofficial read-only MCP server for n11.com shopping (search, product details, reviews, categories, price stats)"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+dependencies = [
+    "mcp<2",
+    "curl-cffi>=0.7",
+]
+authors = [{ name = "Mohammad Abbasi" }]
+
+[project.scripts]
+n11-mcp = "n11_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/n11_mcp"]

n11_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 n11.com shopping: search, details, reviews, prices.","name":"io.github.mohammad-abbasi-sh/n11-mcp","packages":[{"identifier":"n11-mcp","registryBaseUrl":"https://pypi.org","registryType":"pypi","transport":{"type":"stdio"},"version":"0.1.0"}],"repository":{"source":"github","url":"https://github.com/mohammad-abbasi-sh/n11-mcp"},"title":"n11.com Shopping","version":"0.1.0","websiteUrl":"https://github.com/mohammad-abbasi-sh/n11-mcp"}

n11_mcp-0.1.0/src/n11_mcp/__init__.py

@@ -0,0 +1 @@
+"""n11_mcp — unofficial read-only MCP server for n11.com."""

n11_mcp-0.1.0/src/n11_mcp/http.py

@@ -0,0 +1,88 @@
+"""HTTP layer for n11_mcp.
+
+n11.com answers HTTP 200 to plain HTTP clients with a browser UA
+(verified live 2026-11-06: homepage, search, product pages). The
+transport still uses curl-cffi chrome120 impersonation, the same proven
+pattern as the other Turkey-factory servers, so a stricter bot check
+does not break the server overnight. Requests are kept gentle (one at
+a time, ~0.8s apart) and read-only.
+"""
+from __future__ import annotations
+
+import time
+from urllib.parse import quote_plus, urlparse
+
+from curl_cffi import requests as _r
+
+BASE = "https://www.n11.com"
+TIMEOUT = 30.0
+MIN_INTERVAL = 0.8  # seconds between requests — be polite
+
+_HEADERS = {
+    "Accept-Language": "tr-TR,tr;q=0.9,en;q=0.8",
+    "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
+}
+
+_last_fetch = 0.0
+
+
+class N11Error(RuntimeError):
+    pass
+
+
+def _get(url: str) -> str:
+    global _last_fetch
+    wait = MIN_INTERVAL - (time.monotonic() - _last_fetch)
+    if wait > 0:
+        time.sleep(wait)
+    try:
+        resp = _r.get(url, impersonate="chrome120", headers=_HEADERS, timeout=TIMEOUT)
+    except Exception as e:
+        raise N11Error(f"network error fetching {url}: {e}") from e
+    finally:
+        _last_fetch = time.monotonic()
+    if resp.status_code == 403:
+        raise N11Error(
+            "n11.com refused the request (HTTP 403, bot wall) — try again later"
+        )
+    if resp.status_code == 429:
+        raise N11Error(
+            "n11.com rate-limited the request (HTTP 429) — try again later"
+        )
+    if resp.status_code == 404:
+        raise N11Error(f"page not found (HTTP 404): {url}")
+    if resp.status_code != 200:
+        raise N11Error(f"unexpected HTTP {resp.status_code} fetching {url}")
+    return resp.text
+
+
+def fetch_search_html(query: str, sort_param: str | None = None, page: int = 1) -> str:
+    """Search page HTML. sort_param: 'PRICE_LOW' (price asc) or 'PRICE_HIGH'."""
+    url = f"{BASE}/arama?q={quote_plus(query)}"
+    if sort_param:
+        url += f"&srt={sort_param}"
+    if page > 1:
+        url += f"&pg={page}"
+    return _get(url)
+
+
+def fetch_product_html(product: str) -> str:
+    """Product page HTML. product: full URL or site path '/urun/<slug>-<id>'."""
+    path = product.strip()
+    if path.startswith("http"):
+        parsed = urlparse(path)
+        if "n11.com" not in parsed.netloc:
+            raise N11Error("product must be an n11.com URL or path")
+        path = parsed.path
+    if not path.startswith("/"):
+        path = "/" + path
+    if "/urun/" not in path:
+        raise N11Error(
+            "product must be a product URL/path containing '/urun/…' "
+            "(find one with n11_search first)"
+        )
+    return _get(f"{BASE}{path}")
+
+
+def fetch_home_html() -> str:
+    return _get(f"{BASE}/")