hepsiburada-mcp 0.1.0__tar.gz

hepsiburada_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

hepsiburada_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

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

hepsiburada_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.5
+Name: hepsiburada-mcp
+Version: 0.1.0
+Summary: Unofficial read-only MCP server for hepsiburada.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
+
+# hepsiburada-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/hepsiburada-mcp
+
+Unofficial **read-only** MCP server for **hepsiburada.com**, Türkiye's leading e-commerce marketplace — search millions of products, read product details (price, stock, seller, GTIN, highlights), read customer reviews, browse the 9 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 hepsiburada.com.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "hepsiburada": {
+      "command": "uvx",
+      "args": ["hepsiburada-mcp"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m hepsiburada_mcp.server` (needs `mcp<2`, `curl-cffi`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `hepsiburada_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, rating, review count, URL, SKU, image, campaign |
+| `hepsiburada_product_detail` | Detail of one product (`product` = full URL or path with "-p-HBCV…"): name, brand, price in TRY, stock status, rating, review count, seller (+ official-seller flag), category path, color, GTIN, images, highlights |
+| `hepsiburada_list_categories` | The 9 top categories: Turkish name, URL, category id |
+| `hepsiburada_price_stats` | Price statistics for a query: count, min / median / mean / max price in TRY across the first page |
+| `hepsiburada_product_reviews` | Recent customer reviews of one product: author, star rating, review text, date |
+
+Example output (`hepsiburada_search` / "iphone"):
+
+```json
+{"query": "iphone", "sort": "relevance", "page": 1, "count": 3, "products": [
+  {"title": "Apple iPhone 15 128 GB Mavi",
+   "url": "https://www.hepsiburada.com/apple-iphone-15-128-gb-mavi-p-HBCV00004X9ZCK",
+   "sku": "HBCV00004X9ZCK", "price_try": 56999.0, "rating": 4.8,
+   "review_count": 13102, "campaign": "30 günün en düşük fiyatı"}, …]}
+```
+
+Example output (`hepsiburada_product_detail` / iPhone 15):
+
+```json
+{"name": "Apple iPhone 15 128 GB", "sku": "HBCV00004X9ZCK", "brand": "Apple",
+ "category": "Telefon > Cep Telefonu > iPhone iOS Telefonlar", "color": "Mavi",
+ "gtin": "0195949036583", "price_try": 56999.0, "price_currency": "TRY",
+ "in_stock": true, "rating": 4.8, "review_count": 13102,
+ "seller": "Hepsiburada", "official_seller": true,
+ "highlights": ["Ekran : 6.1 inç Super Retina XDR OLED, …"], …}
+```
+
+Example output (`hepsiburada_price_stats` / "iphone"):
+
+```json
+{"query": "iphone", "sort": "relevance", "count": 3, "min_try": 56999.0,
+ "median_try": 102999.0, "mean_try": 91115.67, "max_try": 113349.0}
+```
+
+## How it works
+
+hepsiburada.com returns HTTP 403 to plain HTTP clients, so the transport
+uses Chrome TLS impersonation (`curl-cffi`, `chrome120`). There is no public
+JSON API — data comes from the site's server-rendered HTML: search pages
+carry product cards, product pages carry schema.org Product JSON-LD plus a
+seller block and a "Ürün Özellikleri" highlights list, and the homepage
+carries the top categories. Requests are spaced ~0.8s apart; everything is
+read-only, no login, no API key.
+
+## Install
+
+```bash
+uvx hepsiburada-mcp        # run directly (needs uv)
+# or
+pip install hepsiburada-mcp
+hepsiburada-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 hepsiburada.com.
+
+## Roadmap
+
+- Category-scoped search (search within one `-c-…` category)
+- Seller store pages (other sellers of the same product)
+- Price history (track a SKU over days)
+
+## License
+
+MIT — see [LICENSE](LICENSE).

hepsiburada_mcp-0.1.0/README-fa.md

@@ -0,0 +1,83 @@
+# hepsiburada-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/hepsiburada-mcp
+
+سرور MCP غیررسمی و **فقط‌خواندنی** برای **hepsiburada.com**، بزرگ‌ترین
+فروشگاه اینترنتی ترکیه — جست‌وجو در میلیون‌ها کالا، خواندن جزئیات کالا
+(قیمت، موجودی، فروشنده، GTIN، ویژگی‌های برجسته)، خواندن نظرهای مشتریان،
+مرور ۹ دسته‌ی اصلی، و گرفتن آمار قیمت (کمترین / میانه / میانگین /
+بیشترین) برای هر جست‌وجو.
+
+> ساخته‌ی محمد عباسی در چارچوب «کارخانه‌ی MCP ترکیه» (به سبک سپهر). هیچ
+> وابستگی‌ای به hepsiburada.com ندارد.
+
+## برای ایجنت‌های هوش مصنوعی
+
+به پیکربندی MCP client خود اضافه کنید (stdio):
+
+```json
+{
+  "mcpServers": {
+    "hepsiburada": {
+      "command": "uvx",
+      "args": ["hepsiburada-mcp"]
+    }
+  }
+}
+```
+
+یا به‌صورت محلی اجرا کنید: `python -m hepsiburada_mcp.server`
+(نیازمند `mcp<2` و `curl-cffi`).
+
+## ابزارها
+
+| ابزار | توضیح |
+|------|-------|
+| `hepsiburada_search` | جست‌وجوی کالا با کلیدواژه — `query` (مثل «iphone» یا «kablosuz kulaklık»)، `sort` (‏«relevance» / ‏«price_asc» / ‏«price_desc»)، `limit` از ۱ تا ۲۴، `page` از ۱؛ برمی‌گرداند: عنوان، قیمت به لیر، امتیاز، تعداد نظر، آدرس، SKU، عکس، کمپین |
+| `hepsiburada_product_detail` | جزئیات یک کالا (`product` = آدرس کامل یا مسیر حاوی «-p-HBCV…»): نام، برند، قیمت به لیر، وضعیت موجودی، امتیاز، تعداد نظر، فروشنده (+ فروشنده‌ی رسمی)، مسیر دسته، رنگ، GTIN، عکس‌ها، ویژگی‌های برجسته |
+| `hepsiburada_list_categories` | ۹ دسته‌ی اصلی: نام ترکی، آدرس، شناسه‌ی دسته |
+| `hepsiburada_price_stats` | آمار قیمت برای یک جست‌وجو: تعداد، کمترین / میانه / میانگین / بیشترین قیمت (لیر) |
+| `hepsiburada_product_reviews` | نظرهای اخیر مشتریان برای یک کالا: نویسنده، امتیاز ستاره‌ای، متن نظر، تاریخ |
+
+نمونه‌ی خروجی (`hepsiburada_search` / ‏«iphone»):
+
+```json
+{"query": "iphone", "count": 3, "products": [
+  {"title": "Apple iPhone 15 128 GB Mavi",
+   "url": "https://www.hepsiburada.com/apple-iphone-15-128-gb-mavi-p-HBCV00004X9ZCK",
+   "sku": "HBCV00004X9ZCK", "price_try": 56999.0, "rating": 4.8,
+   "review_count": 13102}, …]}
+```
+
+## چطور کار می‌کند؟
+
+سایت hepsiburada.com به کلاینت‌های HTTP ساده خطای 403 می‌دهد؛ به همین
+دلیل لایه‌ی انتقال از جعل TLS کروم (`curl-cffi`، ‏`chrome120`) استفاده
+می‌کند. API عمومی JSON ندارد — داده‌ها از HTML رندرشده‌ی سمت سرور
+می‌آیند: صفحه‌های جست‌وجو کارت‌های کالا دارند، صفحه‌های کالا JSON-LD از
+نوع Product به‌همراه بلوک فروشنده و فهرست «Ürün Özellikleri»، و صفحه‌ی
+اصلی دسته‌های اصلی را دارد. درخواست‌ها با فاصله‌ی حدود ۰٫۸ ثانیه
+فرستاده می‌شوند؛ همه‌چیز فقط‌خواندنی است، بدون لاگین و بدون کلید API.
+
+## نصب
+
+```bash
+uvx hepsiburada-mcp        # اجرای مستقیم (نیازمند uv)
+# یا
+pip install hepsiburada-mcp
+hepsiburada-mcp            # اجرای سرور MCP روی stdio
+```
+
+## تست‌ها
+
+```bash
+python -m venv .venv && .venv/bin/pip install -e .
+.venv/bin/python -m unittest discover -s tests -v
+```
+
+تست‌های آفلاین روی نمونه‌های ضبط‌شده از صفحه‌های واقعی اجرا می‌شوند
+(دریافت‌شده در ۲۰۲۶-۱۱-۰۶)؛ تست‌های زنده به hepsiburada.com وصل می‌شوند.
+
+## لایسنس
+
+MIT — ببینید [LICENSE](LICENSE).

hepsiburada_mcp-0.1.0/README-tr.md

@@ -0,0 +1,83 @@
+# hepsiburada-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/hepsiburada-mcp
+
+Türkiye'nin önde gelen e-ticaret pazaryeri **hepsiburada.com** için resmi
+olmayan, **salt okunur** MCP sunucusu — milyonlarca üründe arama yapın,
+ürün detaylarını okuyun (fiyat, stok, satıcı, GTIN, öne çıkan özellikler),
+müşteri yorumlarını okuyun, 9 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. hepsiburada.com ile bağlantısı yoktur.
+
+## Yapay zekâ ajanları için
+
+MCP istemci yapılandırmanıza ekleyin (stdio):
+
+```json
+{
+  "mcpServers": {
+    "hepsiburada": {
+      "command": "uvx",
+      "args": ["hepsiburada-mcp"]
+    }
+  }
+}
+```
+
+veya yerel çalıştırın: `python -m hepsiburada_mcp.server`
+(`mcp<2`, `curl-cffi` gerekir).
+
+## Araçlar
+
+| Araç | Açıklama |
+|------|----------|
+| `hepsiburada_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, puan, yorum sayısı, URL, SKU, görsel, kampanya döndürür |
+| `hepsiburada_product_detail` | Bir ürünün detayı (`product` = "-p-HBCV…" içeren URL veya yol): ad, marka, TL fiyat, stok durumu, puan, yorum sayısı, satıcı (+ resmi satıcı işareti), kategori yolu, renk, GTIN, görseller, öne çıkanlar |
+| `hepsiburada_list_categories` | 9 ana kategori: Türkçe ad, URL, kategori kimliği |
+| `hepsiburada_price_stats` | Bir sorgunun fiyat istatistikleri: adet, min / medyan / ortalama / maks fiyat (TL) |
+| `hepsiburada_product_reviews` | Bir ürünün son müşteri yorumları: yazar, yıldız puanı, yorum metni, tarih |
+
+Örnek çıktı (`hepsiburada_search` / "iphone"):
+
+```json
+{"query": "iphone", "count": 3, "products": [
+  {"title": "Apple iPhone 15 128 GB Mavi",
+   "url": "https://www.hepsiburada.com/apple-iphone-15-128-gb-mavi-p-HBCV00004X9ZCK",
+   "sku": "HBCV00004X9ZCK", "price_try": 56999.0, "rating": 4.8,
+   "review_count": 13102}, …]}
+```
+
+## Nasıl çalışır?
+
+hepsiburada.com düz HTTP istemcilerine HTTP 403 döndürür; bu yüzden
+aktarım Chrome TLS taklidi (`curl-cffi`, `chrome120`) kullanır. Herkese
+açık bir JSON API yoktur — veriler sitenin sunucu taraflı işlenmiş
+HTML sayfalarından gelir: arama sayfaları ürün kartları, ürün sayfaları
+schema.org Product JSON-LD + satıcı bloğu + "Ürün Özellikleri" listesi,
+ana sayfa ise ana kategorileri taşır. İstekler ~0.8 sn arayla yapılır;
+her şey salt okunurdur, giriş gerekmez, API anahtarı gerekmez.
+
+## Kurulum
+
+```bash
+uvx hepsiburada-mcp        # doğrudan çalıştır (uv gerekir)
+# veya
+pip install hepsiburada-mcp
+hepsiburada-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 hepsiburada.com'a bağlanır.
+
+## Lisans
+
+MIT — bkz. [LICENSE](LICENSE).

hepsiburada_mcp-0.1.0/README.md

@@ -0,0 +1,101 @@
+# hepsiburada-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/hepsiburada-mcp
+
+Unofficial **read-only** MCP server for **hepsiburada.com**, Türkiye's leading e-commerce marketplace — search millions of products, read product details (price, stock, seller, GTIN, highlights), read customer reviews, browse the 9 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 hepsiburada.com.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "hepsiburada": {
+      "command": "uvx",
+      "args": ["hepsiburada-mcp"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m hepsiburada_mcp.server` (needs `mcp<2`, `curl-cffi`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `hepsiburada_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, rating, review count, URL, SKU, image, campaign |
+| `hepsiburada_product_detail` | Detail of one product (`product` = full URL or path with "-p-HBCV…"): name, brand, price in TRY, stock status, rating, review count, seller (+ official-seller flag), category path, color, GTIN, images, highlights |
+| `hepsiburada_list_categories` | The 9 top categories: Turkish name, URL, category id |
+| `hepsiburada_price_stats` | Price statistics for a query: count, min / median / mean / max price in TRY across the first page |
+| `hepsiburada_product_reviews` | Recent customer reviews of one product: author, star rating, review text, date |
+
+Example output (`hepsiburada_search` / "iphone"):
+
+```json
+{"query": "iphone", "sort": "relevance", "page": 1, "count": 3, "products": [
+  {"title": "Apple iPhone 15 128 GB Mavi",
+   "url": "https://www.hepsiburada.com/apple-iphone-15-128-gb-mavi-p-HBCV00004X9ZCK",
+   "sku": "HBCV00004X9ZCK", "price_try": 56999.0, "rating": 4.8,
+   "review_count": 13102, "campaign": "30 günün en düşük fiyatı"}, …]}
+```
+
+Example output (`hepsiburada_product_detail` / iPhone 15):
+
+```json
+{"name": "Apple iPhone 15 128 GB", "sku": "HBCV00004X9ZCK", "brand": "Apple",
+ "category": "Telefon > Cep Telefonu > iPhone iOS Telefonlar", "color": "Mavi",
+ "gtin": "0195949036583", "price_try": 56999.0, "price_currency": "TRY",
+ "in_stock": true, "rating": 4.8, "review_count": 13102,
+ "seller": "Hepsiburada", "official_seller": true,
+ "highlights": ["Ekran : 6.1 inç Super Retina XDR OLED, …"], …}
+```
+
+Example output (`hepsiburada_price_stats` / "iphone"):
+
+```json
+{"query": "iphone", "sort": "relevance", "count": 3, "min_try": 56999.0,
+ "median_try": 102999.0, "mean_try": 91115.67, "max_try": 113349.0}
+```
+
+## How it works
+
+hepsiburada.com returns HTTP 403 to plain HTTP clients, so the transport
+uses Chrome TLS impersonation (`curl-cffi`, `chrome120`). There is no public
+JSON API — data comes from the site's server-rendered HTML: search pages
+carry product cards, product pages carry schema.org Product JSON-LD plus a
+seller block and a "Ürün Özellikleri" highlights list, and the homepage
+carries the top categories. Requests are spaced ~0.8s apart; everything is
+read-only, no login, no API key.
+
+## Install
+
+```bash
+uvx hepsiburada-mcp        # run directly (needs uv)
+# or
+pip install hepsiburada-mcp
+hepsiburada-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 hepsiburada.com.
+
+## Roadmap
+
+- Category-scoped search (search within one `-c-…` category)
+- Seller store pages (other sellers of the same product)
+- Price history (track a SKU over days)
+
+## License
+
+MIT — see [LICENSE](LICENSE).

hepsiburada_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "hepsiburada-mcp"
+version = "0.1.0"
+description = "Unofficial read-only MCP server for hepsiburada.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]
+hepsiburada-mcp = "hepsiburada_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hepsiburada_mcp"]

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

hepsiburada_mcp-0.1.0/src/hepsiburada_mcp/__init__.py

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

hepsiburada_mcp-0.1.0/src/hepsiburada_mcp/http.py

@@ -0,0 +1,88 @@
+"""HTTP layer for hepsiburada_mcp — Chrome TLS impersonation required.
+
+hepsiburada.com returns HTTP 403 to plain curl/httpx with a browser UA
+(verified live 2026-11-06: 403 on homepage AND search with plain curl),
+but answers HTTP 200 to curl-cffi chrome120 impersonation. There is no
+public JSON API and no login involved — the site is server-rendered HTML,
+so the transport must impersonate a real browser at the TLS level.
+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.hepsiburada.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 HepsiburadaError(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 HepsiburadaError(f"network error fetching {url}: {e}") from e
+    finally:
+        _last_fetch = time.monotonic()
+    if resp.status_code == 403:
+        raise HepsiburadaError(
+            "hepsiburada.com refused the request (HTTP 403, bot wall) — try again later"
+        )
+    if resp.status_code == 429:
+        raise HepsiburadaError(
+            "hepsiburada.com rate-limited the request (HTTP 429) — try again later"
+        )
+    if resp.status_code == 404:
+        raise HepsiburadaError(f"page not found (HTTP 404): {url}")
+    if resp.status_code != 200:
+        raise HepsiburadaError(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: 'artanfiyat' (price asc) or 'azalanfiyat' (price desc)."""
+    url = f"{BASE}/ara?q={quote_plus(query)}"
+    if sort_param:
+        url += f"&siralama={sort_param}"
+    if page > 1:
+        url += f"&sayfa={page}"
+    return _get(url)
+
+
+def fetch_product_html(product: str) -> str:
+    """Product page HTML. product: full URL, site path, or 'slug-p-HBCV…' path."""
+    path = product.strip()
+    if path.startswith("http"):
+        parsed = urlparse(path)
+        if "hepsiburada.com" not in parsed.netloc:
+            raise HepsiburadaError("product must be a hepsiburada.com URL or path")
+        path = parsed.path
+    if not path.startswith("/"):
+        path = "/" + path
+    if "-p-HBCV" not in path:
+        raise HepsiburadaError(
+            "product must be a product URL/path containing '-p-HBCV…' "
+            "(find one with hepsiburada_search first)"
+        )
+    return _get(f"{BASE}{path}")
+
+
+def fetch_home_html() -> str:
+    return _get(f"{BASE}/")