deal-hunter/README.md

Dockerized Full-Stack FB Marketplace Deal Hunter

Quick Start

1. Set up environment variables:

   # Edit .env file with your API keys
   GROK_API_KEY=your_xai_key
   TELEGRAM_TOKEN=your_bot_token
   TELEGRAM_CHAT_ID=your_chat_id
   

2. Build and run:

   docker-compose up --build -d
   

3. Access the application:

   • Frontend: http://localhost:8501
   • Backend API: http://localhost:8000

Features

• Facebook Marketplace Scraping: Automatically searches for items
• Price Valuation: Compares with eBay sold listings
• AI-Powered Offers: Generates polite lowball offers using Grok AI
• Telegram Alerts: Sends hot deals directly to Telegram
• CSV Export: Download all deals as CSV
• Dockerized: Easy deployment with Docker Compose

API Usage

Test the backend directly:

curl -X POST http://localhost:8000/hunt \
  -H "Content-Type: application/json" \
  -d '{"item": "iPhone 15", "min_price": 0, "max_price": 1000}'

Configuration

• Edit search parameters in the Streamlit sidebar
• Adjust scoring thresholds for hot deals
• Customize Telegram notifications