{"id":"e2405f98-446b-425b-815a-26a914dbb0ba","slug":"smithery-product-intelligence-shoptera","name":"Shoptera","description":"Shoptera Product Intelligence\nSearch product catalogs across thousands of Central European e-shops. Semantic search, keyword matching, GTIN/EAN lookup — via REST API or MCP.\n\n~2,500 e-shops | ~8.5M products | 7 countries (CZ, SK, PL, HU, RO, DE, AT)\n\nLive stats: GET /stats/global\n\nQuickstart\nNo authentication required. Base URL: https://shoptera.ai/api\n\nSemantic search — natural language, understands intent:\n\ncurl \"https://shoptera.ai/api/v1/search?q=dárek+pro+zahradníka+do+500+Kč&max_price=500&currency=CZK&origin_country=CZ\"\nKeyword search — exact title matching, fast:\n\ncurl \"https://shoptera.ai/api/v1/search/text?title=Nike+Air+Max+90&brand=Nike\"\nGTIN/EAN lookup — find e-shops by barcode:\n\ncurl \"https://shoptera.ai/api/v1/search/gtin/5901234123457\"\nSaving tokens: Add fields to return only what you need (up to 70% smaller response):\n\ncurl \"https://shoptera.ai/api/v1/search?q=boty&limit=5&fields=title,price,product_url,cart_action\"\nQuick Install\nClaude Code (one command)\nclaude mcp add --transport http shoptera https://shoptera.ai/api/mcp\nCursor\nAdd to Cursor Settings → Features → MCP → Add New MCP Server, or edit ~/.cursor/mcp.json:\n\n{\n  \"mcpServers\": {\n    \"shoptera\": { \"url\": \"https://shoptera.ai/api/mcp\" }\n  }\n}\nWindsurf\nAdd via Cascade → MCP Servers → Add Server, or edit ~/.codeium/windsurf/mcp_config.json:\n\n{\n  \"mcpServers\": {\n    \"shoptera\": { \"url\": \"https://shoptera.ai/api/mcp\" }\n  }\n}\nVS Code (Copilot / Continue)\nEdit .vscode/mcp.json in your workspace:\n\n{\n  \"mcpServers\": {\n    \"shoptera\": { \"url\": \"https://shoptera.ai/api/mcp\" }\n  }\n}\nAny tool (universal installer)\nnpx add-mcp https://shoptera.ai/api/mcp -n shoptera -g -y\nAll Platforms\nPlatform\tSetup\tDetails\nClaude Code\tclaude mcp add --transport http shoptera https://shoptera.ai/api/mcp\tSkill guide\nCursor\tMCP config\tSettings → Features → MCP\nWindsurf\tMCP config\tCascade → MCP Servers\nVS Code\tMCP config\t.vscode/mcp.json\nOpenAI Codex\tAGENTS.md\tAgent config reference\nChatGPT\tOpenAPI spec\tCustom GPT actions. Instructions\nGemini\tGEMINI.md\tTool definitions and endpoints\nAny HTTP client\tExamples\tcurl, Python, JavaScript\nMCP Details\nEndpoint: https://shoptera.ai/api/mcp (streamable HTTP, stateless, no auth)\n\n3 tools: search_products, search_products_by_text, lookup_by_gtin\n\nCapabilities\nProduct Search — semantic vs keyword vs GTIN, when to use which, filters, scoring\nCart Actions — three action types, how to handle each\nData Coverage — countries, data freshness, live stats\nAPI Reference\nFull documentation: api/reference.md\n\nOpenAPI spec: api/openapi.yaml\n\nEndpoints\nMethod\tPath\tDescription\nGET\t/api/v1/search?q=...\tSemantic search (natural language)\nGET\t/api/v1/search/text?title=...\tKeyword search (exact title match)\nGET\t/api/v1/search/gtin/{gtin}\tGTIN/EAN barcode lookup\nGET\t/stats/global\tCatalog statistics\nCode Examples\nSemantic search — curl, Python, JavaScript\nKeyword search — curl, Python, JavaScript\nGTIN/EAN lookup — curl, Python, JavaScript\nCart actions — handling all three action types\n","capabilities":[],"protocols":["MCP"],"safetyScore":86,"overallRank":42.3,"trustScore":null,"trust":null,"source":"SMITHERY","updatedAt":"2026-04-17T06:33:52.079Z"}