Shoptera

Shoptera Product Intelligence Search product catalogs across thousands of Central European e-shops.

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

  • Search Products: Search products using natural language across ~8.5M products from 2,500+ Central European e-shops. Returns a dict with 'results' (list of product objects) and 'total_found' (int). Eac
  • Lookup By Gtin: Look up products by exact GTIN/EAN/UPC barcode across all indexed e-shops. Returns a dict with 'results' (list of product objects) and 'total_found' (int). Each product contains: title
  • Search Products By Text: Search products by exact keyword matching in titles across ~8.5M products from 2,500+ e-shops. Returns a dict with 'results' (list of product objects) and 'total_found' (int).

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

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&currency=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

Как подключить

Как подключить Shoptera к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://shoptera-product-intelligence.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить Shoptera к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://shoptera-product-intelligence.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить Shoptera к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://shoptera-product-intelligence.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (3)

Технические названия из tools/list. Нужны только разработчикам.

search_productsSearch products using natural language across ~8.5M products from 2,500+ Central European e-shops. Returns a dict with 'results' (list of product objects) and 'total_found' (int). Each product contains: title, description, price, currency, brand, category, gtin, image_url, product_url, availability, eshop_name, eshop_domain, origin_country, target_countries, score (0-1 relevance), and cart_action. The cart_action object tells you how to add the product to cart: - method="GET": navigate to cart_action.url — product is added automatically. - method="browser_click": navigate to cart_action.url, then click the button matching cart_action.button_text. - method="view_product": show the product page URL to the user. Use 'fields' parameter to return only needed fields and save tokens. Prefer this tool for open-ended queries. Use search_products_by_text when you know the exact product name, or lookup_by_gtin when you have a barcode number.
lookup_by_gtinLook up products by exact GTIN/EAN/UPC barcode across all indexed e-shops. Returns a dict with 'results' (list of product objects) and 'total_found' (int). Each product contains: title, description, price, currency, brand, category, gtin, image_url, product_url, availability, eshop_name, eshop_domain, origin_country, target_countries, and cart_action. The cart_action object tells you how to add the product to cart: - method="GET": navigate to cart_action.url — product is added automatically. - method="browser_click": navigate to cart_action.url, then click the button matching cart_action.button_text. - method="view_product": show the product page URL to the user. Use this tool when you have a barcode number and want to compare prices across e-shops. For natural language queries, use search_products instead.
search_products_by_textSearch products by exact keyword matching in titles across ~8.5M products from 2,500+ e-shops. Returns a dict with 'results' (list of product objects) and 'total_found' (int). Each product contains: title, description, price, currency, brand, category, gtin, image_url, product_url, availability, eshop_name, eshop_domain, origin_country, target_countries, and cart_action. The cart_action object tells you how to add the product to cart: - method="GET": navigate to cart_action.url — product is added automatically. - method="browser_click": navigate to cart_action.url, then click the button matching cart_action.button_text. - method="view_product": show the product page URL to the user. Faster and more deterministic than semantic search. Use this when you know the exact product name. For open-ended natural language queries, use search_products instead.