# Shoptera

> Use this tool when you need to search product catalogs across thousands of Central European e-shops, solving problems such as finding specific products, comparing prices, or retrieving product information via semantic search, keyword matching, or GTIN/EAN lookup. It provides a REST API or MCP interface with inputs such as search queries, keywords, or GTIN/EAN codes, and outputs product information, prices, and cart actions. Use Shoptera in contexts where you require quick and accurate product search and retrieval, such as e-commerce, price comparison, or product research applications.

Canonical page: https://skillsregistry.net/skills/product-intelligence-shoptera  
JSON: https://api.skillsregistry.net/v1/skills/product-intelligence-shoptera

## Description

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

## Trust

- **Trust score (0–1):** 0.50
- **Verification tier:** unverified

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** ai-ml
- **Updated:** 2026-05-10

## Source

- **Source listing:** [Smithery](https://smithery.ai/server/product_intelligence/shoptera)

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "product-intelligence-shoptera"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/product-intelligence-shoptera` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/product-intelligence-shoptera/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt