BoPeng/ai-marketplace-monitor

AI Marketplace Monitor (AIMM)

What it does – AIMM is a Python‑based utility that automatically logs into Facebook Marketplace, searches for items you specify, and uses an LLM to evaluate each listing. It then sends you a notification (PushBullet, Telegram, email, etc.) with a short AI‑generated verdict like “Great deal; well‑priced camera with extra battery.”

Key components

• Browser automation – Powered by Playwright, AIMM drives a real browser to log in with your Facebook credentials, handle CAPTCHAs, and scrape listings.
• AI evaluation – Sends the title, description, price and seller info to an LLM (OpenAI, Anthropic, Gemini, DeepSeek, Ollama, or any model reachable through the UnitySVC gateway). The model returns a rating and a short justification.
• Seller reputation analysis – Looks at a seller’s account age, past listings, ratings and buyer reviews to flag new or suspicious accounts.
• Config‑by‑conversation – aimm configure walks you through setting up AI keys, Facebook credentials, items to watch, price limits, regions, and notification channels, writing a TOML config file for you.
• Web UI – A lightweight local web interface (http://127.0.0.1:8467) lets you edit the TOML, view live logs, see every evaluated listing with its AI rating, and control the monitor (pause/play).
• Notifications – Over 100 channels via UnitySVC or direct integrations (PushBullet, PushOver, Telegram, email, etc.). Supports instant alerts and a daily digest.
• Deploy anywhere – Install with pip, run directly, or use the official Docker image. The container includes a virtual display so it works on headless NAS, TrueNAS, Unraid, Synology, etc.

Typical workflow

1. Install the package (pip install ai-marketplace-monitor && playwright install).
2. Export your Facebook username/password and an AI key (or a UnitySVC key).
3. Run aimm configure – answer a few natural‑language prompts to define what you want to watch (e.g., “GoPro under $250 in Houston”).
4. Start the monitor with aimm (or docker run …).
5. AIMM logs in, searches at the interval you set, evaluates each new listing with the LLM, and pushes notifications.

Why it matters – It combines web‑automation, LLM‑based semantic filtering, and multi‑channel alerts to turn a noisy marketplace into a focused deal‑finder, all while running on modest home hardware.

Legal note – The README warns that automated scraping of Facebook Marketplace may violate Facebook’s terms; the tool is intended for personal, hobbyist use and the user is responsible for compliance.

---

Quick start snippet

pip install ai-marketplace-monitor
playwright install
export FACEBOOK_USERNAME='you@example.com'
export FACEBOOK_PASSWORD='secret'
export OPENAI_API_KEY='sk-…'   # or UNITYSVC_API_KEY
aimm configure   # walk through AI‑assisted setup
aimm              # start monitoring