AI Shopping Assistant

Um assistente de compras com IA conversacional para descoberta e tomada de decisão de produtos baseada na web.

Documentação

🛍️ Assistente de Compras com IA

Um assistente de compras inteligente e conversacional, alimentado pelo modelo de IA Groq e pelo Protocolo de Contexto de Modelo (MCP) para descoberta e tomada de decisão inteligente de produtos na web.

✨ Visão Geral

O Assistente de Compras com IA é um chatbot interativo, alimentado por IA, que ajuda os usuários a tomar decisões de compra mais inteligentes. Com o suporte do LLM Groq da xAI e do Protocolo de Contexto de Modelo (MCP), ele pode:

🧠 Entender consultas em linguagem natural
🔎 Realizar buscas em tempo real em plataformas de compras
🛒 Comparar produtos, serviços e recursos
💸 Fornecer orientação de preços e recomendações

Esteja você escolhendo entre celulares, comparando serviços de streaming ou procurando o melhor purificador de ar dentro do orçamento—este assistente é o seu parceiro de compras definitivo.

🧩 Recursos

Recurso	Descrição
🔄 Comparação de Produtos	Compare produtos (ex.: iPhone 15 vs. Galaxy S24)
🎯 Recomendações Inteligentes	Obtenha sugestões com base nas suas necessidades e orçamento
📊 Análise de Recursos	Entenda especificações, prós, contras e muito mais
💵 Orientação de Preços	Determine as opções de melhor custo-benefício
🌐 Comparação de Serviços	Compare serviços como Netflix vs. Prime Video
🔍 Busca na Web (via MCP)	Busca em plataformas de compras como Amazon, Flipkart, Best Buy
💬 Chat com Contexto	Mantém o contexto da conversa e fornece resumos
🔁 Repetições e Fallbacks	Tratamento inteligente de buscas com falha e conselhos por categoria
💡 Comandos de Chat	`/exit`, `/clear`, `/context`, `/status` suportados

🚀 Instalação

1. Clone o Repositório

git clone <repository-url>
cd ai-shopping-assistant

2. Configure um Ambiente Virtual (Opcional)

python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

3. Instale as Dependências Python

pip install -r requirements.txt

4. Instale as Dependências Node.js do MCP

Certifique-se de que Node.js e npm estejam instalados:

npm install -g @playwright/mcp @openbnb/mcp-server-airbnb duckduckgo-mcp-server

5. Configuração do Ambiente

Crie um arquivo .env no diretório raiz:

echo "GROQ_API_KEY=your-api-key-here" > .env

6. Configuração do MCP

Certifique-se de ter um browser_mcp.json válido no seu diretório MCP (ex.: D:\mcp\mcpdemo\):

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    },
    "airbnb": {
      "command": "npx",
      "args": ["-y", "@openbnb/mcp-server-airbnb"]
    },
    "duckduckgo-search": {
      "command": "npx",
      "args": ["-y", "duckduckgo-mcp-server"]
    }
  }
}

Em shopping_assistant.py, defina:

self.config_file = r"path/to/your/browser_mcp.json"

🧠 Uso

Inicie o Assistente:

python shopping_assistant.py

Exemplos de Consultas:

🛒 You: Best laptop for programming under $1000  
🤖 Assistant: 🔍 Searching... (attempt 1/3)  
✅ Successfully retrieved current information  
[Laptop recommendations with specs and prices]

Comandos que Você Pode Usar:

exit ou quit – Encerrar a sessão
clear – Redefinir o histórico do chat
context – Ver o resumo recente da conversa
status – Verificar o horário da última busca e os limites de taxa

🗂️ Estrutura do Projeto

ai-shopping-assistant/
├── shopping_assistant.py      # Main assistant logic
├── requirements.txt           # Python dependencies
├── .env                       # Environment variables
├── browser_mcp.json           # MCP config for search engines
└── README.md                  # You're reading it!

📦 Requisitos

Adicione o seguinte ao seu requirements.txt:

langchain-grok==0.1.0
python-dotenv==1.0.0
requests==2.31.0
mcp-use==<latest-version>

⚙️ Detalhes de Configuração

Configuração	Descrição
🔑 GROQ_API_KEY	Defina em `.env` para acesso ao Grok da xAI
🕒 Limite de Taxa	Atraso de 3 segundos entre buscas na API
🔁 Repetições	Até 3 repetições de busca com espera de 5s
📁 Arquivo MCP	Configuração JSON para integração de busca
📦 Modelo	Padrão: `qwen-qwq-32b` (modelo Grok)
🛍️ Categorias	Eletrônicos, eletrodomésticos, serviços, roupas, casa

⚠️ Limitações

Requer conexão com a internet para API e busca MCP
Os preços podem variar—verifique com os varejistas
Apenas categorias predefinidas são suportadas
A configuração do MCP requer configuração adequada do Node.js
Fallbacks offline podem oferecer profundidade limitada

🔮 Melhorias Futuras

🛒 Extração de preços em tempo real dos principais varejistas online
🧬 Recomendações personalizadas por meio de perfis de usuário
🖥️ Interface web para uma experiência de usuário perfeita
🛠️ Integração MCP aprimorada com mais portais de compras

🤝 Contribuições

Contribuições são bem-vindas! Para contribuir:

Faça um fork do repositório
Crie sua branch de recurso
```
git checkout -b feature/your-feature
```
Faça commit das suas alterações
```
git commit -m "Add your feature"
```
Envie e abra um PR
```
git push origin feature/your-feature
```

Imagens:

1: 2: 3: 4: 5: 6:

🧠 IA + Compras = Escolhas Mais Inteligentes Comece agora sua jornada de compras inteligentes com o Assistente de Compras com IA.