Skip to main content
Glama
akakce-mcp
by nsozturk

akakce-mcp is a free, open-source Model Context Protocol (MCP) server for Akakçe that equips AI agents with real-time Turkish price comparison, multi-seller market intelligence, and automated price drop alerts.

📖 Documentation Portal: https://nsozturk.github.io/akakce-mcp/ • AI/LLM Index: llms.txt • llms-full.txt


Key Highlights

  • 🛡️ Akamai Bot Protection Bypassed: Standard Node fetch / Axios clients are fingerprinted and blocked with HTTP 403 Forbidden. akakce-mcp routes requests through system curl using verified browser and mobile App headers (Akakce/100 CFNetwork/...), ensuring reliable zero-ban connectivity.

  • ⚡ 20 Structured MCP Tools: Everything from query autocomplete and paginated filtered search to full seller price lists with shipping fees, seller ratings, and direct outbound links.

  • 🔑 Zero Key Floor for Public Features: Search, seller comparison, deals, and category browsing work out-of-the-box with zero credentials required.

  • 🔒 Secure Token Management: Account features (wishlists, price alerts) use isolated local session storage (~/.config/akakce-mcp/session.json with 0600 permissions) or environment variables. Zero credentials are ever saved in the repository.


Related MCP server: market-fiyatlari-mcp-server

Quickstart

Run directly without installing:

# Start MCP server (stdio transport)
npx -y akakce-mcp

Or install globally:

npm install -g akakce-mcp

Requirement: System curl must be available in your PATH (standard on macOS, Linux, and modern Windows 10/11).


Client Integration

1. Claude Code

claude mcp add akakce -- npx -y akakce-mcp

2. Cursor IDE

Open Settings → Features → MCP → Add New MCP Server:

  • Name: akakce

  • Type: command

  • Command: npx -y akakce-mcp

3. OpenCode (opencode.json)

{
  "mcp": {
    "akakce": {
      "type": "local",
      "command": ["npx", "-y", "akakce-mcp"],
      "enabled": true
    }
  }
}

Authentication & Token Extraction Guide

Public search and price comparison work with zero configuration.

To enable authenticated features (managing favorite lists, creating target price drop alerts, reading notifications), you need your Akakçe account token (AAATLGST cookie). Choose whichever method suits you best:

Run the built-in authentication command:

npx akakce-mcp auth

This prompts for your Akakçe email and password, executes a secure login against api6.akakce.com, and stores your session cookie at ~/.config/akakce-mcp/session.json (chmod 0600). The session is valid for ~1 year (rememberMe: true).

If you log in via Google, Apple ID, or prefer not to input your password in the terminal:

  1. Log in to akakce.com in your browser.

  2. Open Developer Tools (F12 or Cmd+Opt+I) → Application tab → Cookies → https://www.akakce.com.

  3. Locate the cookie named AAATLGST and copy its value.

  4. Save it using the CLI:

    npx akakce-mcp set-cookie "AAATLGST=<your_copied_value>"

Method 3: Environment Variables (Docker & CI/CD)

You can provide the session cookie directly via environment variables:

export AKAKCE_COOKIE="AAATLGST=..."

Or provide automated credentials:

export AKAKCE_EMAIL="user@example.com"
export AKAKCE_PASSWORD="your_password"

Check Authentication Status

npx akakce-mcp status
# or
npx akakce-mcp whoami

Clear Saved Session

npx akakce-mcp logout

Tool Directory (20 Tools)

Discovery & Search (Public)

Tool

Description

akakce_autocomplete

Instant search suggestions and canonical product codes

akakce_search

Paginated product search with sorting and category filters

akakce_search_filters

Available filter groups (brands, specs, price range) for a query

akakce_category_browse

Category tree hierarchy and paginated category feeds

akakce_home_feed

Home screen cards, campaigns, and active collections

akakce_deals

Real-time stream of recently discounted items

Pricing & Market Intelligence (Public)

Tool

Description

akakce_product_detail

Complete seller list (prices, shipping, ratings, specs, store links)

akakce_product_prices

Batched pricing lookup across multiple product codes

akakce_quickview

Rapid single-product price and seller summary

akakce_price_history

Price trend chart image URL

Account & Wishlists (Requires Auth)

Tool

Description

akakce_login

Authenticate and persist session cookie

akakce_logout

Clear saved session credentials

akakce_account_info

Current user profile, location, and notification counters

akakce_favorites

List favorite folders or items inside a list

akakce_favorite_add

Add product(s) to default favorite list

akakce_favorite_remove

Remove a product from a favorite list

akakce_price_alerts

List active price drop monitors

akakce_price_alert_set

Arm a price alert at a target price in TRY

akakce_notifications

Fetch unread price drop notification stream

Optional LLM Enrichment

Tool

Description

akakce_llm_enrich

Summarize, normalize, or compare Akakçe data with Fire-Pass Kimi Turbo (requires FIREWORKS_API_KEY)


Agent Integration Specs

  • Agent Contract: See AGENTS.md for execution protocols and failure recovery guidelines.

  • Copy-Paste Agent Rule: See GLOBAL_AGENT_RULE.md to add akakce-mcp to your AI assistant's system instructions.

  • API Reference: Detailed endpoint map reverse-engineered from mobile and web traffic is documented in API_REFERENCE.md.


Alternatives & Comparison

  • Compared to Puppeteer / Playwright scraping: Traditional browser automation is fragile, slow (2-5s per request), and requires 300+ MB RAM while triggering Akamai's anti-bot JS challenges (HTTP 403). akakce-mcp connects directly to the underlying JSON API via system curl in ~150ms with zero browser overhead.

  • Compared to Cimri.com scrapers: Cimri has a different seller ecosystem and lacks authenticated user wishlists, notification counters, and persistent price drop alarms. akakce-mcp covers both public pricing and authenticated private actions.

  • Compared to Google Shopping / SerpAPI: Commercial SERP APIs charge steep monthly subscription fees ($50-$200/mo) and often return delayed or incomplete merchant listings for Turkish regional sellers. akakce-mcp is 100% free, open-source, and retrieves real-time pricing directly.


Frequently Asked Questions (FAQ)

How do I use akakce-mcp with Claude Code?

Run claude mcp add akakce -- npx -y akakce-mcp. Claude Code will automatically register all 20 tools and connect via the standard stdio protocol.

Does akakce-mcp bypass Akamai bot protection?

Yes. Akakçe uses Akamai Bot Manager which blocks standard Node.js fetch with HTTP 403 Forbidden. akakce-mcp routes requests through system curl with authentic browser and mobile headers to bypass TLS fingerprinting.

Do I need an Akakçe account or API key to search prices?

No. All product search, multi-seller comparison, and category browsing features work out-of-the-box with zero credentials and zero API keys.

How do I extract my session token for price alerts?

You can run the interactive terminal login via npx akakce-mcp auth, extract the AAATLGST cookie from browser DevTools via npx akakce-mcp set-cookie, or set the AKAKCE_COOKIE environment variable.

How does akakce-mcp compare to direct web scraping?

Direct web scraping with Cheerio or Puppeteer is fragile, resource-heavy, and frequently triggers IP bans. akakce-mcp connects directly to the underlying api6.akakce.com JSON APIs, delivering fast, structured JSON data with zero browser overhead.


Citation

If you use akakce-mcp in research, benchmarking, or autonomous AI agent workflows, please cite:

@software{akakce_mcp_2026,
  author = {Öztürk, Enes},
  title = {akakce-mcp: Model Context Protocol Server for Akakçe Price Comparison},
  url = {https://github.com/nsozturk/akakce-mcp},
  year = {2026}
}

License

MIT &copy; Enes Öztürk.

Disclaimer: Akakçe is a registered trademark of Akakçe Bilgi Teknolojileri A.Ş. This project is an independent open-source tool and is not affiliated with or endorsed by Akakçe.

Available Tools

20 tools
akakce_account_infoAkakçe account infoA

Giriş yapılmış kullanıcının profil bilgisini döndürür (ad, e-posta, il/ilçe, bildirim sayısı). Giriş gerektirir.

Inputs: no named parameters.

akakce_autocompleteAkakçe autocompleteA

Akakçe arama önerileri. Bir arama ifadesi için ürün/kategori önerilerini ve (varsa) ürün kodlarını döndürür. Kullanıcı tam ürün adını bilmiyorsa önce bununla doğru ifadeyi/kodu bul.

Inputs: query (required).

akakce_category_browseAkakçe category browseA

Bir kategori kodunu (ctCode) gezerek o kategorideki ürünleri ve hızlı filtreleri (quickFilters) döndürür. filterIds vererek daraltabilirsin. ctCode'u arama sonuçlarından/ürün URL'lerinden ya da akakce_search_filters çıktısından elde edebilirsin.

Inputs: ctCode (required), page, filterIds.

akakce_dealsAkakçe deals (son indirimler)A

Akakçe'de son yakalanan indirimleri (fiyatı yeni düşen ürünler) döndürür. Giriş gerektirmez.

Inputs: no named parameters.

akakce_favorite_addAkakçe favorite addB

Bir veya daha fazla ürünü favorilere (varsayılan listeye) ekler. Ürün kod(lar)ını ver. Giriş gerektirir.

Inputs: codes (required).

akakce_favorite_removeAkakçe favorite removeA

Bir ürünü favori listesinden çıkarır. Ürün kodu (code) ve listId ver (listId'yi akakce_favorites'ten al). Giriş gerektirir.

Inputs: code (required), listId (required).

akakce_favoritesAkakçe favoritesA

Favori listelerini döndürür. listId verilmezse tüm listeleri (id, ad, ürün sayısı) listeler; listId verilirse o listenin ürünlerini (ad, fiyat, url) döndürür. Giriş gerektirir.

Inputs: listId.

akakce_home_feedAkakçe home feedA

Akakçe ana sayfasının bileşenlerini (keşfet/slider kartları: aktüel ürünler, kampanyalar, koleksiyonlar vb.) ve yönlendirme URL'lerini döndürür. Giriş gerektirmez.

Inputs: no named parameters.

akakce_llm_enrichAkakçe LLM enrich (Fire-Pass Kimi turbo)A

Akakçe arama/fiyat sonuçlarını bir LLM ile yorumlar: özetler, normalize eder, karşılaştırır veya verilen talimata göre filtreler. SADECE Fire-Pass guard'lı Kimi K2.6 Turbo ile çalışır. FIREWORKS_API_KEY tanımlı değilse devre dışıdır. Girdi olarak diğer akakce_* tool'larından aldığın JSON'u (ürünler/satıcılar) ver.

Inputs: data (required), instruction (required).

akakce_loginAkakçe loginA

Akakçe hesabına giriş yapar ve oturumu (AAATLGST çerezi) ~/.config/akakce-mcp/session.json içine kaydeder. Giriş sonrası favoriler, fiyat alarmları ve bildirim tool'ları çalışır. Kimlik bilgilerini parametre vermezsen AKAKCE_EMAIL / AKAKCE_PASSWORD ortam değişkenleri kullanılır. Oturum ~1 yıl geçerlidir; tekrar giriş gerekmez.

Inputs: email, password.

akakce_logoutAkakçe logoutA

Kaydedilmiş Akakçe oturumunu siler (session.json).

Inputs: no named parameters.

akakce_notificationsAkakçe notificationsA

Fiyat düşüşü bildirimlerini döndürür (ürün, yeni fiyat, düşüş oranı, tarih). Giriş gerektirir.

Inputs: no named parameters.

akakce_price_alertsAkakçe price alertsA

Kurulu fiyat alarmlarını listeler: ürün, hedef fiyat ve mevcut fiyat. Giriş gerektirir.

Inputs: no named parameters.

akakce_price_alert_setAkakçe set price alertA

Bir ürün için fiyat alarmı kurar/günceller: fiyat hedef değere düşünce bildirim gelir. Ürün kodu ve hedef fiyat (TL) ver. Giriş gerektirir.

Inputs: code (required), targetPrice (required).

akakce_price_historyAkakçe price historyA

Bir ürünün fiyat geçmişi grafiğini döndürür. Akakçe geçmişi yalnızca hazır bir grafik GÖRSELİ (PNG) olarak sunar — sayısal veri noktası yoktur. Sonuçta grafiğin doğrudan görüntü URL'i döner (kullanıcıya gösterilebilir). Sadece ürün code'u yeterli.

Inputs: url, code.

akakce_product_detailAkakçe product detailA

Bir ürünün tam detayını döndürür: ad, marka, teknik özellikler, ortalama puan, en düşük/en yüksek fiyat ve TÜM satıcıların listesi (fiyat, kargo, satıcı puanı, teslimat, satıcıya direkt gidiş linki). Sadece ürün code'u yeterli — URL otomatik çözülür. İstersen url (akakce_search'teki productUrl) vererek bir istek atlayabilirsin.

Inputs: url, code.

akakce_product_pricesAkakçe product pricesA

Bir veya daha fazla ürün kodu için Akakçe'deki en ucuz satıcıları (quickview) döndürür: fiyat, kargo, satıcı adı, son güncelleme ve satıcıya gidiş linki. Ürün kodlarını akakce_search / akakce_autocomplete sonuçlarından al. Birden çok kodu tek çağrıda ver (toplu).

Inputs: codes (required).

akakce_quickviewAkakçe quickview (tek ürün)A

Tek bir ürün kodu için en ucuz satıcı(ları) hızlıca döndürür (akakce_product_prices'ın tekli/hafif sürümü). Giriş gerektirmez.

Inputs: code (required).

akakce_search_filtersAkakçe search filtersA

Bir arama ifadesi için uygulanabilir filtre gruplarını (marka, özellik, RAM, vb.) ve her filtrenin id'sini döndürür. Dönen filtre id'lerini akakce_search'e filterIds olarak vererek sonucu daraltabilirsin.

Inputs: phrase (required), sort.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 20 tools

    Disambiguation4/5

    Most tools target distinct Akakçe resources or workflows: search, category browsing, product detail, favorites, alerts, and account are clearly separated. The main overlap is price retrieval: akakce_product_prices, akakce_quickview, and akakce_product_detail all return seller/price data, though the descriptions distinguish bulk, single lightweight, and full-detail use cases.

    Naming Consistency4/5

    All tools use the same akakce_ prefix and snake_case, making the set highly readable. However, the pattern mixes verb-noun forms (akakce_favorite_add) with noun-only forms (akakce_deals, akakce_quickview, akakce_notifications), which is a minor inconsistency rather than a serious problem.

    Tool Count3/5

    Twenty tools is reasonable for a full shopping/price-comparison server spanning search, favorites, alerts, account, and notifications. Still, 20 falls in the heavy range, and a few tools such as akakce_quickview and akakce_llm_enrich feel like optional conveniences rather than essential surface area.

    Completeness4/5

    The server covers the main Akakçe workflows well: discovery, search/filtering, price lookup, product detail, price history, authentication, favorites, alerts, and notifications. Minor gaps remain around full favorite-list lifecycle management (no create/delete list) and alert lifecycle (no explicit alert deletion), but these are workaroundable.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables searching and comparing product prices across Turkish supermarket chains (BIM, A101, Migros, SOK, etc.) with location-based filtering. Provides access to Turkish market data from marketfiyati.org.tr for price tracking and comparison.
      3
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search Digikala's catalogue, compare every seller's offers and prices, review ~30 days of price history, read customer reviews and Q&A, and surface current deals, all through read-only tools.
      23
      528 PyPI
      43
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search Technolife's electronics catalog, compare every seller's cash, installment and buy-now-pay-later prices, read specs and reviews, and catch current deals and campaigns. It is read-only by design, with no login, basket, orders or payment access.
      19
      754 PyPI
      7
      MIT