Meta Ad Library Spend MCP Demo by AdSpendSpy
Keyless demo: Meta Ad Library ads of one advertiser with estimated ad spend and top landing pages.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"adspendspy-demo": {
"url": "https://www.adspendspy.com/mcp-demo"
}
}
}원격 엔드포인트
https://www.adspendspy.com/mcp-demostreamable-http할 수 있는 일
도구 목록
도구 (7)
🟢list_tracked_brands(project)
Public demo: Alex Hormozi only (page_id 116482854782233). Ad listings/details expose only approved public creatives; statistics describe this advertiser only. List your actively tracked advertisers and their string page_id values.
입력 스키마
{
"type": "object",
"properties": {
"project": {
"type": "string",
"enum": [
"all"
],
"description": "Only all is available in the public demo."
}
},
"required": [],
"additionalProperties": false
}🟢search_tracked_brands(q)
Public demo: Alex Hormozi only (page_id 116482854782233). Ad listings/details expose only approved public creatives; statistics describe this advertiser only. Search your tracked advertisers by name, Meta page ID, or stored Facebook URL. Searches existing local data only; does not resolve vanity URLs through paid providers.
입력 스키마
{
"type": "object",
"properties": {
"q": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
},
"required": [
"q"
],
"additionalProperties": false
}🟢check_brands_tracked(page_ids)
Public demo: Alex Hormozi only (page_id 116482854782233). Ad listings/details expose only approved public creatives; statistics describe this advertiser only. Check whether each string Meta page ID is actively tracked by your account.
입력 스키마
{
"type": "object",
"properties": {
"page_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9]{5,25}$",
"description": "Meta advertiser page ID, kept as a string."
},
"minItems": 1,
"maxItems": 100
}
},
"required": [
"page_ids"
],
"additionalProperties": false
}🟢list_brand_ads(page_id, limit, cursor, media_type, active_only, ...)
Public demo: Alex Hormozi only (page_id 116482854782233). Ad listings/details expose only approved public creatives; statistics describe this advertiser only. List creative summaries for one tracked advertiser, newest internal ID first, or with sort spend highest latest cumulative estimated spend first (use it for an advertiser's top ads). pagination.next_cursor returns the next page. Each ad carries internal_ad_id (AdSpendSpy ID) and meta_ad_id (the ad on Meta).
입력 스키마
{
"type": "object",
"properties": {
"page_id": {
"type": "string",
"pattern": "^[0-9]{5,25}$",
"description": "Meta advertiser page ID, kept as a string.",
"enum": [
"116482854782233"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
},
"cursor": {
"type": "string",
"minLength": 1,
"maxLength": 512,
"description": "Opaque pagination.next_cursor returned by the previous page with the same filters."
},
"media_type": {
"type": "string",
"enum": [
"all",
"image",
"video"
],
"default": "all"
},
"active_only": {
"type": "boolean",
"default": false
},
"sort": {
"type": "string",
"enum": [
"newest",
"spend"
],
"default": "newest",
"description": "newest = newest internal ID first; spend = highest estimated spend first."
}
},
"required": [
"page_id"
],
"additionalProperties": false
}🟢get_ad_details(ad_id)
Public demo: Alex Hormozi only (page_id 116482854782233). Ad listings/details expose only approved public creatives; statistics describe this advertiser only. Retrieve one ad of an advertiser you actively track by its internal AdSpendSpy ad ID (internal_ad_id), not its Meta ad ID. Saved lists and favorites do not retain MCP ad access after you remove a tracked brand on the website.
입력 스키마
{
"type": "object",
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991,
"description": "Internal AdSpendSpy ad ID (internal_ad_id in ad listings); never a Meta ad ID."
}
},
"required": [
"ad_id"
],
"additionalProperties": false
}🟢get_top_ads_stats(page_id, q, media_type, category, project, ...)
Public demo: Alex Hormozi only (page_id 116482854782233). Ad listings/details expose only approved public creatives; statistics describe this advertiser only. Analyze latest cumulative estimated spend in EUR for your tracked advertisers. page_id is an exact advertiser filter. timeframe filters when ads were last seen, NOT spend accrued during that period. Creative breakdowns sample the top 1,000 ads; response metadata states matched and sampled counts and full-match aggregate spend. Zero can mean unavailable estimates.
입력 스키마
{
"type": "object",
"properties": {
"page_id": {
"type": "string",
"pattern": "^[0-9]{5,25}$",
"description": "Meta advertiser page ID, kept as a string.",
"enum": [
"116482854782233"
]
},
"q": {
"type": "string",
"maxLength": 500
},
"media_type": {
"type": "string",
"enum": [
"all",
"image",
"video"
],
"default": "all"
},
"category": {
"type": "string",
"maxLength": 100
},
"project": {
"type": "string",
"enum": [
"all"
],
"description": "Only all is available in the public demo."
},
"timeframe": {
"type": "string",
"enum": [
"all",
"7d",
"30d",
"90d"
],
"default": "30d",
"description": "Last-seen window; never a period-spend calculation."
},
"active_only": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "string",
"enum": [
"0",
"1",
"true",
"false"
]
}
],
"default": false
}
},
"required": [],
"additionalProperties": false
}🟢get_top_landingpages_stats(page_id, q, project, timeframe, active_only, ...)
Public demo: Alex Hormozi only (page_id 116482854782233). Ad listings/details expose only approved public creatives; statistics describe this advertiser only. Rank the landing pages of your tracked advertisers by latest cumulative estimated spend in EUR. Ads are grouped by landing URL with ad, advertiser and active-ad counts, the top-spending advertiser and, when one is stored, a screenshot as screenshot_url (site path) and screenshot_full_url (absolute URL). page_id is an exact advertiser filter; q matches part of the landing URL. timeframe filters when ads were last seen, NOT spend accrued during that period. Zero can mean unavailable estimates.
입력 스키마
{
"type": "object",
"properties": {
"page_id": {
"type": "string",
"pattern": "^[0-9]{5,25}$",
"description": "Meta advertiser page ID, kept as a string.",
"enum": [
"116482854782233"
]
},
"q": {
"type": "string",
"maxLength": 500,
"description": "Substring of the landing URL."
},
"project": {
"type": "string",
"enum": [
"all"
],
"description": "Only all is available in the public demo."
},
"timeframe": {
"type": "string",
"enum": [
"all",
"7d",
"30d",
"90d"
],
"default": "30d",
"description": "Last-seen window; never a period-spend calculation."
},
"active_only": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "string",
"enum": [
"0",
"1",
"true",
"false"
]
}
],
"default": false
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 60
}
},
"required": [],
"additionalProperties": false
}커뮤니티
증거