{"id":"proxy-intell-facebook-ads-library-mcp","name":"facebook-ads-library-mcp","homepage":"https://useproxy.dev/","repo_url":"https://github.com/proxy-intell/facebook-ads-library-mcp","category":"ai-ml","subcategories":[],"tags":["mcp","facebook","ads-library","marketing-analytics","python","ai-analysis","caching","batch-processing"],"what_it_does":"Provides a Model Context Protocol (MCP) server that lets an AI agent search and retrieve information from Facebook’s public Ads Library by brand/page (via ScrapeCreators), and optionally analyze ad images/videos (video analysis via Google Gemini). Includes caching, request deduplication, and batch-oriented tools for platform IDs, ad retrieval, and (for videos) batched analysis.","use_cases":["Find how many ads a brand is currently running and split by creatives (video vs image)","Summarize current ad messaging/themes for a specific company or brand","Compare advertising strategies across multiple brands","Perform creative analysis of ad images (composition, colors, text elements)","Perform creative/insight analysis of ad videos using Gemini","Cache reuse and media cache inspection/cleanup to reduce repeated work"],"not_for":["Using Facebook/Ads Library data for purposes that violate platform terms, privacy expectations, or applicable laws","Automated large-scale extraction without rate-limit/credit management controls","Replacing human legal/brand compliance review when producing marketing conclusions"],"best_when":"You need agent-driven, programmatic access to Ads Library results plus optional LLM-based creative analysis, and you can provide the required ScrapeCreators (and optionally Gemini) API keys.","avoid_when":"You need a turnkey hosted API with no local configuration, or you cannot manage external API credits/rate limits, or you require formal SDK/OpenAPI contracts for strict integration.","alternatives":["Use ScrapeCreators (or equivalent) directly with your own backend and analysis pipeline","Manually query Facebook Ads Library in a script and perform separate image/video analysis with your chosen model","Build an MCP server around Facebook Ads Library + a dedicated analytics/analyzers service"],"af_score":69.0,"security_score":55.5,"reliability_score":35.0,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:38:13.375586+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Environment variables (SCRAPECREATORS_API_KEY, optional GEMINI_API_KEY)"],"oauth":false,"scopes":false,"notes":"Auth is handled via API keys loaded from a local .env file. No OAuth flow or fine-grained scope model is described."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Pricing is not described here; usage likely depends on ScrapeCreators API credits and (for video analysis) Gemini API costs."},"requirements":{"requires_signup":true,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":69.0,"security_score":55.5,"reliability_score":35.0,"mcp_server_quality":72.0,"documentation_accuracy":70.0,"error_message_quality":null,"error_message_notes":"README describes scenarios like ScrapeCreators API credits exhausted, rate limit exceeded (with wait guidance), missing API keys, and video analysis not working due to missing GEMINI_API_KEY. It does not document standardized MCP error structures or tool-level retry/idempotency guarantees.","auth_complexity":85.0,"rate_limit_clarity":65.0,"tls_enforcement":70.0,"auth_strength":55.0,"scope_granularity":30.0,"dependency_hygiene":45.0,"secret_handling":75.0,"security_notes":"Uses environment variables via a .env file for API keys (reduces risk of embedding secrets in code). No details are provided about TLS verification, secret logging, or dependency scanning; thus dependency hygiene and deeper security controls can’t be confirmed from the README alone.","uptime_documented":0.0,"version_stability":45.0,"breaking_changes_history":40.0,"error_recovery":55.0,"idempotency_support":"false","idempotency_notes":"No explicit idempotency guarantees are documented for MCP tools. While caching/deduplication exist, it’s not clear how repeated calls behave under failure/retry.","pagination_style":"none","retry_guidance_documented":true,"known_agent_gotchas":["Video analysis requires GEMINI_API_KEY; image analysis tools likely work without it.","Operations depend on ScrapeCreators API credits; credit exhaustion may interrupt workflows and requires manual top-up.","Rate limits may require waiting; large batch requests can increase likelihood of hitting limits.","Local MCP server requires correct venv/Python path and .env placement; misconfiguration will prevent tool execution."]}}