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):

{
  "mcpServers": {
    "n11": {
      "command": "uvx",
      "args": ["n11-mcp"]
    }
  }
}

Or run locally: python -m n11_mcp.server (needs mcp<2, curl-cffi).

Tools

Example output (n11_search / "iphone"):

{"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):

{"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"):

{"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

uvx n11-mcp        # run directly (needs uv)
# or
pip install n11-mcp
n11-mcp            # starts the MCP server on stdio

Tests

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.