谷歌广告透明度MCP服务器
一个MCP服务器，让人工智能助手查找任何广告商的谷歌广告。按域名或公司名称搜索，检索广告创意，并解码文本广告内容——所有这些都来自谷歌 广告透明度中心.
没有API密钥。没有付费服务。无需浏览器。
谷歌的广告透明中心没有官方的API。唯一的开源选择是 废弃的Python包 （最后一次提交是在2023年7月，域名搜索失败，在图片广告上崩溃）。付费替代方案的起价为每月75美元。该项目修复了scraper并将其包装为MCP服务器，因此任何人工智能助手都可以直接查询谷歌的广告数据库。
工具
| 工具 | 说明 |
|---|---|
search_advertiser_by_domain | 按网站域名查找广告商（例如。 nike.com) |
search_advertisers | 按关键字或公司名称搜索广告商 |
get_ads | 使用解码内容为广告商获取广告 |
get_ad_detail | 获取特定广告创意的完整细节 |
安装
# With uvx (recommended)
uvx google-ads-transparency-mcp
# With pip
pip install google-ads-transparency-mcp配置
克劳德代码
claude mcp add google-ads-transparency -- uvx google-ads-transparency-mcp克劳德桌面
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"google-ads-transparency": {
"command": "uvx",
"args": ["google-ads-transparency-mcp"]
}
}
}光标/VS代码
添加到MCP设置中：
{
"mcpServers": {
"google-ads-transparency": {
"command": "uvx",
"args": ["google-ads-transparency-mcp"]
}
}
}示例用法
连接后，询问您的AI助手以下问题：
- *“nike.com上有什么广告？”*
- *“在谷歌上搜索加密货币交易所广告商”*
- *“从Coinbase获取最后5个广告”*
- *“查找广告商AR0509902686533578753的广告详细信息”*
示例：域名搜索
> search_advertiser_by_domain("nike.com")
{
"advertiser_id": "AR14188379519798214657",
"name": "Nike, Inc.",
"ad_count": 1842
}示例：获取包含解码文本内容的广告
> get_ads("Coinbase", count=1)
[
{
"advertiser_id": "AR09076382774528",
"creative_id": "CR10813648716908961793",
"format": "text",
"last_shown": "2025-01-15",
"advertiser_name": "Coinbase",
"content": {
"preview_url": "https://ads-rendering-prod.corp.google.com/search?...",
"headline": "Most Trusted Crypto Exchange",
"description": "Buy, Sell & Trade Bitcoin, Ethereum & More...",
"destination_url": "coinbase.com"
}
}
]运作原理
此服务器对Google的内部RPC端点进行反向工程：
| 终点 | 目的 |
|---|---|
SearchService/SearchSuggestions | 关键字/域名搜索 |
SearchService/SearchCreatives | 按广告商获取广告创意ID |
LookupService/GetCreativeById | 获取个人广告详细信息 |
文本/搜索广告的内容在iframe预览URL中编码为base64。服务器对这些内容进行解码，以提取标题、描述和目标URL。
用作Python库
from google_ads_transparency_mcp import GoogleAdsTransparency
client = GoogleAdsTransparency()
# Search by domain
advertiser = client.search_advertiser_by_domain("nike.com")
print(advertiser) # {"advertiser_id": "...", "name": "Nike, Inc.", "ad_count": 1842}
# Get ads with decoded content
ads = client.get_ads("Coinbase", count=5)
for ad in ads:
print(ad["format"], ad["content"])
# Region-specific search
client_uk = GoogleAdsTransparency(region="GB")支持的地区
传递一个两个字母的国家代码，按地区进行筛选。使用 "anywhere" （默认）用于全局结果。全部 240+个地区 支持来自谷歌广告透明度中心的广告。
学分
许可证
麻省理工学院