🔥 Facebook Ads Library MCP - Advanced Intelligence Platform
The most powerful Facebook Ads Library MCP server with 15+ advanced tools for competitive intelligence, market analysis, and advertising insights. Built with FastMCP and completely FREE.
🌟 Why This MCP?
Beats paid services like ScrapeCreators ($497/month) with:
- ✅ 15+ Advanced Tools vs their 5-6 basic ones
- ✅ AI-Powered Creative Analysis (they don't have this)
- ✅ ML Performance Prediction (they don't have this)
- ✅ Direct API Access (no proxy limitations)
- ✅ 100% Free & Open Source (vs $497/month)
- ✅ Complete Customization (add your own features)
🚀 Quick Start
1. Installation
git clone https://github.com/RamsesAguirre777/facebook-ads-library-mcp.git
cd facebook-ads-library-mcp
pip install -r requirements.txt
2. Get Facebook Access Token
- Go to Facebook Graph API Explorer
- Generate access token with
ads_readpermission - (Optional) Extend token to 60 days
3. Configure Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"facebook_ads": {
"command": "python",
"args": [
"/path/to/facebook-ads-library-mcp/facebook_ads_mcp_complete.py",
"--facebook-token",
"YOUR_FACEBOOK_ACCESS_TOKEN"
]
}
}
}
4. Restart Claude Desktop
🛠️ 15+ Advanced Tools
🔍 Search & Discovery
search_facebook_ads()- Advanced search with multiple filtersdiscover_competitor_brands()- Find industry competitors automaticallyfind_similar_advertisers()- Discover brands with similar strategies
📊 Deep Analysis
analyze_ad_creative_elements()- AI-powered creative analysisanalyze_ad_performance_metrics()- Performance insights & KPIsanalyze_ad_targeting_insights()- Audience targeting analysis
🎯 Monitoring & Tracking
monitor_brand_ad_changes()- Real-time campaign monitoringtrack_ad_spend_estimation()- Budget tracking & estimation
🏆 Competitive Intelligence
competitive_ad_analysis()- Multi-brand strategy comparisonbenchmark_against_industry()- Industry benchmarkingidentify_market_opportunities()- Market gap analysis
🔮 Prediction & Optimization
predict_ad_performance()- ML-powered performance predictiongenerate_facebook_intelligence_report()- Comprehensive reports
🛠️ Utilities
export_facebook_ads_data()- Export in JSON/CSV/Markdown
💡 Usage Examples
Basic Competitive Analysis
# In Claude Desktop
"Analyze Nike's current Facebook advertising strategy"
"Compare ad strategies between Tesla and BMW"
"Generate a complete intelligence report for Airbnb"
Advanced Market Research
# Discover competitors
"Find all fitness app companies advertising on Facebook"
# Market opportunities
"Identify advertising gaps in the fintech industry"
# Performance prediction
"Predict performance for this ad: 'Get fit in 30 days with our AI trainer'"
Monitoring & Alerts
# Track competitor changes
"Monitor Apple for new ad campaigns and alert me if they launch 5+ new ads"
# Spend tracking
"Estimate Shopify's monthly Facebook ad spend"
🔧 Advanced Configuration
Environment Variables
# Create .env file
echo "FACEBOOK_ACCESS_TOKEN=your_token_here" > .env
Multiple Regions
{
"mcpServers": {
"facebook_ads_us": {
"command": "python",
"args": ["facebook_ads_mcp_complete.py", "--facebook-token", "US_TOKEN"]
},
"facebook_ads_eu": {
"command": "python",
"args": ["facebook_ads_mcp_complete.py", "--facebook-token", "EU_TOKEN"]
}
}
}
📈 Performance Comparison
| Feature | ScrapeCreators | Our MCP | Savings |
|---|---|---|---|
| Monthly Cost | $497 | $0 | $497/month |
| Facebook Tools | 5-6 basic | 15+ advanced | 3x more |
| Creative Analysis | ❌ | ✅ AI-powered | Exclusive |
| Performance Prediction | ❌ | ✅ ML-based | Exclusive |
| Rate Limits | Restricted | Direct API | Unlimited |
| Customization | ❌ | ✅ Full control | Infinite |
🏗️ Architecture
Facebook Ads Library MCP
├── Core API Wrapper
│ ├── Authentication & Rate Limiting
│ └── Error Handling & Retry Logic
├── Search & Discovery Engine
│ ├── Advanced Filtering
│ └── Competitor Discovery
├── AI Analysis Engine
│ ├── Creative Element Analysis
│ └── Performance Prediction
├── Monitoring System
│ ├── Real-time Change Detection
│ └── Alert System
└── Export & Reporting
├── Multiple Format Support
└── Executive Reports
🔒 Security & Privacy
- No Data Storage - All data processed in real-time
- Direct API Access - No proxy servers or data logging
- Open Source - Complete transparency
- Local Processing - Your data stays on your machine
🤝 Contributing
We welcome contributions! Please see our Contributing Guide for details.
Development Setup
git clone https://github.com/RamsesAguirre777/facebook-ads-library-mcp.git
cd facebook-ads-library-mcp
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements-dev.txt
📖 Documentation
- Setup Guide - Detailed installation instructions
- API Reference - Complete tool documentation
- Examples - Real-world use cases
- Troubleshooting - Common issues & solutions
🔄 Changelog
See CHANGELOG.md for detailed version history.
🆘 Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: ramses.aguirre777@email.com
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
- FastMCP for the excellent MCP framework
- Crawl4AI for AI-powered web crawling
- Facebook Graph API for providing access to ads data
⭐ Star History
Metadata
Release files for iflow-mcp_ramsesaguirre777-facebook-ads-library-mcp 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_ramsesaguirre777_facebook_ads_library_mcp-1.0.0.tar.gz | 10.8 kB | Without provenance | Details for iflow_mcp_ramsesaguirre777_facebook_ads_library_mcp-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_ramsesaguirre777_facebook_ads_library_mcp-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_ramsesaguirre777_facebook_ads_library_mcp-1.0.0-py3-none-any.whl |
Total release size: 32.1 kB
Release files / iflow_mcp_ramsesaguirre777_facebook_ads_library_mcp-1.0.0.tar.gz
| Download URL | iflow_mcp_ramsesaguirre777_facebook_ads_library_mcp-1.0.0.tar.gz |
|---|---|
| Size | 10.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6196dc411abc8028b20e548cc0d93865725291a5c4c4d234faaffc1bfcf6ad76
|
|
BLAKE2b-256 checksum How to use checksums |
b70fcd1c7ce01cb5c0ee6eed0a8b15afda42d9fdebedd89138bc833e49f3ecce
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_ramsesaguirre777_facebook_ads_library_mcp-1.0.0-py3-none-any.whl
| Download URL | iflow_mcp_ramsesaguirre777_facebook_ads_library_mcp-1.0.0-py3-none-any.whl |
|---|---|
| Size | 21.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b859c813b54efa199b936819abbba44c9403d09849a81ad275c90e9fd159a173
|
|
BLAKE2b-256 checksum How to use checksums |
1137792c398add2aebe6d4165838b5dbba44ecb033588c237fd2ba74a955e077
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_ramsesaguirre777-facebook-ads-library-mcp 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.