ciceksepeti.com Flowers & Gifts

io.github.mohammad-abbasi-shPublished by GitHub account mohammad-abbasi-shv0.1.0Updated Nov 7, 2026

Unofficial read-only MCP server for ciceksepeti.com flowers & gifts: search, prices.

VerifiedSTDIODesktop onlyWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

Unofficial read-only MCP server that lets an assistant search ciceksepeti.com flowers and gifts, read product details and reviews, and compute price statistics.

What you can do
  • Search flowers and gifts by keyword with sorting and paging, returning titles, TRY prices, ratings and delivery notes
  • Read one product's details: price, stock, rating, seller, category path, description and images
  • List the 89 flower, plant and gift categories
  • Read recent customer reviews with reviewer, star rating and date
  • Compute min, median, mean and max price in TRY for a query
When to use it
Useful when you want an assistant to look up Turkish flower and gift offerings, compare prices or summarize reviews from ciceksepeti.com without opening a browser. It is read-only, so it cannot place orders.
Requirements
Runs locally over stdio as a Python package, launched with uvx or installed via pip; needs the mcp and curl-cffi dependencies. No account, API key or environment variable is required, but it needs network access to ciceksepeti.com.
Before you install
Unofficial and not affiliated with ciceksepeti.com; it scrapes server-rendered pages, so results can break if the site changes or blocks requests. All requests go to ciceksepeti.com. It is read-only and does not log in, place orders or handle payment.

Installation

In SourceWeft

  1. Open ciceksepeti.com Flowers & Gifts in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

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

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

Tools

ToolDescription
ciceksepeti_searchSearch flowers & gifts by keyword — query ("kırmızı gül", "orkide", "doğum günü hediyesi"), sort ("relevance" / "price_asc" / "price_desc"), limit 1..24, page 1-based; returns title, price in TRY, list price, review count, star rating (0-5), delivery note, URL, image
ciceksepeti_product_detailDetail of one product (product = full URL or path ending in "-at"): name, brand, price in TRY, stock status, rating, review count, seller, category path, description, images
ciceksepeti_list_categories89 flower/plant/gift categories: Turkish name, URL, slug
ciceksepeti_price_statsPrice statistics for a query: count, min / median / mean / max price in TRY across the first page
ciceksepeti_product_reviewsRecent customer reviews of one product: reviewer, star rating and date (ciceksepeti does not server-render review bodies)

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

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

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

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

bash
uvx ciceksepeti-mcp        # run directly (needs uv)# orpip install ciceksepeti-mcpciceksepeti-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 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.

Source: README.md at commit e13f77c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestNov 7, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts