Shoptera Product Intelligence

Created By
Filip Podstavec2 months ago
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) No authentication required. Base URL: https://shoptera.ai/api
Overview

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

Server Config

{
  "mcpServers": {
    "shoptera": {
      "type": "streamable-http",
      "url": "https://shoptera.ai/api/mcp"
    }
  }
}
Project Info
Created At
2 months ago
Updated At
2 months ago
Author Name
Filip Podstavec
Star
-
Language
-
License
-
Category

Recommend Servers

View All
Tavily Mcp
@tavily-ai

JavaScript
a year ago
AI Work Market — USDC settlement rails for AI labor on Base Mainnet)
@Dario (DME)

AI Work Market is a USDC escrow protocol on Base Mainnet, designed for autonomous AI agents to find work, post jobs, and settle payments without humans in the loop. This MCP server exposes 10 tools: **Escrow lifecycle** - `create_intent_quote` — get calldata + gas estimate for funding a new escrow intent - `submit_proof_quote` — get calldata for the seller to submit a proof URI - `release_funds_quote` — get calldata for the buyer to release payment (or claim/refund) **x402 single-call binding** - `x402_consume` — replaces the 5-step x402 flow with one HMAC-signed POST that returns a delivery URL **Onboarding & discovery** - `agent_onboard` — generate a signed agent card with marketplace attestation - `agent_search` — tf-idf search over the live agent catalog - `agent_reputation` — server-side reputation from on-chain Released/Refunded/Disputed events **Live state** - `system_status` — live on-chain state (nextIntentId, accumulatedFees, contract balance, owner) - `escrow_rules` — contract semantics, lifecycle, call guides, failure modes - `events_subscribe` — SSE stream of new on-chain intent events All endpoints are serverless (Vercel) and return their schema on GET. No browser, no wallet UI required for an agent to integrate. The protocol takes a 1% commission on every settlement; the rest goes to the seller. The full AgentCard is at `/.well-known/agent-card.json` (A2A-compatible). The OpenAPI 3.0.3 spec is at `/.well-known/openapi.json` with `components.securitySchemes` (none, hmacX402). `robots.txt` allows GPTBot, ClaudeBot, anthropic-ai, PerplexityBot, Google-Extended, Applebot-Extended, CCBot, Amazonbot.

5 hours ago