Ciceksepeti MCP Server

ciceksepeti-mcp 🇹🇷

mcp-name: io.github.mohammad-abbasi-sh/ciceksepeti-mcp

Unofficial read-only MCP server for ciceksepeti.com**, Türkiye's leading flower & gift delivery marketplace — search thousands of bouquets, plants and gifts, read product details (price, list price, stock, rating, seller, category), read customer reviews, browse 89 flower/plant/gift 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 ciceksepeti.com.

For AI agents

Add to your MCP client config (stdio):

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

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

Tools

Example output (ciceksepeti_search / "gül"):

{"query": "gül", "sort": "relevance", "page": 1, "count": 10, "products": [
  {"title": "13'lü Kırmızı Gül Buketi",
   "url": "https://www.ciceksepeti.com/ask-sembolu-13-kirmizi-gul-buketi-at4033",
   "product_id": "4275287", "price_try": 899.99,
   "original_price_try": 1149.0, "price_currency": "TRY",
   "review_count": 26946, "rating": 4,
   "delivery": "Aynı Gün Ücretsiz Teslimat",
   "image": "https://cdn03.ciceksepeti.com/…"}, …]}

Example output (ciceksepeti_product_detail / 13'lü Kırmızı Gül Buketi):

{"name": "13'lü Kırmızı Gül Buketi", "sku": "at4033",
 "brand": "Çiçeksepeti", "price_try": 899.99, "price_currency": "TRY",
 "in_stock": true, "rating": 4.0, "review_count": 26946,
 "seller": "Çiçeksepeti", "category": "Çiçek > Gül", …}

Example output (ciceksepeti_price_stats / "gül"):

{"query": "gül", "sort": "relevance", "count": 10, "min_try": 479.99,
 "median_try": 884.99, "mean_try": 1097.59, "max_try": 2749.0}

How it works

ciceksepeti.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 30 product boxes (title, price, review count, star rating, delivery note), product pages carry a schema.org Product JSON-LD block plus a breadcrumb category path, and the homepage carries 89 category links. Sorts are URL params (orderby=2 price desc, orderby=3 price asc, verified live) and paging is page=N (verified live). Requests are spaced ~0.8s apart; everything is read-only, no login, no API key.

Install

uvx ciceksepeti-mcp        # run directly (needs uv)
# or
pip install ciceksepeti-mcp
ciceksepeti-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 ciceksepeti.com.

Roadmap

• Category-scoped search (search within one /d/ category slug)
• Occasion search (birthday, anniversary, Mother's Day collections)
• Price history (track a product over days)

License

MIT — see LICENSE.