Price Tracker MCP

🧺 Price Tracker MCP Server

Servidor MCP que permite ao Claude buscar máquinas lava e seca pelos menores preços.

🛒 Onde busca?

Atualmente a busca é realizada exclusivamente no Mercado Livre Brasil.

Por que apenas Mercado Livre? Testes mostraram que o Mercado Livre oferece a API/interface mais estável para consultas em tempo real. Outras lojas (Amazon, Magalu, Casas Bahia) possuem proteções anti-robô agressivas (Captchas, bloqueios 503) que impedem o funcionamento confiável deste tipo de ferramenta no momento.

💡 O que é isso?

Este é um servidor MCP (Model Context Protocol) - uma extensão que dá ao Claude a capacidade de buscar preços de produtos em tempo real. Com ele instalado, você pode pedir ao Claude coisas como:

• *"Me mostre as máquinas lava e seca mais baratas"*
• *"Quais são as opções da Samsung de 11kg?"*
• *"Busque lava e seca da Brastemp até R$ 3000"*

✨ Recursos

• 🔍 Busca robusta no Mercado Livre (suporta múltiplos layouts de página)
• 💰 Ordenação por menor preço
• 🏷️ Filtros por marca e capacidade
• 🔗 Links diretos para compra
• ⚡ Resultados em tempo real

📋 Pré-requisitos

1. Python 3.10 ou superior

Verifique se você tem Python instalado:

python3 --version

Se não tiver, instale:

• macOS: brew install python3 (requer Homebrew)
• Windows: Baixe em python.org
• Linux: sudo apt install python3 (Ubuntu/Debian) ou sudo dnf install python3 (Fedora)

2. Claude Desktop App

Baixe e instale o Claude Desktop:

• Site oficial:
• Disponível para macOS e Windows
• Crie uma conta gratuita se ainda não tiver

3. Git (opcional, mas recomendado)

Para clonar o repositório facilmente:

• macOS: Já vem instalado ou brew install git
• Windows: Baixe em git-scm.com
• Linux: sudo apt install git ou sudo dnf install git

🚀 Instalação

Passo 1: Clone ou baixe este repositório

cd /Users/SEU_USUARIO/Documents
git clone [url-do-repositorio]
cd price-tracker-mcp

Passo 2: Instale as dependências

É crucial instalar o pacote em modo de edição (-e) para que o comando python3 -m price_tracker_mcp.server funcione corretamente.

python3 -m pip install -e .

Passo 3: Configure o Claude Desktop

O Claude Desktop precisa saber onde encontrar seu servidor MCP. Para isso, você vai editar (ou criar) um arquivo de configuração.

3.1. Localize ou crie o arquivo de configuração

macOS:

O arquivo fica em: ~/Library/Application Support/Claude/claude_desktop_config.json

   # Opção 1: Tentar abrir o arquivo (se já existir)
   open -a TextEdit ~/Library/Application\ Support/Claude/claude_desktop_config.json
   
   # Opção 2: Se o comando acima der erro, crie a pasta e o arquivo:
   mkdir -p ~/Library/Application\ Support/Claude
   touch ~/Library/Application\ Support/Claude/claude_desktop_config.json
   open -a TextEdit ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

O arquivo fica em: %APPDATA%\Claude\claude_desktop_config.json

   # Opção 1: Tentar abrir o arquivo (se já existir)
   notepad %APPDATA%\Claude\claude_desktop_config.json
   
   # Opção 2: Se o comando acima der erro, crie a pasta e o arquivo:
   # Abra o PowerShell e execute:

   New-Item -ItemType Directory -Force -Path "$env:APPDATA\Claude"
   New-Item -ItemType File -Path "$env:APPDATA\Claude\claude_desktop_config.json"
   notepad "$env:APPDATA\Claude\claude_desktop_config.json"

💡 Método alternativo (qualquer sistema):

1. Abra o Finder (macOS) ou Explorer (Windows) 2. macOS: Pressione Cmd + Shift + G e cole: ~/Library/Application Support/Claude/ 3. Windows: Cole na barra de endereços: %APPDATA%\Claude 4. Se a pasta não existir, crie-a 5. Crie um arquivo novo chamado claude_desktop_config.json (use um editor de texto)

3.2. Edite o arquivo

Copie e cole exatamente este conteúdo no arquivo.

Nota: Certifique-se de que o comando python3 está no seu PATH. Se você usa ambientes virtuais (venv), pode ser necessário colocar o caminho completo para o executável do python.

{
  "mcpServers": {
    "price-tracker": {
      "command": "python3",
      "args": [
        "-m",
        "price_tracker_mcp.server"
      ]
    }
  }
}

⚠️ Importante:

• Se o arquivo já tiver conteúdo, adicione o servidor price-tracker dentro de mcpServers
• Mantenha a formatação JSON correta (vírgulas, chaves, aspas)
• Salve o arquivo após editar

3.3. Exemplo com múltiplos servidores

Se você já usa outros servidores MCP, o arquivo ficará assim:

{
  "mcpServers": {
    "outro-servidor": {
      "command": "...",
      "args": ["..."]
    },
    "price-tracker": {
      "command": "python3",
      "args": [
        "-m",
        "price_tracker_mcp.server"
      ]
    }
  }
}

Passo 4: Reinicie o Claude Desktop

Reinicie o Claude Desktop completamente (feche e abra novamente) para carregar as novas configurações.

Passo 5: Verifique se funcionou

Abra o Claude Desktop e pergunte:

*"Você tem acesso à ferramenta de busca de máquinas lava e seca?"*

Se o Claude responder que sim, está tudo funcionando! 🎉

🛠️ Solução de Problemas

"Hmm, a busca não retornou resultados no momento"

Se você receber esta mensagem, pode ser que:

1. O Mercado Livre mudou o layout da página (eles fazem testes A/B frequentemente).
2. O termo de busca não encontrou produtos exatos.

Solução: Tente buscar por termos mais genéricos (ex: "lava e seca samsung" em vez de um modelo específico cheio de códigos). O servidor foi atualizado recentemente para lidar com múltiplos layouts de página, então tente novamente em alguns instantes.

Erro ao conectar com o servidor MCP

Verifique os logs do Claude Desktop:

• macOS: ~/Library/Logs/Claude/mcp-server-price-tracker.log
• Windows: %APPDATA%\Claude\logs\mcp-server-price-tracker.log

Certifique-se de que instalou as dependências com pip install -e ..

🎯 Como Usar

Agora você pode conversar naturalmente com o Claude:

Exemplos de perguntas:

"Busque máquinas lava e seca"

"Me mostre as 5 máquinas lava e seca mais baratas"

"Quais são as opções da marca Electrolux?"

"Busque lava e seca LG com capacidade de 11kg"

"Me mostre máquinas Samsung de até 12kg"

O Claude vai usar a ferramenta automaticamente e te mostrar:

• Nome do produto
• Preço
• Link para compra
• Loja

🛠️ Ferramenta Disponível

search_washer_dryer

Busca máquinas lava e seca pelos menores preços

Parâmetros (todos opcionais):

• brand: Marca específica (ex: "Brastemp", "Electrolux", "LG", "Samsung")
• capacity: Capacidade em kg (ex: "10kg", "11kg", "12kg")
• max_results: Quantidade de resultados (padrão: 15)

🧪 Testando Localmente

Se quiser testar o servidor antes de conectar ao Claude:

python3 -m price_tracker_mcp.server

O servidor vai iniciar e aguardar comandos via stdin/stdout.

❓ Solução de Problemas

O Claude não vê a ferramenta

• Certifique-se de ter reiniciado o Claude Desktop completamente
• Verifique se o caminho do python3 está correto no seu sistema
• Confirme que a instalação foi feita com sucesso

Erros de instalação

# Tente criar um ambiente virtual primeiro
python3 -m venv venv
source venv/bin/activate  # No Windows: venv\Scripts\activate
pip install -e .

O servidor não inicia

• Verifique sua versão do Python: python3 --version (precisa ser 3.10+)
• Reinstale as dependências: pip install -r requirements.txt

📝 Notas

• Os preços são buscados em tempo real no Mercado Livre
• A busca é feita por web scraping de forma ética
• Os resultados podem variar conforme disponibilidade
• Timeout de 10 segundos para garantir rapidez
• Retorna até 15 produtos por padrão

🤝 Contribuindo

Sinta-se livre para abrir issues ou pull requests para melhorias!

📄 Licença

MIT