{"passport":{"unfragile":{"@version":"1.0","version":"2026-05","artifact":{"id":"awesome-facebook-ads-library","slug":"facebook-ads-library","name":"Facebook Ads Library","type":"mcp","url":"https://github.com/trypeggy/facebook-ads-library-mcp","page_url":"https://unfragile.ai/facebook-ads-library","categories":["mcp-servers"],"tags":[],"pricing":{"model":"open_source","free":true,"starting_price":null},"status":"active","verified":false},"capabilities":[{"id":"awesome-facebook-ads-library__cap_0","uri":"capability://search.retrieval.facebook.ads.library.semantic.search.with.natural.language.queries","name":"facebook ads library semantic search with natural language queries","description":"Enables users to query the Facebook Ads Library using natural language questions rather than structured filters, translating user intent into API calls against Meta's ad transparency database. The MCP server acts as a semantic intermediary, parsing conversational queries and mapping them to the underlying Ads Library API endpoints, supporting ad discovery across advertiser names, creative content, targeting parameters, and campaign messaging.","intents":["I want to find all ads from a specific advertiser without knowing their exact account ID","Show me what messaging competitors are using in their current ad campaigns","Find ads targeting a specific demographic or interest category","Search for ads containing specific keywords or creative themes across all advertisers"],"best_for":["Marketing researchers conducting competitive intelligence on ad strategies","Political campaign analysts tracking messaging and spending patterns","Brand safety teams monitoring unauthorized use of brand assets in ads","Ad platform auditors and transparency advocates"],"limitations":["Queries are limited to publicly available ads in the Facebook Ads Library — private or paused campaigns are not accessible","Search latency depends on Ads Library API response times, typically 2-5 seconds per query","Natural language parsing may misinterpret complex multi-part queries with conflicting filters","Results are paginated and may require multiple requests for comprehensive dataset retrieval"],"requires":["MCP client compatible with stdio transport (Claude Desktop, custom MCP hosts)","Network access to Meta's Facebook Ads Library API endpoints","Understanding of Ads Library data schema (advertiser names, ad IDs, creation dates)"],"input_types":["natural language text queries","advertiser names or identifiers","keyword phrases for creative content"],"output_types":["structured JSON with ad metadata","advertiser profiles with ad counts","creative asset details and messaging text"],"categories":["search-retrieval","tool-use-integration"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-facebook-ads-library__cap_1","uri":"capability://data.processing.analysis.ad.creative.comparison.and.analysis.across.campaigns","name":"ad creative comparison and analysis across campaigns","description":"Retrieves and structures ad creative assets (images, video thumbnails, copy) from multiple campaigns or advertisers, enabling side-by-side comparison of messaging strategies, visual design patterns, and targeting approaches. The capability aggregates creative metadata and asset URLs from the Ads Library API, formatting results for easy comparative analysis of what messaging resonates with different audience segments.","intents":["Compare the creative strategies used by competing brands in the same product category","Analyze how a single advertiser tests different messaging variations across audience segments","Identify common visual design patterns or color schemes in high-performing ads within an industry","Extract copy variations to understand A/B testing strategies used by major advertisers"],"best_for":["Creative directors and copywriters researching industry benchmarks and successful ad formats","Marketing strategists building competitive positioning and messaging frameworks","UX/design teams analyzing visual trends in digital advertising","Academic researchers studying advertising effectiveness and creative optimization"],"limitations":["Creative assets are limited to what Meta has indexed and made publicly available in the Ads Library","Video ads are represented as thumbnails or metadata only — full video playback requires external access","Comparison is limited to ads currently active or recently archived in the Ads Library (typically 30-90 days)","No built-in statistical analysis of creative performance — only metadata and asset retrieval"],"requires":["MCP client with file/image rendering capabilities for visual comparison","Access to multiple ad records from the Ads Library (requires prior search queries)","Understanding of ad creative metadata schema (impressions, spend, targeting)"],"input_types":["advertiser identifiers or campaign IDs","ad creative asset URLs from Ads Library","targeting parameter filters"],"output_types":["structured JSON with creative metadata","image/video asset URLs and thumbnails","copy text and messaging variations","targeting and demographic breakdowns"],"categories":["data-processing-analysis","search-retrieval"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-facebook-ads-library__cap_2","uri":"capability://data.processing.analysis.advertiser.profile.and.spending.pattern.research","name":"advertiser profile and spending pattern research","description":"Retrieves aggregated advertiser metadata from the Facebook Ads Library including ad spend estimates, active campaign counts, targeting strategies, and historical ad activity. The MCP server queries the Ads Library API to build comprehensive advertiser profiles, exposing patterns in spending, creative frequency, and audience targeting that reveal strategic priorities and budget allocation across different market segments.","intents":["I need to understand how much a competitor is spending on ads and where their budget is allocated","Show me all active advertisers in a specific industry or category","Find advertisers targeting a particular demographic or interest to understand market saturation","Track changes in an advertiser's ad volume and messaging over time"],"best_for":["Competitive intelligence analysts building advertiser profiles and market share estimates","Media buyers evaluating market competition and audience availability","Political campaign strategists tracking spending and messaging from opposing campaigns","Regulatory and compliance teams monitoring advertiser activity for violations"],"limitations":["Spend estimates are approximations based on Meta's public methodology — exact spend figures are not disclosed","Historical data is limited to ads currently indexed in the Ads Library (not full historical archive)","Advertiser identification relies on Meta's account verification — some small or new advertisers may not be indexed","Targeting data is inferred from ad metadata and may not reflect the full targeting strategy used by the advertiser"],"requires":["MCP client with data aggregation and filtering capabilities","Advertiser name or identifier from Facebook Ads Library","Understanding of Ads Library spend estimation methodology"],"input_types":["advertiser names or business identifiers","industry or category filters","date ranges for historical queries"],"output_types":["advertiser profile JSON with metadata","estimated spend and budget allocation","active ad counts and creative frequency","targeting strategy summaries"],"categories":["data-processing-analysis","search-retrieval"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-facebook-ads-library__cap_3","uri":"capability://data.processing.analysis.multi.advertiser.messaging.and.targeting.comparison","name":"multi-advertiser messaging and targeting comparison","description":"Enables comparative analysis of how multiple advertisers in the same category approach audience targeting, messaging tone, and creative strategy. The capability retrieves ad records for specified advertisers and structures them for side-by-side comparison, highlighting differences in targeting parameters (age, location, interests), messaging themes, and creative formats used to reach overlapping audience segments.","intents":["Compare how different political candidates are messaging to the same voter demographics","Analyze how multiple e-commerce brands target the same customer interests with different creative approaches","Identify gaps in messaging or audience coverage that competitors are not addressing","Understand how different brands position themselves to the same audience segment"],"best_for":["Strategic planners developing differentiated messaging and positioning strategies","Political campaign managers analyzing opponent messaging and targeting tactics","Brand strategists identifying market positioning opportunities and competitive gaps","Market researchers studying how different brands approach the same customer segment"],"limitations":["Comparison is limited to advertisers with active ads in the Ads Library — inactive or paused campaigns are not included","Targeting inference is based on ad metadata and may not capture the full targeting logic used by advertisers","Messaging analysis is limited to text and creative assets visible in the Ads Library — landing page content is not analyzed","Comparison requires manual specification of advertisers — no automatic competitor identification"],"requires":["MCP client with structured data comparison and visualization capabilities","Identifiers for 2+ advertisers to compare","Understanding of targeting parameter schema (interests, demographics, locations)"],"input_types":["advertiser names or identifiers (2+ required)","audience segment or demographic filters","date ranges for comparison"],"output_types":["structured JSON with parallel advertiser data","targeting parameter comparisons","messaging theme analysis","creative format breakdowns"],"categories":["data-processing-analysis","planning-reasoning"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-facebook-ads-library__cap_4","uri":"capability://planning.reasoning.deep.research.synthesis.and.insight.generation.from.ad.data","name":"deep research synthesis and insight generation from ad data","description":"Leverages Claude's reasoning capabilities to synthesize patterns and insights from multiple ad records retrieved from the Facebook Ads Library, generating strategic recommendations based on observed messaging strategies, targeting patterns, and creative approaches. The MCP server retrieves raw ad data, and Claude applies chain-of-thought reasoning to identify trends, gaps, and opportunities in advertiser strategies.","intents":["Generate a strategic analysis of how competitors are positioning their products to my target audience","Identify emerging messaging themes or creative trends in my industry based on current ad campaigns","Recommend messaging angles or targeting strategies based on what competitors are testing","Synthesize insights from competitor ads to inform my own campaign strategy"],"best_for":["Strategic marketers seeking data-driven insights to inform campaign planning","Product managers analyzing competitive positioning and market messaging trends","Campaign strategists developing messaging frameworks based on competitor analysis","Researchers studying advertising trends and strategic patterns in specific industries"],"limitations":["Insights are limited to observable ad data — underlying performance metrics (CTR, conversion rate) are not available","Analysis quality depends on the volume and diversity of ads retrieved — sparse data may lead to incomplete insights","Recommendations are based on observed patterns, not causal analysis — correlation does not imply effectiveness","Synthesis requires multiple API calls and may incur latency for large-scale analysis"],"requires":["Claude with extended reasoning capabilities (Claude 3.5+)","Multiple ad records from the Facebook Ads Library (typically 10+ for meaningful pattern analysis)","MCP client with streaming support for long-form reasoning output"],"input_types":["advertiser identifiers or campaign filters","industry or category context","strategic questions or analysis prompts"],"output_types":["strategic analysis and insights","pattern summaries and trend identification","recommendations for messaging or targeting","competitive positioning analysis"],"categories":["planning-reasoning","data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-facebook-ads-library__cap_5","uri":"capability://tool.use.integration.real.time.ad.library.data.retrieval.and.caching","name":"real-time ad library data retrieval and caching","description":"Implements MCP protocol handlers that query the Facebook Ads Library API in real-time, retrieving current ad records and caching results to optimize repeated queries. The server manages API rate limiting, pagination, and error handling, exposing a clean tool interface to Claude for ad data access while abstracting away the complexity of direct API integration and authentication.","intents":["I want to search the Facebook Ads Library without managing API keys or authentication","Retrieve fresh ad data for multiple queries without hitting rate limits","Access paginated ad results without manually handling pagination logic","Get structured, normalized ad data from the Ads Library API"],"best_for":["Claude users conducting ad research without direct API access","Teams deploying MCP servers to centralize ad research capabilities","Researchers needing reliable, rate-limited access to the Ads Library API","Organizations building ad intelligence workflows on top of Claude"],"limitations":["API rate limits are enforced by Meta and may throttle high-volume queries","Caching is in-memory and does not persist across server restarts","Real-time data is subject to Meta's Ads Library indexing lag (typically 24-48 hours)","Authentication is handled server-side — users cannot customize API credentials"],"requires":["MCP client compatible with stdio transport (Claude Desktop, custom MCP hosts)","Network access to Meta's Facebook Ads Library API","Server-side API credentials or access token for the Ads Library API"],"input_types":["search queries (advertiser names, keywords)","filter parameters (date ranges, categories)","pagination parameters"],"output_types":["structured JSON ad records","paginated result sets","error messages and status codes"],"categories":["tool-use-integration","search-retrieval"],"confidence":0.5,"matches":0,"success_rate":0}],"trust":{"score":28,"verified":false,"data_access_risk":"high","permissions":["MCP client compatible with stdio transport (Claude Desktop, custom MCP hosts)","Network access to Meta's Facebook Ads Library API endpoints","Understanding of Ads Library data schema (advertiser names, ad IDs, creation dates)","MCP client with file/image rendering capabilities for visual comparison","Access to multiple ad records from the Ads Library (requires prior search queries)","Understanding of ad creative metadata schema (impressions, spend, targeting)","MCP client with data aggregation and filtering capabilities","Advertiser name or identifier from Facebook Ads Library","Understanding of Ads Library spend estimation methodology","MCP client with structured data comparison and visualization capabilities"],"failure_modes":["Queries are limited to publicly available ads in the Facebook Ads Library — private or paused campaigns are not accessible","Search latency depends on Ads Library API response times, typically 2-5 seconds per query","Natural language parsing may misinterpret complex multi-part queries with conflicting filters","Results are paginated and may require multiple requests for comprehensive dataset retrieval","Creative assets are limited to what Meta has indexed and made publicly available in the Ads Library","Video ads are represented as thumbnails or metadata only — full video playback requires external access","Comparison is limited to ads currently active or recently archived in the Ads Library (typically 30-90 days)","No built-in statistical analysis of creative performance — only metadata and asset retrieval","Spend estimates are approximations based on Meta's public methodology — exact spend figures are not disclosed","Historical data is limited to ads currently indexed in the Ads Library (not full historical archive)","builder identity is not verified yet","no observed match outcomes yet"],"rank_breakdown":{"adoption":0.05,"quality":0.37,"ecosystem":0.39999999999999997,"match_graph":0.25,"freshness":0.52,"weights":{"adoption":0.25,"quality":0.25,"ecosystem":0.15,"match_graph":0.23,"freshness":0.12}},"observed_outcomes":{"matches":0,"success_rate":0,"avg_confidence":0,"top_intents":[],"last_matched_at":null},"maintenance":{"status":"active","updated_at":"2026-06-17T09:51:03.039Z","last_scraped_at":"2026-05-03T14:00:15.503Z","last_commit":null},"community":{"stars":null,"forks":null,"weekly_downloads":null,"model_downloads":null,"model_likes":null}},"distribution":{"claim_url":"https://unfragile.ai/submit?claim=facebook-ads-library","compare_url":"https://unfragile.ai/compare?artifact=facebook-ads-library"}},"signature":"nK8C0ClPcLLTFKOZqqanyu5Vb0qpUnn8YehFfPUjUJQAlDwCepi+0a5VySxsQTpaDzElnj0FaGRorJ/8kGhxCw==","signedAt":"2026-06-20T22:40:11.233Z","signedBy":"unfragile.ai","version":1},"_links":{"self":"https://unfragile.ai/api/v1/passport/facebook-ads-library","artifact":"https://unfragile.ai/facebook-ads-library","verify":"https://unfragile.ai/api/v1/verify?slug=facebook-ads-library","publicKey":"https://unfragile.ai/api/v1/trust-passport-public-key","spec":"https://unfragile.ai/trust","schema":"https://unfragile.ai/schema.json","docs":"https://unfragile.ai/docs"}}