Shoptera

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

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

  • 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).

What data it sees

Do you need an account

No: the server works without sign-in

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

How to connect

How to connect Shoptera to Claude

The server address to paste into Claude settings:

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

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect Shoptera to ChatGPT

The server address to paste into ChatGPT settings:

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

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect Shoptera to Cursor

The server address to paste into Cursor settings:

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

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (3)

Raw names from tools/list. Only developers need these.

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.