convez.ai
MCP ServerIntegração & APIsIntermediário
shopsavvy

ShopSavvy MCP Server

shopsavvy/shopsavvy-mcp-server

Integração MCP para lookup de produtos e monitoramento de preços em varejistas

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que integra a API de dados do ShopSavvy, fornecendo lookup de produtos, consulta de preços em múltiplos varejistas e histórico de preços. Permite que assistentes de IA monitorem preços automaticamente e acessem dados completos de ofertas com agendamento de atualizações.

Instalação

$npx convez-ai shopsavvy/shopsavvy-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
10
Forks
5
Acompanhando
0
Saúde
62%
Último commit
há 2 dias
Versão
v1.0.4
Issues abertas
1
Contribuidores
1

Casos de uso

  • Comparação de preços entre múltiplos varejistas em tempo real
  • Monitoramento automático de histórico de preços com agendamento
  • Lookup de produtos por código de barras, ASIN, URL ou ID ShopSavvy
  • Integração em assistentes de IA para recomendações de compra baseadas em preços

Veredito

MCP server bem estruturado para integração de dados de preços do ShopSavvy em assistentes Claude. Oferece toolset completo (lookup, ofertas, histórico, agendamento) com configuração direta via Claude Desktop, mas exige chave de API ativa e conta no ShopSavvy Data.

README

A tradução para o português deste README ainda está na fila.

ShopSavvy Data API MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with access to ShopSavvy's comprehensive product data, pricing information, and historical price tracking.

Overview

This MCP server enables AI assistants to:

  • Look up products by barcode, ASIN, URL, model number, or ShopSavvy ID
  • Get current pricing from multiple retailers
  • Access historical pricing data with date ranges
  • Schedule products for automatic price monitoring
  • Track API usage

Features

🔍 Product Lookup Tools

  • product_lookup - Find products by various identifiers (barcode, ASIN, URL, etc.)
  • product_lookup_batch - Look up multiple products at once

💰 Offer Tools

  • product_offers - Get current offers from all retailers
  • product_offers_retailer - Get offers from a specific retailer
  • product_price_history - Get historical pricing data with date ranges

📅 Scheduling Tools

  • product_schedule - Schedule products for automatic refresh (hourly/daily/weekly)
  • product_unschedule - Remove products from refresh schedule
  • scheduled_products_list - View all scheduled products

📊 Analytics Tools

  • api_usage - View current API usage

Installation

npm install @shopsavvy/mcp-server

Configuration

1. Get API Key

First, get your ShopSavvy Data API key:

  1. Visit https://shopsavvy.com/data
  2. Sign up and create an API key in your dashboard
  3. Copy your API key (starts with ss_live_ or ss_test_)

2. Claude Desktop Setup

Add this to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "shopsavvy": {
      "command": "npx",
      "args": [
        "@shopsavvy/mcp-server"
      ],
      "env": {
        "SHOPSAVVY_API_KEY": "your_api_key_here"
      }
    }
  }
}

3. Environment Variables

Set your API key as an environment variable:

export SHOPSAVVY_API_KEY="ss_live_your_key_here"

Or create a .env file:

SHOPSAVVY_API_KEY=ss_live_your_key_here

Usage Examples

Product Lookup

Look up the product with barcode 012345678901

Current Pricing

Get current prices for ASIN B08N5WRWNW from all retailers

Price History

Get price history for product 012345678901 from January 1-15, 2024

Schedule Monitoring

Schedule daily price monitoring for products: 012345678901, B08N5WRWNW

Development

Running Locally

# Clone the repository
git clone https://github.com/shopsavvy/shopsavvy-mcp-server
cd shopsavvy-mcp-server

# Install dependencies
npm install

# Set your API key
export SHOPSAVVY_API_KEY="your_key_here"

# Test with MCP CLI
npm run dev

# Or inspect with MCP Inspector
npm run inspect

Building

npm run build

Error Handling

The server provides detailed error messages for:

  • Invalid API keys
  • Insufficient credits
  • Rate limiting
  • Invalid product identifiers
  • API service issues

Support

Changelog

v1.0.0 (2025-07-28)

🎉 Initial Release

  • Features: Complete ShopSavvy Data API integration with MCP support
  • Product Tools: Lookup by barcode, ASIN, URL, model number, or ShopSavvy ID
  • Pricing Tools: Current offers from all/specific retailers, historical pricing data
  • Scheduling Tools: Automatic product monitoring (hourly/daily/weekly)
  • Analytics Tools: API usage monitoring
  • npm Package: Published as @shopsavvy/mcp-server under ShopSavvy organization
  • TypeScript: Full TypeScript support with proper error handling
  • Documentation: Comprehensive README with examples and configuration guides

License

MIT License - see LICENSE file for details.


Made with ❤️ by ShopSavvy - Empowering everyone to always get the best deal, every time.

Ver o original no GitHub

Bom para

Relacionados