🧺 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: claude.ai/download
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):

Abra o Finder (macOS) ou Explorer (Windows)
macOS: Pressione Cmd + Shift + G e cole: ~/Library/Application Support/Claude/
Windows: Cole na barra de endereços: %APPDATA%\Claude
Se a pasta não existir, crie-a
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:

O Mercado Livre mudou o layout da página (eles fazem testes A/B frequentemente).
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

MCP Servers