ai-marketplace-monitor

ai-marketplace-monitor

Monitor facebook marketplace with AI

Stars: 66

Visit
 screenshot

An intelligent tool that monitors Facebook Marketplace listings using AI to help users find the best deals. It provides instant notifications when items matching specific criteria are posted, along with AI-powered analysis of each listing. The tool offers smart search capabilities, AI-powered listing evaluation and recommendations, various notification options, support for multiple locations, and customizable search parameters. Users can configure the tool to search for specific products, filter by price and location, and receive notifications through different channels. The tool also supports AI service providers and offers a self-hosted model option.

README:

AI Marketplace Monitor

PyPI - Version PyPI - Python Version Tests Codecov Read the Docs PyPI - License

Black pre-commit Contributor Covenant

An intelligent tool that monitors Facebook Marketplace listings using AI to help you find the best deals. Get instant notifications when items matching your criteria are posted, with AI-powered analysis of each listing.

📚 Read the Full Documentation

Search In Action

Example notification from PushBullet:

Found 1 new gopro from facebook
[Great deal (5)] Go Pro hero 12
$180, Houston, TX
https://facebook.com/marketplace/item/1234567890
AI: Great deal; A well-priced, well-maintained camera meets all search criteria, with extra battery and charger.

Table of Contents:

✨ Key Features

🔍 Smart Search

  • Search multiple products using keywords
  • Filter by price and location
  • Exclude irrelevant results and spammers
  • Support for different Facebook Marketplace layouts

🤖 AI-Powered

  • Intelligent listing evaluation
  • Smart recommendations
  • Multiple AI service providers supported
  • Self-hosted model option (Ollama)

📱 Notifications

  • PushBullet, PushOver, Telegram, or Ntfy notifications
  • HTML email notifications with images
  • Customizable notification levels
  • Repeated notification options

🌎 Location Support

  • Multi-city search
  • Pre-defined regions (USA, Canada, etc.)
  • Customizable search radius
  • Flexible seller location filtering

🚀 Quick Start

⚠️ Legal Notice: Facebook's EULA prohibits automated data collection without authorization. This tool was developed for personal, hobbyist use only. You are solely responsible for ensuring compliance with platform terms and applicable laws.

Installation

pip install ai-marketplace-monitor
playwright install

Basic Configuration

Create ~/.ai-marketplace-monitor/config.toml:

[marketplace.facebook]
search_city = 'houston'  # Replace with your city

[item.gopro]
search_phrases = 'Go Pro Hero 11'
min_price = 100
max_price = 300

[user.me]
pushbullet_token = 'your_token_here'  # Get from pushbullet.com

Run the Monitor

ai-marketplace-monitor

The program will open a browser, search Facebook Marketplace, and notify you of matching items.

💡 Example Usage

Find GoPro cameras under $300:

[item.gopro]
search_phrases = 'Go Pro Hero'
keywords = "('Go Pro' OR gopro) AND (11 OR 12 OR 13)"
min_price = 100
max_price = 300

Search nationwide with shipping:

[item.rare_item]
search_phrases = 'vintage collectible'
search_region = 'usa'
delivery_method = 'shipping'
seller_locations = []

AI-powered filtering:

[ai.openai]
api_key = 'your_openai_key'

[item.camera]
description = '''High-quality DSLR camera in good condition.
Exclude listings with water damage or missing parts.'''
rating = 4  # Only notify for 4+ star AI ratings

📚 Documentation

For detailed information on setup and advanced features, see the comprehensive documentation:

Key Topics Covered in Documentation

Notification Setup:

  • Email (SMTP), PushBullet, PushOver, Telegram, Ntfy
  • Multi-user configurations
  • HTML email templates

AI Integration:

  • OpenAI, DeepSeek, Ollama setup
  • Custom prompt configuration
  • Rating thresholds and filtering

Advanced Search:

  • Multi-city and region search
  • Currency conversion
  • Keyword filtering with Boolean logic
  • Proxy/anonymous searching

Configuration:

  • TOML file structure
  • Environment variables
  • Multiple marketplace support
  • Language/translation support

🤝 Contributing

Contributions are welcome! Here are some ways you can contribute:

  • 🐛 Report bugs and issues
  • 💡 Suggest new features
  • 🔧 Submit pull requests
  • 📚 Improve documentation
  • 🏪 Add support for new marketplaces
  • 🌍 Add support for new regions and languages
  • 🤖 Add support for new AI providers
  • 📱 Add new notification methods

Please read our Contributing Guidelines before submitting a Pull Request.

📜 License

This project is licensed under the Affero General Public License (AGPL). For the full terms and conditions, please refer to the official GNU AGPL v3.

💬 Support

We provide multiple ways to access support and contribute to AI Marketplace Monitor:

Important Note: Due to time constraints, priority support is provided to sponsors and donors. For general questions, please use the GitHub Discussions or Issues.

🙏 Credits

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for ai-marketplace-monitor

Similar Open Source Tools

For similar tasks

For similar jobs