ŞOK Grocery

io.github.mohammad-abbasi-sh由 GitHub 帳號 mohammad-abbasi-sh 發布v0.1.1更新於 Nov 11, 2026

Unofficial read-only MCP server for ŞOK grocery — products, categories, campaigns, prices.

已驗證STDIO僅桌面商業與電商

概覽

ŞOK Grocery 的本機 MCP 服務；無需登入；STDIO。

暫無 AI 概覽：以下資訊來自註冊中心條目和服務本身。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 ŞOK Grocery，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

sok-mcp 🇹🇷

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

Unofficial read-only MCP server for ŞOK (sokmarket.com.tr) — one of Türkiye's big discount grocery chains: product search, product details, categories, campaign groups and price statistics.

Part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with ŞOK.

For AI agents

Add to your MCP client config (stdio):

json
{  "mcpServers": {    "sok": {      "command": "uvx",      "args": ["sok-mcp==0.1.1"]    }  }}

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

Tools

ToolDescription
sok_search_productsSearch products by name — query, limit (1..30, first page only)
sok_get_productProduct detail — slug_or_url (e.g. ...-p-320230 or a full sokmarket.com.tr URL)
sok_list_categoriesStore categories (name, slug, id, url)
sok_category_productsProducts in one category — category slug or URL, limit (1..30)
sok_list_promotionsCurrent campaign groups from /kampanyalar
sok_price_statsPrice stats for a search — count, min, max, median, mean in TRY

Example output (sok_search_products / "süt"):

json
{"query": "süt", "total": 207, "products": [{"title": "Mis Uht Süt Yarım Yağlı 1 L", "id": "5834",   "url": "https://www.sokmarket.com.tr/mis-uht-sut-yarim-yagli-1-l-p-5834",   "price_try": 43.5}]}

Example output (sok_price_stats / "süt", first page of 10):

json
{"query": "süt", "total_matches": 207, "count": 10, "min_try": 16.5, "max_try": 88.5, "median_try": 55.75, "mean_try": 52.05}

Notes:

  • Prices are Turkish Lira (TRY); the site writes them Turkish-style (43,50₺).
  • Search/category pages return the first page (~20 products); total reports all matches.
  • Data: sokmarket.com.tr public server-rendered pages — no key, no login, read-only.

Development

bash
python3 -m venv .venv && .venv/bin/pip install "mcp<2" curl-cffi requests pytest.venv/bin/python -m pytest tests/ -q
  • tests/test_products.py — offline, parses real captured fixtures
  • tests/test_live.py — 5 cautious live requests against sokmarket.com.tr

License

MIT

Built by Mohammad Abbasi — Almanibama · mabbasi.ir

來源：README.md，提交 39ae1f7

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.1最新Nov 11, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。