Summary This project offers an AI-powered tool for monitoring Facebook Marketplace, designed to help users find the best deals. It automates searching, filters results intelligently, and provides instant notifications for items matching criteria, enhanced by AI analysis of listing quality and value.

How It Works The monitor scrapes Facebook Marketplace listings based on configurable search parameters. It integrates with multiple AI services (OpenAI, Anthropic/Claude, DeepSeek, Ollama) to evaluate listing descriptions, prices, and conditions, providing a "smart recommendation" score. This AI analysis helps filter spam and identify good deals, offering an advantage over manual searching. Notifications are customizable and delivered via various platforms.

Quick Start & Requirements Installation: pip install ai-marketplace-monitor. Requires Python 3.10+ and Playwright (playwright install). A Docker image is available, bundling dependencies and offering a web UI for CAPTCHA management. Basic configuration involves creating ~/.ai-marketplace-monitor/config.toml. Run with ai-marketplace-monitor. Documentation: https://ai-marketplace-monitor.readthedocs.io/.

Highlighted Details

• AI Integration: Supports OpenAI, Anthropic/Claude, DeepSeek, and Ollama, with a self-hosted Ollama option.
• Web UI: Built-in interface for real-time config editing and log monitoring.
• Notifications: Flexible options via PushBullet, PushOver, Telegram, Ntfy, and HTML email.
• Advanced Filtering: Supports multi-city searches, price ranges, keyword exclusion, and delivery methods.
• Docker: Image includes noVNC for interactive CAPTCHA solving.

Maintenance & Community Community contributions are encouraged via GitHub Discussions and Issues. Priority support is available for sponsors and donors.

Licensing & Compatibility Licensed under GNU Affero General Public License v3 (AGPL v3). This strong copyleft license requires derivative works to be open-sourced under the same terms, potentially impacting integration with closed-source applications.

Limitations & Caveats A critical legal notice states Facebook's EULA prohibits unauthorized automated data collection; the tool is for personal, hobbyist use only. Users are responsible for compliance with platform terms and laws. Reliance on Facebook's marketplace structure may lead to breakage if the platform's layout changes.