get_meta_platform_idLABSCO SUMMARY
Competitor ad research that ends in the creative, not just the count.
Most ad-library tooling stops at how many ads are live. This one reads the creative itself - the messaging in an image, the pacing of a video - and caches what it has already looked at, so comparing four brands in one question is a normal request rather than an expensive one.
What it is
A server over the Facebook Ads Library. You name a brand, it resolves the platform ID, pulls the ads that page is currently running, and can read the image and video creative back as structured analysis.
What you get
- Resolve one or many brand names to their Meta platform IDs in a single call
- Retrieve the ads running for one or several pages at once
- Analyse an ad image for visual elements, on-image text, colours and composition
- Analyse ad video, one at a time or several in one batched call
- Search media you already analysed by brand, colour, people or media type
- Inspect and clear the local media cache when it grows
Requirements
Self-hosting needs Python 3.12+ and an ads-data API key in SCRAPECREATORS_API_KEY; video analysis additionally needs a Google Gemini key in GEMINI_API_KEY. The install script creates the virtualenv and the .env for you. A hosted version at useproxy.dev skips both keys.
Setup effort
Build from source — git clone https://github.com/proxy-intell/facebook-ads-library-mcp.git
USE CASES
01
Comparing how rivals are positioning themselves
Resolve several brands at once, pull each one's live ads, then read the messaging across all of them in a single pass.
02
Working out what a video campaign is doing
Send the video ads through the batch analyser to get storytelling, pacing and brand-message notes without watching each one.
03
Checking image ads for a visual pattern
Analyse the image creative for colour, layout and on-image copy, then search back through what you already analysed to spot the repeats.
04
Keeping the cache from filling the disk
Read the cache statistics, then clear the old media once the analysis is done.
8 tools
Listed in project docs. Your client may show a different list.
get_meta_adsanalyze_ad_imageanalyze_ad_videoanalyze_ad_videos_batchget_cache_statssearch_cached_mediacleanup_media_cacheBEFORE YOU INSTALL
What to know first
Tools you get
8 tools named in the project's documentation.
Requires
- Python 3.12+
- SCRAPECREATORS_API_KEY in your environment
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/proxy-intell/facebook-ads-library-mcp.git
cd facebook-ads-library-mcp
./install.shOn Windows, run install.bat instead of ./install.sh
Edit the .env file the script created and set SCRAPECREATORS_API_KEY (a Gemini key is only needed for video analysis)
Add the MCP configuration the install script prints to Claude Desktop or Cursor, then restart it
