scrapecreators_facebook_ads
Pack: scrapecreators · Endpoint: https://gateway.pipeworx.io/scrapecreators/mcp
Search the Facebook / Meta Ad Library by keyword or advertiser and return active ad creatives:
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | yes | Keyword or advertiser/page name to search for, e.g. “running shoes” or “Nike” |
country | string | no | 2-letter country code to scope the search, e.g. “US” (default ALL) |
status | string | no | Ad status filter: “ACTIVE”, “INACTIVE”, or “ALL” (default ACTIVE) |
media_type | string | no | Media type filter, e.g. “IMAGE”, “VIDEO”, “ALL” (default ALL) |
ad_type | string | no | Ad type filter, e.g. “ALL”, “POLITICAL_AND_ISSUE_ADS” (optional) |
search_type | string | no | Match mode, e.g. “keyword_unordered” or “keyword_exact_phrase” (optional) |
cursor | string | no | Pagination cursor returned in a previous response (optional) |
_apiKey | string | yes | ScrapeCreators API key (sign up at https://app.scrapecreators.com) |
Example call
curl -X POST https://gateway.pipeworx.io/scrapecreators/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"scrapecreators_facebook_ads","arguments":{}}}'
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"scrapecreators": {
"url": "https://gateway.pipeworx.io/scrapecreators/mcp"
}
}
}
See Getting Started for client-specific install steps.