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.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `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
}社群
證據