Shoptera Product Intelligence
@Filip Podstavec
Shoptera Product Intelligence Search product catalogs across thousands of Central European e-shops. Semantic search, keyword matching, GTIN/EAN lookup β via REST API or MCP.
~2,500 e-shops | ~8.5M products | 7 countries (CZ, SK, PL, HU, RO, DE, AT)
Live stats: GET /stats/global
Quickstart No authentication required. Base URL: https://shoptera.ai/api
Semantic search β natural language, understands intent:
curl "https://shoptera.ai/api/v1/search?q=dΓ‘rek+pro+zahradnΓka+do+500+KΔ&max_price=500¤cy=CZK&origin_country=CZ" Keyword search β exact title matching, fast:
curl "https://shoptera.ai/api/v1/search/text?title=Nike+Air+Max+90&brand=Nike" GTIN/EAN lookup β find e-shops by barcode:
curl "https://shoptera.ai/api/v1/search/gtin/5901234123457" Saving tokens: Add fields to return only what you need (up to 70% smaller response):
curl "https://shoptera.ai/api/v1/search?q=boty&limit=5&fields=title,price,product_url,cart_action" Quick Install Claude Code (one command) claude mcp add --transport http shoptera https://shoptera.ai/api/mcp Cursor Add to Cursor Settings β Features β MCP β Add New MCP Server, or edit ~/.cursor/mcp.json:
{ "mcpServers": { "shoptera": { "url": "https://shoptera.ai/api/mcp" } } } Windsurf Add via Cascade β MCP Servers β Add Server, or edit ~/.codeium/windsurf/mcp_config.json:
{ "mcpServers": { "shoptera": { "url": "https://shoptera.ai/api/mcp" } } } VS Code (Copilot / Continue) Edit .vscode/mcp.json in your workspace:
{ "mcpServers": { "shoptera": { "url": "https://shoptera.ai/api/mcp" } } } Any tool (universal installer) npx add-mcp https://shoptera.ai/api/mcp -n shoptera -g -y All Platforms Platform Setup Details Claude Code claude mcp add --transport http shoptera https://shoptera.ai/api/mcp Skill guide Cursor MCP config Settings β Features β MCP Windsurf MCP config Cascade β MCP Servers VS Code MCP config .vscode/mcp.json OpenAI Codex AGENTS.md Agent config reference ChatGPT OpenAPI spec Custom GPT actions. Instructions Gemini GEMINI.md Tool definitions and endpoints Any HTTP client Examples curl, Python, JavaScript MCP Details Endpoint: https://shoptera.ai/api/mcp (streamable HTTP, stateless, no auth)
3 tools: search_products, search_products_by_text, lookup_by_gtin
Capabilities Product Search β semantic vs keyword vs GTIN, when to use which, filters, scoring Cart Actions β three action types, how to handle each Data Coverage β countries, data freshness, live stats API Reference Full documentation: api/reference.md
OpenAPI spec: api/openapi.yaml
Endpoints Method Path Description GET /api/v1/search?q=... Semantic search (natural language) GET /api/v1/search/text?title=... Keyword search (exact title match) GET /api/v1/search/gtin/{gtin} GTIN/EAN barcode lookup GET /stats/global Catalog statistics Code Examples Semantic search β curl, Python, JavaScript Keyword search β curl, Python, JavaScript GTIN/EAN lookup β curl, Python, JavaScript Cart actions β handling all three action types
Server Config
{
"mcpServers": {
"shoptera": {
"type": "streamable-http",
"url": "https://shoptera.ai/api/mcp"
}
}
}