ai-marketplace-monitor
Monitor facebook marketplace with AI
Science Score: 44.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (12.7%) to scientific vocabulary
Repository
Monitor facebook marketplace with AI
Basic Info
- Host: GitHub
- Owner: BoPeng
- License: agpl-3.0
- Language: HTML
- Default Branch: main
- Size: 2.86 MB
Statistics
- Stars: 49
- Watchers: 4
- Forks: 13
- Open Issues: 17
- Releases: 0
Metadata Files
README.md
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.
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
- 🚀 Quick Start
- 💡 Example Usage
- 📚 Documentation
- 🤝 Contributing
- 📜 License
- 💬 Support
- 🙏 Credits
✨ 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
bash
pip install ai-marketplace-monitor
playwright install
Basic Configuration
Create ~/.ai-marketplace-monitor/config.toml:
```toml [marketplace.facebook] search_city = 'houston' # Replace with your city
[item.gopro] searchphrases = 'Go Pro Hero 11' minprice = 100 max_price = 300
[user.me] pushbullettoken = 'yourtoken_here' # Get from pushbullet.com ```
Run the Monitor
bash
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:
toml
[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:
toml
[item.rare_item]
search_phrases = 'vintage collectible'
search_region = 'usa'
delivery_method = 'shipping'
seller_locations = []
AI-powered filtering:
```toml [ai.openai] apikey = 'youropenai_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:
- 📖 Full Documentation - Complete guide and reference
- 🚀 Quick Start Guide - Get up and running in 10 minutes
- 🔍 Features Overview - Complete feature list
- 📱 Usage Guide - Command-line options and tips
- 🔧 Configuration Guide - Notifications, AI prompts, multi-location search
- ⚙️ Configuration Reference - Complete configuration reference
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:
- 📖 Documentation - Comprehensive guides and instructions
- 🤝 Discussions - Community support and ideas
- 🐛 Issues - Bug reports and feature requests
- 💖 Become a sponsor - Support development
- 💰 Donate via PayPal - Alternative donation method
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
- Some of the code was copied from facebook-marketplace-scraper.
- Region definitions were copied from facebook-marketplace-nationwide, which is released under an MIT license as of Jan 2025.
- This package was created with Cookiecutter and the cookiecutter-modern-pypackage project template.
Owner
- Name: Bo
- Login: BoPeng
- Kind: user
- Location: Houston, TX, USA
- Company: Baylor College of Medicine
- Website: http://bioworkflows.com
- Repositories: 2
- Profile: https://github.com/BoPeng
Citation (CITATION.cff)
# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!
cff-version: 1.2.0
title: AI Marketplace Monitor
message: >-
If you use this software, please cite it using the
metadata from this file.
type: software
authors:
- given-names: Bo
family-names: Peng
alias: fedejaure
identifiers:
- type: url
value: >-
https://github.com/BoPeng/ai-marketplace-monitor/releases/tag/v0.1.0
description: The Software Heritage link for version 0.1.0.
repository-code: 'https://github.com/BoPeng/ai-marketplace-monitor'
abstract: An AI-based tool for monitoring facebook marketplace
keywords:
- ai-marketplace-monitor
license: MIT
version: 0.1.0
GitHub Events
Total
- Issues event: 96
- Watch event: 52
- Delete event: 130
- Issue comment event: 193
- Push event: 447
- Pull request review comment event: 39
- Pull request review event: 36
- Pull request event: 295
- Fork event: 13
- Create event: 139
Last Year
- Issues event: 96
- Watch event: 52
- Delete event: 130
- Issue comment event: 193
- Push event: 447
- Pull request review comment event: 39
- Pull request review event: 36
- Pull request event: 295
- Fork event: 13
- Create event: 139
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 51
- Total pull requests: 171
- Average time to close issues: 7 days
- Average time to close pull requests: 3 days
- Total issue authors: 17
- Total pull request authors: 7
- Average comments per issue: 1.33
- Average comments per pull request: 0.22
- Merged pull requests: 75
- Bot issues: 0
- Bot pull requests: 129
Past Year
- Issues: 51
- Pull requests: 171
- Average time to close issues: 7 days
- Average time to close pull requests: 3 days
- Issue authors: 17
- Pull request authors: 7
- Average comments per issue: 1.33
- Average comments per pull request: 0.22
- Merged pull requests: 75
- Bot issues: 0
- Bot pull requests: 129
Top Authors
Issue Authors
- BoPeng (24)
- EddyGomezz (5)
- adawalli (4)
- FredlandSupplyCompany (2)
- pdiac (2)
- marcelv73 (2)
- blam6 (2)
- thed1ceman (1)
- lkraskov (1)
- WindowsAurora (1)
- Desmoire87 (1)
- spawnpoint (1)
- yubaix (1)
- AditiShelke (1)
- devival (1)
Pull Request Authors
- dependabot[bot] (125)
- BoPeng (29)
- adawalli (5)
- spawnpoint (2)
- Bradzie (1)
- blam6 (1)
- Detrol (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 306 last-month
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 65
- Total maintainers: 1
pypi.org: ai-marketplace-monitor
An AI-based tool for monitoring facebook marketplace
- Homepage: https://github.com/BoPeng/ai-marketplace-monitor
- Documentation: https://ai-marketplace-monitor.readthedocs.io
- License: GNU Affero General Public License v3
-
Latest release: 0.9.8
published 7 months ago
Rankings
Maintainers (1)
Dependencies
- actions/checkout v4.2.2 composite
- github/codeql-action/analyze v3 composite
- github/codeql-action/autobuild v3 composite
- github/codeql-action/init v3 composite
- actions/checkout v4.2.2 composite
- actions/setup-python v5.3.0 composite
- peter-evans/create-pull-request v7.0.5 composite
- actions/checkout v4.2.2 composite
- actions/create-release v1.1.4 composite
- actions/setup-python v5.3.0 composite
- mindsers/changelog-reader-action v2.2.3 composite
- pypa/gh-action-pypi-publish v1.8.11 composite
- actions/checkout v4.2.2 composite
- actions/download-artifact v4.1.8 composite
- actions/setup-python v5.3.0 composite
- actions/upload-artifact v4.4.3 composite
- codecov/codecov-action v4.4.1 composite
- recommonmark ==0.7.1
- sphinx ==7.4.7
- alabaster 0.7.16
- annotated-types 0.7.0
- authlib 1.4.0
- babel 2.16.0
- beautifulsoup4 4.12.3
- black 24.10.0
- bump2version 1.0.1
- certifi 2024.12.14
- cffi 1.17.1
- cfgv 3.4.0
- charset-normalizer 3.4.1
- click 8.1.8
- colorama 0.4.6
- commonmark 0.9.1
- coverage 7.6.10
- cryptography 43.0.3
- distlib 0.3.9
- docutils 0.21.2
- dparse 0.6.4
- exceptiongroup 1.2.2
- filelock 3.16.1
- greenlet 3.1.1
- identify 2.6.5
- idna 3.10
- imagesize 1.4.1
- importlib-metadata 8.5.0
- iniconfig 2.0.0
- invoke 2.2.0
- isort 5.13.2
- jinja2 3.1.5
- markdown-it-py 3.0.0
- markupsafe 3.0.2
- marshmallow 3.25.1
- mdurl 0.1.2
- mypy 1.14.1
- mypy-extensions 1.0.0
- nodeenv 1.9.1
- packaging 24.2
- pathspec 0.12.1
- platformdirs 4.3.6
- playwright 1.49.1
- pluggy 1.5.0
- pre-commit 4.1.0
- psutil 6.1.1
- pushbullet-py 0.12.0
- pycparser 2.22
- pydantic 2.9.2
- pydantic-core 2.23.4
- pyee 12.0.0
- pygments 2.19.1
- pytest 8.3.4
- pytest-cov 6.0.0
- python-magic 0.4.27
- pyyaml 6.0.2
- recommonmark 0.7.1
- requests 2.32.3
- rich 13.9.4
- ruamel-yaml 0.18.10
- ruamel-yaml-clib 0.2.12
- ruff 0.7.4
- safety 3.2.14
- safety-schemas 0.0.10
- setuptools 75.8.0
- shellingham 1.5.4
- snowballstemmer 2.2.0
- soupsieve 2.6
- sphinx 7.4.7
- sphinxcontrib-applehelp 2.0.0
- sphinxcontrib-devhelp 2.0.0
- sphinxcontrib-htmlhelp 2.1.0
- sphinxcontrib-jsmath 1.0.1
- sphinxcontrib-qthelp 2.0.0
- sphinxcontrib-serializinghtml 2.0.0
- tomli 2.2.1
- typer 0.13.1
- typing-extensions 4.12.2
- urllib3 2.3.0
- virtualenv 20.29.1
- watchdog 6.0.0
- websocket-client 1.8.0
- xdoctest 1.2.0
- zipp 3.21.0
- bump2version ^1.0.1 develop
- invoke ^2.2.0 develop
- pre-commit ^4.0.1 develop
- watchdog ^6.0.0 develop
- recommonmark ^0.7.1 docs
- sphinx ^7.4.7 docs
- black ^24.10.0 linters
- isort ^5.13.2 linters
- ruff ^0.7.4 linters
- beautifulsoup4 ^4.12.3
- playwright ^1.49.1
- pushbullet.py ^0.12.0
- python <3.13,>=3.9
- rich ^13.9.4
- typer ^0.13.0
- safety ^3.2.11 security
- coverage ^7.6.7 test
- pytest ^8.3.3 test
- pytest-cov ^6.0.0 test
- xdoctest ^1.2.0 test
- mypy ^1.13.0 typing