akakce-mcp
Summary: akakce-mcp lets AI agents search Akakçe, compare live prices and sellers, browse categories/deals, and manage authenticated account features.
Autocomplete product/category queries and find canonical product codes.
Search products with pagination, sorting, category filters, and available filter groups.
Browse category feeds, home cards/campaigns/collections, and recent deals.
Get batched or single-product quick prices, cheapest sellers, shipping, ratings, links, and full product detail with all sellers.
Retrieve a product price-history chart image URL.
Log in/logout, check account info, and persist session securely.
List/manage favorites and add/remove products.
List, create/update, and receive price-drop alerts and notifications.
Optionally enrich/summarize/filter/compare Akakçe data with an LLM if FIREWORKS_API_KEY is set.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@akakce-mcp compare prices for Sony WH-1000XM5 across sellers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 withHTTP 403 Forbidden.akakce-mcproutes requests through systemcurlusing 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.jsonwith0600permissions) 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-mcpOr install globally:
npm install -g akakce-mcpRequirement: System
curlmust 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-mcp2. Cursor IDE
Open Settings → Features → MCP → Add New MCP Server:
Name:
akakceType:
commandCommand:
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:
Method 1: Interactive Terminal Login (Recommended)
Run the built-in authentication command:
npx akakce-mcp authThis 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).
Method 2: Extract Cookie from Browser (DevTools)
If you log in via Google, Apple ID, or prefer not to input your password in the terminal:
Log in to akakce.com in your browser.
Open Developer Tools (
F12orCmd+Opt+I) → Application tab → Cookies →https://www.akakce.com.Locate the cookie named
AAATLGSTand copy its value.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 whoamiClear Saved Session
npx akakce-mcp logoutTool Directory (20 Tools)
Discovery & Search (Public)
Tool | Description |
| Instant search suggestions and canonical product codes |
| Paginated product search with sorting and category filters |
| Available filter groups (brands, specs, price range) for a query |
| Category tree hierarchy and paginated category feeds |
| Home screen cards, campaigns, and active collections |
| Real-time stream of recently discounted items |
Pricing & Market Intelligence (Public)
Tool | Description |
| Complete seller list (prices, shipping, ratings, specs, store links) |
| Batched pricing lookup across multiple product codes |
| Rapid single-product price and seller summary |
| Price trend chart image URL |
Account & Wishlists (Requires Auth)
Tool | Description |
| Authenticate and persist session cookie |
| Clear saved session credentials |
| Current user profile, location, and notification counters |
| List favorite folders or items inside a list |
| Add product(s) to default favorite list |
| Remove a product from a favorite list |
| List active price drop monitors |
| Arm a price alert at a target price in TRY |
| Fetch unread price drop notification stream |
Optional LLM Enrichment
Tool | Description |
| Summarize, normalize, or compare Akakçe data with Fire-Pass Kimi Turbo (requires |
Agent Integration Specs
Agent Contract: See
AGENTS.mdfor execution protocols and failure recovery guidelines.Copy-Paste Agent Rule: See
GLOBAL_AGENT_RULE.mdto addakakce-mcpto 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-mcpconnects directly to the underlying JSON API via systemcurlin ~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-mcpcovers 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-mcpis 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 © 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 toolsakakce_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_searchAkakçe product searchA
Akakçe'de ürün arar ve fiyatlı sonuç listesi döndürür. Her ürün: ad, marka, en düşük fiyat, satıcı sayısı, rating, ürün kodu (price/detail için kullan) ve ürün sayfası URL'i. Sayfalama (page) ve filtreleme (ctCode + filterIds, bunları akakce_search_filters'tan al) destekler.
Inputs: phrase (required), page, sort, ctCode, +1 more.
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
Scored across 20 tools
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.
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.
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.
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
Related MCP Connectors
Product search for AI shopping agents: prices and buy links from big retailers. No key needed.
Track the price you actually pay on Amazon.com.tr, Hepsiburada and Trendyol.
Product price checks and affiliate link building for AI shopping agents.
The E-commerce Marketplace For Every AI Agent. A Governed Catalog Of 600M+ US Products, Plus Four Agent Ready Capabilities Search, Price Comparison, Product-Vs-Product, And Detailed Q&A.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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.3MIT
- AlicenseAqualityDmaintenanceEnables querying Turkish market prices, searching products, and comparing prices across different stores using the Market Fiyatı API.38 npm37MIT
- AlicenseAqualityBmaintenanceEnables 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.23528 PyPI43MIT
- AlicenseAqualityBmaintenanceEnables 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.19754 PyPI7MIT