Get MCP Ads
官方通过托管的MCP URL,将Google Ads、Meta Ads、TikTok Ads、Pinterest Ads、Snapchat Ads、Search Console和GA4连接到您的AI助手。支持选择授权账户,提供免费只读套餐,付费套餐支持写入操作的预览和确认。
你可以用 Get Ads MCP 做什么?
-
检查广告账户健康状态 — 通过
reddit_health_check、bing_health_check或snapchat_health_check查询所选账户的货币、时区和状态。 -
列出广告系列和广告 — 使用
reddit_get_campaigns、bing_get_campaigns、snapchat_get_campaigns或meta_get_campaigns获取原生广告系列、广告组和广告配置。 -
读取定向配置 — 使用
reddit_get_targeting、bing_get_targeting、snapchat_get_targeting或meta_get_adset_configuration拉取实际的包含项、排除项、地理位置和人口统计信息。 -
预览写入操作 — 草拟广告、广告系列或受众更改而不实际应用;写入操作需要
confirm: true,且默认保持暂停状态。 -
获取效果洞察 — 使用
reddit_get_insights、bing_get_insights、snapchat_get_insights或meta_get_insights并指定明确日期范围,查询原生报告数据。 -
管理创意素材 — 通过
reddit_list_ad_creatives、bing_list_ad_creatives、snapchat_list_ad_creatives或meta_get_creative_assets列出与广告关联的图片和视频。
托管 MCP 服务器
npx add-mcp 'https://mcp.getmcpads.com/mcp'可安装到 Claude Code、Codex、Cursor、VS Code 等客户端
文档
工具目录
9 个已记录来源中实现了 388 个工具。以下来源访问说明决定了通过 https://mcp.getmcpads.com/mcp. 可调用哪些内容。
标记为 (write) 的工具会更改在线账户上的内容。它们默认预览:
没有 confirm: true 时,工具仅描述更改而不应用任何操作。免费套餐完全拒绝写入操作。
工具仅对组织已勾选的账户进行响应。任何其他标识符都会被拒绝,包括底层连接本可访问的账户。
Reddit Ads(50 个工具,19 个写入)
外部助手访问正在等待 Reddit 的澄清。授权操作员可以管理测试连接;此处记录了已实现的工具,但尚不可公开调用。
reddit_create_ad(write):使用原生字段创建 Reddit 广告,包括支持的目标/格式。默认预览;活动/广告组/广告的创建始终为 PAUSED。编辑前请阅读 reddit_get_write_schema(operation=ad_create) 和当前配置。reddit_create_ad_group(write):使用原生字段创建 Reddit ad_group,包括支持的目标/格式。默认预览;活动/广告组/广告的创建始终为 PAUSED。编辑前请阅读 reddit_get_write_schema(operation=ad_group_create) 和当前配置。reddit_create_campaign(write):使用原生字段创建 Reddit 活动,包括支持的目标/格式。默认预览;活动/广告组/广告的创建始终为 PAUSED。编辑前请阅读 reddit_get_write_schema(operation=campaign_create) 和当前配置。reddit_create_catalog(write):使用原生 schema catalog_create 创建 Reddit 目录。先预览。导入是异步的;轮询返回的句柄。不会激活广告。reddit_create_custom_audience(write):使用原生字段创建 Reddit custom_audience,包括支持的目标/格式。默认预览;活动/广告组/广告的创建始终为 PAUSED。编辑前请阅读 reddit_get_write_schema(operation=custom_audience_create) 和当前配置。reddit_create_lead_form(write):使用原生字段创建 Reddit lead_form,包括支持的目标/格式。默认预览;活动/广告组/广告的创建始终为 PAUSED。编辑前请阅读 reddit_get_write_schema(operation=lead_form_create) 和当前配置。reddit_create_post(write):使用原生 schema post_create 创建 Reddit 帖子。先预览。导入是异步的;轮询返回的句柄。不会激活广告。reddit_create_product_set(write):使用原生 schema product_set_create 创建 Reddit 产品集。先预览。导入是异步的;轮询返回的句柄。不会激活广告。reddit_create_saved_audience(write):使用原生字段创建 Reddit saved_audience,包括支持的目标/格式。默认预览;活动/广告组/广告的创建始终为 PAUSED。编辑前请阅读 reddit_get_write_schema(operation=saved_audience_create) 和当前配置。reddit_get_ad:读取一个 Reddit 广告;验证其属于所选广告账户。reddit_get_ad_group:读取一个 Reddit ad_group;验证其属于所选广告账户。reddit_get_ad_groups:读取 Reddit ad_groups,包括原生配置和已配置/有效状态。分页返回不透明游标;所有页面都需要显式继续。reddit_get_ads:读取 Reddit 广告,包括原生配置和已配置/有效状态。分页返回不透明游标;所有页面都需要显式继续。reddit_get_asset_uploads:通过所选配置文件轮询创意导入的处理;ACTIVE 表示媒体就绪,而非广告投放。reddit_get_campaign:读取一个 Reddit 活动;验证其属于所选广告账户。reddit_get_campaigns:读取 Reddit 活动,包括原生配置和已配置/有效状态。分页返回不透明游标;所有页面都需要显式继续。reddit_get_catalog_imports:从拥有的 Reddit 目录读取 catalog_imports。reddit_get_catalogs:读取拥有所选广告账户的企业的产品目录。reddit_get_creative_assets:列出所选 Reddit 配置文件的资产库;未使用的文件不一定是广告。reddit_get_custom_audience:读取一个 Reddit custom_audience;验证其属于所选广告账户。reddit_get_custom_audiences:读取 Reddit custom_audiences,包括原生配置和已配置/有效状态。分页返回不透明游标;所有页面都需要显式继续。reddit_get_insights:原生 Reddit 报告,包含指标和实体/受众细分、显式 UTC 日期和分页。空结果仅验证传输。报告的受众人口统计与配置的定向不同。reddit_get_lead_form:读取一个 Reddit lead_form;验证其属于所选广告账户。reddit_get_lead_gen_forms:读取 Reddit lead_gen_forms,包括原生配置和已配置/有效状态。分页返回不透明游标;所有页面都需要显式继续。reddit_get_pixels:列出所选 Reddit 广告账户可访问的像素。reddit_get_post:在配置文件所有权验证后读取广告结构化帖子。reddit_get_post_job:使用签名的作业回执轮询先前创建的结构化帖子。不接受来自其他账户的任意作业 ID。reddit_get_posts:列出附加到此账户的配置文件对应的广告结构化帖子。返回原生图片/视频/轮播/文本配置。reddit_get_product_sets:从拥有的 Reddit 目录读取 product_sets。reddit_get_products:从拥有的 Reddit 目录读取产品。reddit_get_profiles:列出所选 Reddit 广告账户可访问的配置文件。reddit_get_reporting_schema:Reddit 指标和维度清单;配置的定向使用 reddit_get_targeting 读取,而非从报告推断。reddit_get_saved_audience:读取一个 Reddit saved_audience;验证其属于所选广告账户。reddit_get_saved_audiences:读取 Reddit saved_audiences,包括原生配置和已配置/有效状态。分页返回不透明游标;所有页面都需要显式继续。reddit_get_setup_guide:完整的 Reddit 连接器覆盖范围、前提条件和实时验证限制。不要从初始的简短工具列表推断不可用的功能。reddit_get_targeting:读取实际的广告组定向:包含、排除、地理位置、年龄/性别、语言、兴趣、社区、关键词、设备和受众 ID。这是配置,而非投放人口统计。reddit_get_targeting_options:发现有效的原生定向值。社区可搜索;大型列表分页或明确标记为部分。reddit_get_write_schema:Reddit 创建和编辑的精确固定原生 schema,包括定向和所有已实现的活动/广告格式。提供商接受与本地 schema 验证是分开的。reddit_health_check:读取所选 Reddit 账户、货币和时区;API 访问不证明投放或完整的目标资格。reddit_list_ad_creatives:解析广告关联的图片/视频/轮播资产,并明确覆盖范围。视频封面不能确定其动态/音频;可用时使用完整媒体。reddit_update_ad(write):使用原生字段更新 Reddit 广告,包括支持的目标/格式。默认预览;活动/广告组/广告的创建始终为 PAUSED。编辑前请阅读 reddit_get_write_schema(operation=ad_update) 和当前配置。reddit_update_ad_group(write):使用原生字段更新 Reddit ad_group,包括支持的目标/格式。默认预览;活动/广告组/广告的创建始终为 PAUSED。编辑前请阅读 reddit_get_write_schema(operation=ad_group_update) 和当前配置。reddit_update_asset(write):更新支持的 Reddit 资产字段;默认预览。阅读 reddit_get_write_schema(operation=asset_update)。reddit_update_campaign(write):使用原生字段更新 Reddit 活动,包括支持的目标/格式。默认预览;活动/广告组/广告的创建始终为 PAUSED。编辑前请阅读 reddit_get_write_schema(operation=campaign_update) 和当前配置。reddit_update_catalog(write):更新支持的 Reddit 目录字段;默认预览。阅读 reddit_get_write_schema(operation=catalog_update)。reddit_update_post(write):更新支持的 Reddit 帖子字段;默认预览。阅读 reddit_get_write_schema(operation=post_update)。reddit_update_product_set(write):更新支持的 Reddit product_set 字段;默认预览。阅读 reddit_get_write_schema(operation=product_set_update)。reddit_update_saved_audience(write):使用原生字段更新 Reddit saved_audience,包括支持的目标/格式。默认预览;活动/广告组/广告的创建始终为 PAUSED。编辑前请阅读 reddit_get_write_schema(operation=saved_audience_update) 和当前配置。reddit_upload_creative_assets(write):使用原生 schema asset_upload 上传 Reddit 创意资产。先预览。导入是异步的;轮询返回的句柄。不会激活广告。reddit_upsert_products(write):使用原生 schema products_upsert 更新或插入 Reddit 产品。先预览。导入是异步的;轮询返回的句柄。不会激活广告。
Microsoft Advertising(39 个工具,20 个写入)
外部助手访问未启用。授权操作员可进行沙盒测试和生产账户发现。发布者和外部租户同意验证仍在进行中;开发者令牌已获取。
bing_add_ad_group_targeting(写入):添加一个原生广告组定向条件。编辑前先读取当前定向;使用 Targets 进行人口统计/地理编辑,使用 Audience 进行受众关联。不会清除未指定的条件。bing_add_campaign_targeting(写入):添加一个原生广告系列定向条件。编辑前先读取当前定向;使用 Targets 进行人口统计/地理编辑,使用 Audience 进行受众关联。不会清除未指定的条件。bing_create_ad(写入):使用原生字段创建 Microsoft Ads 广告。默认预览。广告实体创建时为已暂停状态。先读取 bing_get_write_schema 和当前配置。bing_create_ad_group(写入):使用原生字段创建 Microsoft Ads 广告组。默认预览。广告实体创建时为已暂停状态。先读取 bing_get_write_schema 和当前配置。bing_create_asset_group(写入):创建暂停的 Performance Max 资产组,包含文本/图片资产。需要符合条件的广告系列和所有必需资产;本地预览不构成提供商验证。bing_create_audience(写入):使用原生字段创建 Microsoft Ads 受众。默认预览。广告实体创建时为已暂停状态。先读取 bing_get_write_schema 和当前配置。bing_create_campaign(写入):使用原生字段创建 Microsoft Ads 广告系列。默认预览。广告实体创建时为已暂停状态。先读取 bing_get_write_schema 和当前配置。bing_create_conversion_goal(写入):创建 Microsoft Ads 转化目标配置。不涉及网站安装或事件注入。先预览;转化目标创建时为暂停状态,并排除在出价之外。bing_create_keyword(写入):使用原生字段创建 Microsoft Ads 关键字。默认预览。广告实体创建时为已暂停状态。先读取 bing_get_write_schema 和当前配置。bing_create_uet_tag(写入):创建 Microsoft Ads UET 标签配置。不涉及网站安装或事件注入。先预览;转化目标创建时为暂停状态,并排除在出价之外。bing_get_ad_groups:读取自有广告系列中的广告组和原生配置。bing_get_ads:读取广告,包括原生创意资产、URL 和状态。AdTypes 显式控制返回的格式。bing_get_asset_groups:读取 Performance Max 资产组,包含原生创意配置和状态。bing_get_audiences:读取指定类型的可访问受众配置。空受众不构成可匹配性或可定向性。bing_get_campaigns:读取指定广告系列类型的原生配置、预算、设置和状态。对其他类型重复操作以盘点整个账户。bing_get_conversion_goals:读取转化目标配置;这不构成事件正在流动的证据。bing_get_geo_file:获取 Microsoft 当前地理定向目录下载链接。使用其有效的 Location ID;切勿复用 Google 的 location ID。bing_get_insights:为所选账户提交异步 Microsoft Ads 报告。使用 bing_get_report 轮询已签名的回执。原生列兼容性和沙盒数据可用性适用。bing_get_keywords:读取自有广告组中的关键字、匹配类型、出价和状态。bing_get_media:按 ID 读取所选账户中已上传的 Microsoft Ads 媒体元数据。bing_get_report:轮询并下载绑定到所选账户和环境的 Microsoft Ads 报告。最多返回 2,000 行 CSV;若被截断请缩小范围。空沙盒输出不构成生产性能证据。bing_get_reporting_schema:读取固定的 Microsoft 报告类型、支持的原生列和官方参考。为兼容的报告类型选择列;目录条目不构成已填充或生产数据的证据。bing_get_setup_guide:Microsoft Ads 连接器覆盖范围、沙盒验证和剩余限制。在声称对等或不受支持的功能之前先阅读。bing_get_targeting:按条件类型分别读取实际配置的广告系列或广告组定向。包含包含/排除条件对象;这是配置,而非人口统计表现。bing_get_uet_tags:读取 UET 跟踪标签配置。此操作不会安装任何网站跟踪代码。bing_get_videos:读取账户视频资产和处理状态。Active 表示媒体已就绪,而非广告正在投放。视频访问取决于账户资格;使用返回的错误代码。bing_get_write_schema:固定的 Microsoft 原生实体字段。阅读每个多态对象的文档以获取其 REST Type 值。架构描述 API;账户资格仍然独立。bing_health_check:读取所选账户并确认沙盒/生产环境、客户和货币。这不验证每个功能。bing_import_video(写入):将可直接下载的 HTTPS 文件中的视频导入所选账户。Microsoft 异步获取并转码源文件;返回的 ID 不表示就绪。先预览,然后轮询 bing_get_videos。不会创建或激活广告。bing_list_ad_creatives:检索与账户自有广告和 Performance Max 资产组关联的实际图片表示,保留父级 ID/名称。库存有限;不推断投放、视频内容或 KPI 归因。bing_update_ad(写入):使用原生字段更新 Microsoft Ads 广告。默认预览。广告实体创建时为已暂停状态。先读取 bing_get_write_schema 和当前配置。bing_update_ad_group(写入):使用原生字段更新 Microsoft Ads 广告组。默认预览。广告实体创建时为已暂停状态。先读取 bing_get_write_schema 和当前配置。bing_update_ad_group_targeting(写入):更新一个原生广告组定向条件。编辑前先读取当前定向;使用 Targets 进行人口统计/地理编辑,使用 Audience 进行受众关联。不会清除未指定的条件。bing_update_audience(写入):使用原生字段更新 Microsoft Ads 受众。默认预览。广告实体创建时为已暂停状态。先读取 bing_get_write_schema 和当前配置。bing_update_campaign(写入):使用原生字段更新 Microsoft Ads 广告系列。默认预览。广告实体创建时为已暂停状态。先读取 bing_get_write_schema 和当前配置。bing_update_campaign_targeting(写入):更新一个原生广告系列定向条件。编辑前先读取当前定向;使用 Targets 进行人口统计/地理编辑,使用 Audience 进行受众关联。不会清除未指定的条件。bing_update_keyword(写入):使用原生字段更新 Microsoft Ads 关键字。默认预览。广告实体创建时为已暂停状态。先读取 bing_get_write_schema 和当前配置。bing_update_video(写入):更新账户自有视频资产的描述。不会改变投放或替换视频源。默认预览;使用 bing_get_videos 回读。bing_upload_image(写入):将图片字节上传到所选 Microsoft Ads 库。不会创建或激活广告。本地预览报告字节长度,不重复图片主体。
Snapchat Ads(41 个工具,21 个写入)
适用于已授权、已选择的账户。
snapchat_create_ad(write):创建 Snapchat 广告。始终为 PAUSED 状态。默认本地预览;在验证父级/账户所有权后确认真实写入。snapchat_create_adsquad(write):创建 Snapchat 广告组。始终为 PAUSED 状态。默认本地预览;在验证父级/账户所有权后确认真实写入。snapchat_create_campaign(write):创建 Snapchat 广告系列。始终为 PAUSED 状态。默认本地预览;在验证父级/账户所有权后确认真实写入。snapchat_create_creative(write):创建 Snapchat 创意。默认本地预览;在验证父级/账户所有权后确认真实写入。snapchat_create_creative_element(write):创建 Snapchat 创意元素。默认本地预览;在验证父级/账户所有权后确认真实写入。snapchat_create_interaction_zone(write):创建 Snapchat 互动区域。默认本地预览;在验证父级/账户所有权后确认真实写入。snapchat_create_lead_generation_form(write):创建 Snapchat 线索收集表单。默认本地预览;在验证父级/账户所有权后确认真实写入。snapchat_create_lookalike(write):基于自有客户列表种子创建类似受众。提供商资格和足够的种子规模要求仍然适用;创建不保证 targetable_status 为 READY。除非 confirm true,否则预览。snapchat_create_media(write):创建 Snapchat 媒体。默认本地预览;在验证父级/账户所有权后确认真实写入。snapchat_create_segment(write):创建 Snapchat 细分受众。默认本地预览;在验证父级/账户所有权后确认真实写入。snapchat_finalize_media_upload(write):在所有分片成功后完成视频上传。使用 init_media_upload 返回的确切 finalize_path 和 upload_id。除非 confirm true,否则预览。snapchat_get_ads:列出所选账户中的 Snapchat 广告,保留完整的原生配置和分页。广告组即 ad group/ad set。snapchat_get_adsquads:列出所选账户中的 Snapchat 广告组,保留完整的原生配置和分页。广告组即 ad group/ad set。snapchat_get_campaigns:列出所选账户中的 Snapchat 广告系列,保留完整的原生配置和分页。广告组即 ad group/ad set。snapchat_get_creative_elements:列出所选账户中的 Snapchat 创意元素,保留完整的原生配置和分页。广告组即 ad group/ad set。snapchat_get_creatives:列出所选账户中的 Snapchat 创意,保留完整的原生配置和分页。广告组即 ad group/ad set。snapchat_get_entity:读取广告系列、广告组、广告、创意、媒体或细分受众,并验证账户所有权。snapchat_get_insights:读取原生 Snapchat 统计数据,包含明确的时间间隔(结束时间排除)、粒度以及可选的实体细分。花费和货币转化值为微货币。空测试账户结果不构成实际投放表现证据。snapchat_get_interaction_zones:列出所选账户中的 Snapchat 互动区域,保留完整的原生配置和分页。广告组即 ad group/ad set。snapchat_get_lead_generation_forms:列出所选账户中的 Snapchat 线索收集表单,保留完整的原生配置和分页。广告组即 ad group/ad set。snapchat_get_media:列出所选账户中的 Snapchat 媒体,保留完整的原生配置和分页。广告组即 ad group/ad set。snapchat_get_mobile_apps:在创建应用推广广告系列或移动再营销受众之前,读取与所选广告账户关联的 Snap App ID。snapchat_get_pixels:在配置转化优化或网站受众之前,读取与所选账户关联的像素。snapchat_get_segments:列出所选账户中的 Snapchat 细分受众,保留完整的原生配置和分页。广告组即 ad group/ad set。snapchat_get_setup_guide:读取 Snapchat 广告系列目标、受众工作流、创意格式前提条件和明确限制。实现不代表账户资格或实际投放。在声称所有功能可用之前使用。snapchat_get_targeting:读取已配置的广告组定向、受众、排除项、人口统计、地理位置和版位。缺失字段表示未知,而非广泛定向的证据。表现细分描述投放情况,而非已配置的定向。snapchat_get_targeting_options:在编辑前发现原生定向值:国家/地区、区域、语言、性别、兴趣和设备。保留分页;不要虚构类别 ID。snapchat_get_targeting_specs:读取单独存储的定向规格,包括超过 500 个条件的配置。这些可能从普通广告组响应中省略。snapchat_get_write_schema:发现已实现的 Snapchat 创建/编辑字段、必填字段和预览规则。这些是连接器支持的字段,并非完整的 Snap API 架构。snapchat_health_check:读取所选 Snapchat 账户、权限可见的元数据和测试标志。测试账户无法投放广告。snapchat_init_media_upload(write):初始化分块视频上传,最大 256 MiB,最多 32 个分片,每片 8 MiB。返回 upload_id、add_path 和 finalize_path 供后续调用使用。除非 confirm true,否则预览。snapchat_list_ad_creatives:解析与广告关联的 Snapchat 图片/视频、Story 子项和 Collection 磁贴,包含业务名称、原生 ID 和最新媒体 URL。不完整的格式/媒体会被报告。不推断任何表现。snapchat_update_ad(write):更新 Snapchat 广告配置,包括名称。默认预览;应用前检查所有权。snapchat_update_adsquad(write):更新 Snapchat 广告组配置,包括名称、定向、排期和预算。默认预览;应用前检查所有权。snapchat_update_audience_users(write):添加或移除客户列表成员。仅接受标准化后的 SHA-256 哈希:EMAIL_SHA256、PHONE_SHA256、MOBILE_AD_ID_SHA256。通过修剪/小写化来标准化电子邮件;电话号码转为国家代码数字;移动 ID 小写并保留连字符。切勿虚构客户数据。预览返回计数而非哈希。调用方每请求最多批量 10,000 条;confirm true 时应用。snapchat_update_campaign(write):更新 Snapchat 广告系列配置,包括名称。默认预览;应用前检查所有权。snapchat_update_creative(write):更新 Snapchat 创意配置,包括名称。默认预览;应用前检查所有权。snapchat_update_segment(write):重命名或编辑受众细分受众的保留期/描述。未更改的字段会被保留。除非 confirm true,否则本地预览。snapchat_update_status(write):暂停或激活广告系列、广告组或广告。默认预览;激活生产实体可能消耗预算。snapchat_upload_media(write):将 base64 图片/视频字节上传到先前创建的媒体对象。解码后最大 10 MiB。不支持外部 URL 抓取。预览不发送字节;confirm true 在所有权验证后上传。snapchat_upload_media_part(write):上传一个视频分片,解码后最大 8 MiB。使用 init_media_upload 返回的确切 add_path 和 upload_id。预览绝不发送字节。
Meta 广告(57 个工具,23 个写入)
适用于已授权、已选择的账户。
meta_batch_catalog_items(写入):按 retailer_id 创建或更新最多 50 个目录商品。返回异步批次句柄;接受不代表完成。不支持删除或自动 upsert。默认本地预览。不自动重试。在 Meta 验证或变更之前检查账户所有权。meta_create_ad(写入):使用所选账户中现有的广告组和素材创建 PAUSED 广告。默认本地预览。不自动重试。在 Meta 验证或变更之前检查账户所有权。meta_create_adcreative(写入):从现有帖子或显式 object_story_spec 及可选 asset_feed_spec 创建广告创意。支持图片、视频、轮播、集合和灵活规格。不会启动广告。默认本地预览。不自动重试。在 Meta 验证或变更之前检查账户所有权。meta_create_adset(写入):使用显式定向、优化、版位、归因、出价和排期创建 PAUSED Meta 广告组。金额使用账户主要货币单位。默认本地预览。不自动重试。在 Meta 验证或变更之前检查账户所有权。meta_create_campaign(写入):创建 Meta 广告系列。它始终以 PAUSED 状态创建,且没有选项可将其创建为活跃状态。默认预览。meta_create_custom_audience(写入):创建网站、互动、客户列表容器或类似受众。不上传客户数据。条款和资格由 Meta 强制执行。默认本地预览。不自动重试。在 Meta 验证或变更之前检查账户所有权。meta_create_product_set(写入):在与所选广告账户同一 Business 拥有的目录中创建筛选商品集。绝不发布到 Shops。默认本地预览。不自动重试。在 Meta 验证或变更之前检查账户所有权。meta_debug_token:检查当前访问令牌的有效性、过期时间和授予的范围。用于诊断认证问题。meta_duplicate_adset(写入):在所选账户内复制一个已知良好的广告组,保留复杂的原生配置。始终为 PAUSED 且不复制广告。之后使用 meta_rename_adset 重命名。默认本地预览。不自动重试。在 Meta 验证或变更之前检查账户所有权。meta_get_account_details:获取特定 Meta 广告账户的详细信息:名称、货币、时区、花费上限、状态、业务信息。meta_get_ad_activity:从 /{ad_account_id}/activities 读取广告账户活动日志,包含 object、event、actor、timestamp 和 extra_data 字段。meta_get_ad_studies:列出广告账户的转化提升研究和 A/B 测试(Ad Studies)。包括研究类型、状态和单元。meta_get_ads:列出 Meta 广告账户的广告,可选按广告组筛选。返回广告 ID、名称、状态和创意引用。meta_get_adset_configuration:在准备编辑之前读取现有广告组、其父级广告系列预算/目标和账户货币。返回原生设置;不进行变更。meta_get_adsets:列出 Meta 广告账户的广告组,可选按广告系列筛选。返回定向、预算、优化和排期信息。meta_get_audience_details:在权限允许的情况下,读取详细的自定义、已保存和类似受众,支持分页和丰富字段。meta_get_audiences:列出 Meta 广告账户的自定义、已保存和类似受众。meta_get_brand_safety_controls:从广告账户/广告组定向和可选屏蔽列表边读取品牌安全、适用性、版位和上下文控制信号。meta_get_business_assets:以只读方式发现可访问的 Meta Business 资产:在权限允许时包括业务、主页、Instagram 账户、像素和数据集。meta_get_campaign_structure:获取层级广告系列结构:广告系列 -> 广告组 -> 广告。有助于理解账户组织。meta_get_campaigns:列出 Meta 广告账户的广告系列。返回广告系列 ID、名称、状态、目标、预算和出价策略。meta_get_catalog_batch_status:读取目录批次句柄的完成情况和逐项错误。批次的接受并不证明每个商品都成功。meta_get_catalog_products:在目录访问可用时读取产品目录和产品项目。返回可连接的产品元数据,不创建或更新目录资产。meta_get_creative_assets:返回与广告关联的创意媒体,包含实际广告名称、集合封面、所有轮播/灵活组件、解析后的图片哈希和视频 URL。仅目录广告单独分类;使用 get_creative_gallery 查看视觉画廊。原始创意元数据仍可用于诊断。meta_get_creatives:获取广告创意内容:文本、图片、视频、链接、行动号召。返回指定广告的创意详情。meta_get_delivery_diagnostics:使用可用的 status/effective_status/issues_info 以及简单投放洞察,跨广告系列、广告组和广告聚合只读投放诊断。meta_get_insights:查询 Meta Ads 表现洞察。支持 170+ 指标、43+ 细分,并具有智能查询规划。 使用 meta://metrics 资源查看可用指标。使用 meta://breakdowns 查看可用细分。 查询规划器自动将不兼容的指标/细分组合拆分为多个 API 请求并合并结果。meta_get_instagram_accounts:在权限允许时,列出链接到可访问主页、Business Manager 资产或广告账户的 Instagram 账户。meta_get_organic_content_enrichment:读取 Facebook 主页帖子和 Instagram 媒体,包含 URL、原生时间段和可选洞察。这些是内容洞察,而非广告洞察;不要推断仅限自然触达的细分。meta_get_page_posts:使用从连接用户解析的主页令牌读取已发布的 Facebook 主页帖子。返回确切的 PageID_PostID、消息、永久链接和媒体附件。使用 postId 进行精确的现有帖子广告预检。不请求 Instagram 媒体、评论、点赞或洞察;此读取本身不建立广告资格。meta_get_pages:列出可访问的 Facebook 主页,包含 id、名称、类别、任务、图片和可用的关联 Instagram 账户引用。meta_get_pixels:在可访问时从广告账户或 Business Manager 列出像素和数据集,返回权限受限边的可操作警告。meta_get_study_results:获取转化提升或 A/B 测试研究的详细结果。返回目标、单元和提升结果。meta_get_video_sources:为特定广告视频解析新鲜的下载 URL(source)和缩略图。在下载时调用:返回的 URL 已签名且会快速过期。meta_health_check:面向代理的只读健康检查:验证令牌元数据、列出可访问的广告账户,并警告缺失的读取范围而不暴露访问令牌。meta_interpret_experiment_results:读取和解释 A/B 测试或转化提升研究结果,包含置信度护栏、单元、目标和可选单元实体。meta_join_product_insights:查询产品细分洞察,并在目录访问可用时使用产品目录元数据丰富行。meta_list_ad_accounts:列出当前令牌可访问的所有 Meta 广告账户。返回账户 ID、名称、货币、时区和状态。meta_list_ad_images:列出广告账户图片库(/adimages):哈希、名称、尺寸、状态、永久公开服务的显示 URL(permalink_url)、短时 CDN URL,以及可选地使用每张图片的创意。meta_list_ad_videos:列出广告账户视频库(/advideos):标题、时长、处理状态和公开服务的缩略图(首选和最大尺寸)。源文件 URL 仅在请求时返回,因为它们会快速过期。meta_rename_ad(写入):重命名 Meta 广告。名称是唯一更改的内容。默认预览。meta_rename_adset(写入):重命名 Meta 广告组。名称是唯一更改的内容。默认预览。meta_rename_campaign(写入):重命名 Meta 广告系列。名称是唯一更改的内容。默认预览。meta_search_entities:在广告账户内按名称搜索广告系列、广告组或广告。有助于查找特定实体。meta_update_ad_creative(写入):用同一账户中的另一个现有创意替换广告的创意。广告状态不变。默认本地预览。不自动重试。在 Meta 验证或变更之前检查账户所有权。meta_update_ad_status(写入):暂停或重新激活 Meta 广告。默认预览:没有 confirm: true,工具描述更改而不应用它。meta_update_adset_budget(写入):更改 Meta 广告组的每日或终身预算。金额使用账户货币(12.50 表示 12.50 欧元)。Meta 期望最小单位,转换在此完成。默认预览。meta_update_adset_configuration(写入):更新定向、优化、版位、归因、出价、预算或排期。定向是完整替换,而非部分合并。状态不变。默认本地预览。不自动重试。在 Meta 验证或变更之前检查账户所有权。meta_update_adset_schedule(写入):更改 Meta 广告组的开始或结束时间。时间使用带偏移的 ISO 8601 格式,例如 2026-09-01T00:00:00+0200。默认预览。meta_update_adset_status(写入):暂停或重新激活 Meta 广告组。默认预览:没有 confirm: true,工具描述更改而不应用它。meta_update_campaign_budget(写入):更改在广告系列级别持有预算的 Meta 广告系列预算(Advantage 广告系列预算)。对于没有该预算的广告系列,Meta 会拒绝,此时应更改广告组预算。金额使用账户货币。默认预览。meta_update_campaign_status(写入):暂停或重新激活 Meta 广告系列。默认预览:没有 confirm: true,工具描述更改而不应用它。meta_update_custom_audience(写入):更新现有自定义受众的名称、描述、保留期或完整规则。不直接更改受众成员。默认本地预览。不自动重试。在 Meta 验证或变更之前检查账户所有权。meta_update_product_set(写入):替换商品集筛选器或重命名它。在写入之前检查目录所有权和集成员。默认本地预览。不自动重试。在 Meta 验证或变更之前检查账户所有权。meta_upload_ad_image(写入):使用 base64 字节(解码后最多 5 MiB)将图片上传到所选广告账户。预览仅报告大小,绝不报告文件内容。默认本地预览。不自动重试。在 Meta 验证或变更之前检查账户所有权。meta_upload_ad_video(写入):从公开可访问的 HTTPS URL 或 base64 MP4 字节(解码后最多 5 MiB)导入视频。Meta 异步处理。不启动广告系列。默认本地预览。不自动重试。在 Meta 验证或变更之前检查账户所有权。meta_validate_query:在执行之前验证指标/细分组合。返回错误和警告。使用此工具检查查询是否有效。
Pinterest Ads(52 个工具,24 个写入)
适用于已授权、已选择的账户。
pinterest_batch_catalog_items(写入):提交原生的CREATE/UPDATE/UPSERT/DELETE目录商品操作。在报告完成前轮询返回的批次ID。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_create_ad(写入):从可访问的Pin创建PAUSED广告。原生规范支持符合资格条件的Pinterest创意格式。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_create_adgroup(写入):创建PAUSED广告组,并明确指定原生出价、定向、预算和排期。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_create_board(写入):在所选广告主上下文中创建/boards。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_create_campaign(写入):创建PAUSED广告系列。货币便捷字段使用账户货币。广告系列预算优化默认为true;非CBO资格因账户而异。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_create_catalog(写入):在所选广告主上下文中创建/catalogs。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_create_catalog_feed(写入):在所选广告主上下文中创建/catalogs/feeds。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_create_pin(写入):在所选广告主上下文中创建/pins。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_create_product_group(写入):在所选广告主上下文中创建/catalogs/product_groups。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_create_product_group_promotion(写入):从目录商品组创建PAUSED购物或收藏促销。在Sandbox中不可用。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_estimate_delivery:运行非变更性的Pinterest规划计算:广告组受众规模、出价下限或广告系列投放估算。请求体遵循所选的Pinterest v5模式,不会创建或更改任何广告系列或广告组。pinterest_get_account_entities:读取Pinterest广告账户实体和配置。涵盖账户、广告系列、广告组、广告、商品组促销、促销、标签、排期、定向模板和订单行库存。返回一个API页面及其书签,用于可预测的实时查询。pinterest_get_audience_insights:读取聚合的Pinterest受众洞察,适用于广告主的总体或互动受众、Pinterest总体受众,或范围/类型端点。Pinterest固定受众洞察的观察窗口;这不是自定义日期范围的报告。pinterest_get_audiences:读取受众、客户列表、共享和Business-received受众库存,不上传或更改受众成员资格。pinterest_get_billing_and_orders:读取账单资料/发票、发票下载URL、订单行、广告积分折扣以及SSIO账户/订单状态。仅当令牌具有账户访问权限时才返回财务数据。pinterest_get_business_assets:读取Pinterest Business Access库存:雇主/关联企业、资产、成员、合作伙伴、已分配资产、已接收受众和邀请。需要相应的企业管理权限。pinterest_get_catalog_diagnostics:读取深度目录库存和诊断:目录、数据源、数据源处理结果、商品问题、商品组、商品数量/商品、可用筛选值和目录商品查找。ITEMS是只读的POST查找。pinterest_get_catalog_inventory:列出Pinterest目录库存表面:目录、商品组、商品组促销和可选商品样本。pinterest_get_conversion_setup:检查Pinterest转化衡量配置:转化标签、符合oCPM/页面访问条件的标签、事件质量评分、广告主定义的事件以及转化删除请求状态。这绝不会发送或删除转化事件。pinterest_get_creative_assets:获取Pinterest创意资产和可用时的期间表现。返回广告、Pin、缩略图/图片/视频、广告系列/广告组上下文、目录信号和资产分类。pinterest_get_delivery_metrics:读取Pinterest resources/delivery_metrics。用于检查Pinterest官方投放指标元数据,以用于同步或异步报告。pinterest_get_keyword_intelligence:读取已分配的定向关键词、Pinterest国家/地区级关键词指标、建议词或相关词。国家/地区指标每个请求最多接受2,000个关键词。pinterest_get_lead_assets:读取线索表单定义和线索订阅配置。有意排除线索记录导出,因为它可能包含最终用户的PII。pinterest_get_organic_inventory:读取与广告一起使用的Pinterest自然内容:Pin、画板、画板上的Pin、Pin商品标签或搜索结果。这是库存元数据,不是付费投放的证明。pinterest_get_pin_analytics:读取付费Pin分析、自然多渠道/单渠道Pin分析、用户账户分析、热门Pin或热门视频Pin。传递所选Pinterest端点支持的原始指标名称。pinterest_get_platform_resources:读取Pinterest平台元数据和就绪资源:支持的广告账户国家/地区、投放指标定义、指标就绪状态、线索表单问题、媒体上传元数据、商务集成元数据或已认证的用户账户。pinterest_get_targeting_options:读取Pinterest官方定向选项目录,涵盖应用类型、性别、语言、年龄、位置/地理、兴趣、关键词或受众。还可以解析特定的兴趣ID。pinterest_get_trends:读取Pinterest趋势:按支持地区划分的热门增长/月度/年度/季节性关键词、增长中的商品类别、商品类别详情、精选主题或编辑文章。pinterest_get_write_schema:在编写写入操作之前,读取官方Pinterest v5原生请求模式和Sandbox限制。pinterest_health_check:只读的Pinterest Ads健康检查。验证已配置的凭据、账户访问权限、投放指标访问权限以及可选默认账户可读性,不暴露OAuth令牌。pinterest_list_ad_accounts:列出配置的凭据可访问的Pinterest广告账户。pinterest_list_ad_creatives:列出广告账户在所有状态下的广告创意(API在未要求时静默省略ARCHIVED广告),并解析其Pin媒体:公开的i.pinimg.com图片URL(最高1200px)、视频封面,以及应用被允许读取时的video_url。默认排除目录驱动格式。pinterest_register_media(写入):注册媒体上传;返回的upload_url/parameters并不确认视频已上传或就绪。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_run_catalog_report:按PRODUCT_GROUP或PRODUCT_ITEM运行Pinterest目录报告。PRODUCT_ITEM历史限制为今天(UTC)之前92天,请求按31天窗口分块;较旧的商品表现无法通过重试获取。对于较旧的目录投放总量,请使用PRODUCT_GROUP,而不是单个SKU表现。pinterest_run_conversion_product_report:通过reports/brand_category_sku按品牌、类别、品牌+类别、SKU或SKU组运行Pinterest异步转化商品报告。这是Pinterest的受限功能:仅标准API访问并不能保证客户端可用。它与PRODUCT_ITEM支出报告是分开的。pinterest_run_report:运行只读的Pinterest Ads报告。自动将旧/宽或显式异步请求路由到Pinterest异步报告。使用原始的Pinterest报告列名。pinterest_run_specialized_export:启动或检查非变更性的Pinterest数据作业,用于营销组合建模(MMM)、批量广告主实体下载或目录诊断。START仅创建报告/导出工件;绝不会更新投放实体。pinterest_run_targeting_report:为广告账户、广告系列、广告组或广告运行实时定向分析,按年龄、性别、位置、兴趣、关键词、受众、展示位置、设备或其他Pinterest定向类型细分。对于早于同步窗口的数据,请使用带targetingTypes和executionMode=async的pinterest_run_report。pinterest_update_ad(写入):更新原生广告设置。先读取现有实体;嵌套规范可能替换现有值。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_update_ad_status(写入):更新现有广告的状态。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_update_adgroup_budget(写入):以主要账户货币单位设置恰好一个每日或终身广告组预算。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_update_adgroup_configuration(写入):更新原生广告组设置。先读取现有实体;嵌套规范可能替换现有值。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_update_adgroup_status(写入):更新现有广告组的状态。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_update_board(写入):在所选广告主上下文中更新/boards。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_update_campaign_budget(写入):以主要账户货币单位设置恰好一个每日或终身广告系列预算。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_update_campaign_configuration(写入):更新原生广告系列设置。先读取现有实体;嵌套规范可能替换现有值。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_update_campaign_status(写入):更新现有广告系列的状态。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_update_catalog_feed(写入):在所选广告主上下文中更新/catalogs/feeds。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_update_pin(写入):更新Pin。除了pins:write之外,还需要Pinterest受限的pin_edit权限;仅Standard权限不足。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_update_product_group(写入):在所选广告主上下文中更新/catalogs/product_groups。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_update_product_group_promotion(写入):更新目录商品组促销。在Sandbox中不可用。默认预览。不自动重试变更操作。原生API资格和权限范围仍然适用。pinterest_validate_report:验证并预览Pinterest报告将如何执行。返回同步/异步路由、端点、级别、列、归因设置和警告,而不调用表现端点。
Google Ads(44个工具,10个写入)
适用于已授权、已选择的账户。
google_ads_apply_plan(写入):预览、验证并原子化应用 Google Ads v25 构建/变更计划:广告系列、预算、广告组、RSA/展示/需求开发广告、图片/文字/YouTube 素材、PMax 素材组和链接、关键字、地理/语言定位列表组以及转化操作配置(不进行转化事件上传)。原生 REST camelCase 字段;金额为明确指定货币的整数微单位。支持临时负资源 ID,以便在一个事务中按顺序创建。不支持创建 VIDEO 广告系列(Google API 限制)、结算、账户访问变更、客户列表或转化上传。新广告系列/广告组/广告始终处于 PAUSED 状态。先不带 confirm 调用以检查计划并获取 planHash;validateOnly 要求 Google 仅验证而不应用;执行需要 confirm 和匹配的 expectedPlanHash。使用 google_ads_run_gaql 回读结果。在网络结果不确定后,切勿在检查其名称/ID 之前重试创建。google_ads_create_campaign(写入):创建 Google Ads 广告系列。它始终以 PAUSED 状态创建,且没有选项可以将其创建为有效状态:必须有人先查看它才能开始花费。同时创建广告系列预算。默认预览。google_ads_generate_ad_group_themes:将提供的关键字整理到现有的 Google Ads 广告组中。返回建议的广告组/广告系列配对、规范化关键字文本和建议匹配类型,而不创建或编辑关键字。只读关键字规划器 RPC。google_ads_generate_keyword_forecast_metrics:预测临时关键字广告系列的展示次数、点击次数、点击率、每次点击费用、费用、转化次数和每次转化费用。支持定位、否定关键字、匹配类型、三种出价策略、明确的未来日期以及可选的独立按关键字细分。此只读无计划 RPC 不会创建广告系列或保存的计划。google_ads_generate_keyword_historical_metrics:获取所提供关键字的 Keyword Planner 搜索量历史记录。返回平均每月搜索量、每月搜索量(最多 48 个月)、最新搜索量、计算的 3 个月和同比变化、竞争程度、每次点击费用/出价范围、近似变体以及可选的设备总计。这是只读无计划 RPC。google_ads_generate_keyword_ideas:从最多 20 个种子关键字、一个 URL、关键字加 URL 或整个网站中发现 Keyword Planner 创意。返回历史搜索量、月度趋势、计算的 3 个月/同比变化、竞争程度、出价、近似变体、可选概念和分页。只读;不保存任何计划。google_ads_get_account_details:获取特定 Google Ads 客户账户的详细信息。google_ads_get_account_hierarchy:列出可访问的客户,并在可能的情况下,从 GAQL customer_client 列出经理/客户关系。如果层级查询不可用,则回退到可访问客户。google_ads_get_adgroups:列出 Google Ads 账户的广告组,可选择按广告系列筛选。google_ads_get_bidding_strategies:列出组合出价策略。仅在提供 startDate/endDate 时包含指标;否则仅返回结构。google_ads_get_budgets:列出广告系列预算,包括金额、状态、投放方式和推荐预算字段(如果支持)。google_ads_get_campaigns:列出 Google Ads 账户的广告系列,包括状态、预算、渠道类型和出价策略。google_ads_get_change_events:获取最近的 change_event 行。强制执行 Google Ads 约束:日期窗口在过去 30 天内,且 LIMIT <= 10000。google_ads_get_conversion_actions:列出转化操作,包括状态、类型、类别、主要/计入转化标志、所有者客户以及最近活动日期(如果支持)。google_ads_get_demand_gen_assets:列出需求开发广告(视频响应式、多素材、轮播),并解析其引用的创意:稳定的图片 URL 和 YouTube 视频 ID,以及嵌入和缩略图 URL。补充了涵盖 Performance Max 的 google_ads_get_pmax_assets。google_ads_get_insights:使用智能查询规划查询 Google Ads 效果洞察。自动生成 GAQL,通过拆分查询处理指标/细分不兼容性。 使用 google-ads://metrics 获取可用指标,使用 google-ads://dimensions 获取维度。google_ads_get_keyword_performance:从 keyword_view 资源获取关键字级效果数据。显示质量得分、展示次数、点击次数和费用。google_ads_get_landing_pages:获取 landing_page_view 效果,包括最终 URL、广告系列/广告组上下文、流量、转化和落地页质量指标(如果支持)。google_ads_get_paid_organic_search_terms:只读付费/自然搜索字词报告。在可用时使用 paid_organic_search_term_view,如果自然字段不可用,则回退到仅付费的 search_term_view。google_ads_get_pmax_asset_diagnostics:只读 Performance Max 素材组诊断。返回广告强度、素材覆盖范围操作项、主要状态原因、可选效果指标和可选最佳素材组合。google_ads_get_pmax_assets:从 asset_group_asset 列出 Performance Max 素材组素材,包含素材组/广告系列上下文和可选的日期范围效果指标。google_ads_get_pmax_placements:来自 performance_max_placement_view 的只读 Performance Max 展示位置诊断。仅返回展示位置类型、显示名称、目标 URL、广告系列上下文和展示次数。google_ads_get_recommendations:列出 Google Ads 建议,包括类型、资源、广告系列/广告组链接、已关闭状态和影响(如果支持)。google_ads_get_search_terms:根据 reportType 从 search_term_view 或 campaign_search_term_insight 获取搜索字词效果。google_ads_get_shopping_performance:只读购物效果报告,按 Merchant Center 产品维度为键。可用于将支出/转化关联到商家 ID、商品 ID、标题、品牌、Feed 标签和自定义标签。google_ads_get_shopping_products:通过 shopping_product 获取只读 Merchant Center 产品目录/资格报告。当账户有 Shopping/PMax 电子商务数据时,支持账户、广告系列和广告组范围以及效果指标。google_ads_get_simulations:用于广告系列、广告组或组合出价模拟的只读规划/预测查询。在可用时返回模拟元数据和预测点列表,并带有元数据回退。google_ads_health_check:只读连接检查。验证凭据存在性、Google Ads API 访问权限、登录客户可见性、API 版本和可操作警告,而不返回机密信息。google_ads_list_accounts:列出当前凭据可访问的 Google Ads 客户账户。如果可访问客户是经理账户,则还尝试从 customer_client 包含已启用的子账户。google_ads_list_image_assets:列出账户的图片素材库(FROM asset),包含 tpc.googlesyndication.com 上稳定、公开提供的完整尺寸 URL、尺寸、文件大小和 MIME 类型。这是整个素材库,不包含投放概念:2022 年上传且从未投放的素材与今天正在投放的素材看起来完全一样。最新的在前,因此 limit 返回最近的素材而不是任意切片,响应中的计数是账户总数。如需仅查看素材的视觉画廊并按日期查看投放情况,请使用 get_creative_gallery(Performance Max 覆盖范围)。仅在需要 KPI 卡片时才请求 get_creative_performance。购物产品图片位于 Merchant Center,不在此素材库中。google_ads_list_video_assets:列出账户的 YouTube 视频素材(FROM asset),包含派生的观看、嵌入和公开缩略图 URL。这是整个素材库,不包含投放概念:多年前上传且从未投放的素材与今天正在投放的素材看起来完全一样。最新的在前,因此 limit 返回最近的素材而不是任意切片,响应中的计数是账户总数。如需仅查看素材的视觉画廊并按日期查看投放情况,请使用 get_creative_gallery(Performance Max 覆盖范围)。仅在需要 KPI 卡片时才请求 get_creative_performance。Google Ads 不公开可下载的视频文件:PMax 和需求开发视频托管在 YouTube 上,因此通过嵌入或缩略图显示它们。google_ads_remove_video_upload(写入):删除所选广告账户拥有的视频上传。删除上传的 YouTube 视频,并可能破坏引用它的广告。需要预览和匹配的 expectedPlanHash。Google v25 将标题/描述标记为不可变;此工具不会假装编辑它们。google_ads_rename_campaign(写入):重命名 Google Ads 广告系列。只有名称会改变:投放、预算和定位均不受影响。默认预览。google_ads_run_gaql:执行原始 GAQL(Google Ads 查询语言)查询。为任何报告需求提供完全灵活性。 示例:SELECT campaign.name, metrics.impressions FROM campaign WHERE campaign.status = 'ENABLED' AND segments.date DURING LAST_30_DAYS ORDER BY metrics.impressions DESC LIMIT 100。google_ads_run_readonly_rpc:高级只读逃生舱,用于 GAQL 之外的允许列表 Google Ads 服务:受众洞察、覆盖范围规划器、基准、创作者/热门洞察、定位建议、Smart Campaign 建议、身份验证、发票和付款账户。操作是一个枚举;任意路径和所有变更/上传均不可能。google_ads_search_fields:搜索 Google 的实时 GoogleAdsField 目录。发现每个可查询的 GAQL 资源、属性、细分、指标、枚举值以及可与选择兼容的关系。只读,在原始 GAQL 查询之前很有用。google_ads_suggest_geo_targets:将最多 25 个位置名称或地理目标 ID 解析为 Google Ads geoTargetConstants。返回条件 ID、规范名称、目标类型、状态、父级、区域设置和大致覆盖范围。只读。google_ads_update_adgroup_bid(写入):更改 Google Ads 广告组的默认每次点击费用出价。金额以账户货币为单位(1.20 表示 1.20 欧元)。对使用自动出价策略的广告系列没有影响。默认预览。google_ads_update_adgroup_status(写入):暂停、重新启用或移除 Google Ads 广告组。默认预览。google_ads_update_campaign_budget(写入):更改 Google Ads 广告系列的每日预算。金额以账户货币为单位(12.50 表示 12.50 欧元)。默认预览。google_ads_update_campaign_schedule(写入):更改 Google Ads 广告系列的开始或结束日期。日期为账户时区的 YYYY-MM-DD 格式。默认预览。google_ads_update_campaign_status(写入):暂停、重新启用或移除 Google Ads 广告系列。默认预览:没有 confirm: true,工具描述更改而不应用它。google_ads_upload_video(写入):将 MP4/WebM/QuickTime 字节(最大 16 MiB)上传到所选广告账户的 Google 管理 YouTube 频道。可见性为 UNLISTED:任何拥有链接的人都可以查看,不是私有的。默认预览省略字节并返回 planHash;confirm 需要 expectedPlanHash。此 API 没有 validateOnly。上传后,使用 google_ads_run_gaql 查询 you_tube_video_upload.state 和 video_id;仅在 PROCESSED 之后通过 google_ads_apply_plan assetOperation.youtubeVideoAsset 使用视频 ID。上传不确定后不自动重试。google_ads_validate_query:在执行查询之前验证指标/维度/资源兼容性。检查细分限制和资源可用性。
TikTok 广告(60 个工具,27 个写入)
适用于已授权、已选择的账户。
tiktok_create_adgroup(write):创建已禁用的经典 TikTok 广告组。无法选择启动为投放中状态。原生目标/格式资格由 TikTok 强制执行。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_create_ads(write):创建已禁用的经典 TikTok 广告(视频、图片、轮播或授权的 Spark 内容)。无法选择启动为投放中状态。原生目标/格式资格由 TikTok 强制执行。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_create_campaign(write):创建 TikTok 广告系列。始终以禁用状态创建,且无法选择创建为投放中状态。默认预览。tiktok_create_campaign_advanced(write):创建已禁用的经典 TikTok 广告系列。无法选择启动为投放中状态。原生目标/格式资格由 TikTok 强制执行。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_create_smart_plus_ad(write):创建已禁用的升级版 Smart+ TikTok 广告(视频、图片、轮播或授权的 Spark 内容)。无法选择启动为投放中状态。原生目标/格式资格由 TikTok 强制执行。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_create_smart_plus_adgroup(write):创建已禁用的升级版 Smart+ TikTok 广告组。无法选择启动为投放中状态。原生目标/格式资格由 TikTok 强制执行。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_create_smart_plus_campaign(write):创建已禁用的升级版 Smart+ TikTok 广告系列。无法选择启动为投放中状态。原生目标/格式资格由 TikTok 强制执行。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_get_adgroups:读取完整的原生广告组配置,包括定向、自定义/类似受众引用和排除、地理位置、语言、年龄/性别、版位、兴趣/行为、预算和排期。设置 smartPlus:true 以使用升级版 Smart+ 的 targeting_spec。缺失字段表示未知,而非不受限定向。分页。tiktok_get_ads:列出 TikTok 广告主的广告。返回广告 ID、名称、操作状态和创意信息。tiktok_get_advertiser_info:获取特定 TikTok 广告主账户的详细信息:货币、时区、状态、余额。tiktok_get_asset_urls:为特定 TikTok 素材库资产(file/video/ad/info 和 file/image/ad/info)重新解析新鲜的、可公开获取的 URL。请在展示或下载时调用:每个 TikTok 媒体 URL 均带签名且有有效期。tiktok_get_async_report_status:在异步报告端点可用时,通过 taskId 检查 TikTok 异步报告任务状态。不执行报告创建或变更操作。tiktok_get_audience_details:在 TikTok DMP 端点可访问时,获取自定义/类似/已保存受众的详细信息。仅只读。tiktok_get_audience_overlap:跨广告组、自定义受众、已保存受众和定向字段的只读受众重叠诊断。tiktok_get_audience_report:按年龄或性别读取 TikTok 受众表现报告,支持广告主、广告系列、广告组或广告层级,包括来自符合条件的 Smart+ 广告系列的投放数据。多个人口统计维度返回独立报告,而非联合分布。显式分页和原生提供商错误;不推断已配置的定向或自定义受众成员资格。tiktok_get_audiences:列出 TikTok 广告主账户的自定义和类似受众。tiktok_get_campaigns:列出 TikTok 广告主账户的广告系列。返回广告系列 ID、名称、状态、预算和目标。tiktok_get_creative_fatigue_recipes:从广告级每日报告中识别可能的创意疲劳模式,并返回只读的刷新建议。不创建、编辑或上传创意。tiktok_get_creatives:获取 TikTok 广告主账户中特定广告的创意详情(视频、图片、文本)。tiktok_get_delivery_status:聚合广告系列、广告组和广告的投放状态/操作状态,并提供简单诊断。tiktok_get_entities_raw:列出 TikTok 广告系列、广告组或广告,支持调用方选择原生字段、过滤、排序和分页。此仅 GET 的逃生通道可访问新发布的实体字段,无需等待 MCP 的精选模式。tiktok_get_events:发现广告主的像素/应用事件或可访问的跟踪诊断。使用尽力而为的端点检查,并以报告维度作为回退。tiktok_get_insights:使用当前原生/计算指标目录和查询规划查询 TikTok 广告表现洞察。 使用 tiktok://metrics 资源查看可用指标。使用 tiktok://dimensions 查看维度。 年龄/性别维度自动通过 tiktok_get_audience_report 路由到受众报告,包括广告系列和广告组层级。其他维度使用 BASIC 规划器。多个受众细分保持独立报告,绝不合并。tiktok_get_pixels:列出 TikTok 像素,并在权限允许时列出广告主的像素事件元数据。当端点不可用时,会以明确警告回退。tiktok_get_read_endpoint:高级仅 GET 的 TikTok Business API 逃生通道,用于访问尚未被专门 MCP 工具建模的文档化 JSON 读取端点。相对 v1.3 路径和 JSON 兼容查询参数会经过验证;OAuth、变更操作、下载和线索记录路径被阻止。tiktok_get_report_raw:运行原生 TikTok BASIC 或 AUDIENCE 同步报告,支持调用方选择维度和指标。AUDIENCE 支持人口统计维度,如广告系列/广告组层级的年龄/性别;tiktok_get_audience_report 提供引导路径。当当前 API 字段尚未出现在 tiktok://metrics 中使用;与 tiktok_get_insights 不同,此工具不计算别名或自动拆分不兼容的选择。tiktok_get_search_ads_maturity:从关键词/搜索词报告和可选的关键词推荐端点诊断 TikTok 搜索广告成熟度。仅只读诊断。tiktok_get_shop_catalog_diagnostics:只读 TikTok Shop/目录/电商诊断。先尝试目录报告,然后是 Shop 拍卖指标,并在目录权限不可用时返回端点警告。tiktok_get_spark_ads:在可用时从广告字段返回 Spark Ads 上下文,如果 Spark 特定字段不受支持,则采用保守回退。tiktok_get_spark_organic_joins:在权限允许时,将可访问的 Spark Ads 字段与付费主页/帖子报告以及可选的有机身份/帖子端点关联。仅只读。tiktok_get_targeting:读取已配置的广告组定向和受众引用:自定义/类似包含/排除、地理位置、语言、年龄/性别、版位、兴趣和行为。支持经典和升级版 Smart+(smartPlus:true),保留 targeting_spec 和自动定向设置。不推断投放受众或隐藏的 Smart+ 信号。使用 tiktok_get_audiences 获取受众名称/类型,使用 tiktok_get_audience_report 获取投放人口统计。tiktok_get_targeting_catalog:读取 TikTok 定向和规划目录:地理位置、语言、兴趣、行为、话题标签、搜索广告关键词创意/健康度、设备、运营商、上下文标签、内容排除和时区。tiktok_get_video_assets:在可用时,从 ad/get 和视频素材端点返回与广告关联的 TikTok 视频资产元数据。tiktok_get_write_context:在编辑或构建新配置前,读取确切的 TikTok 实体、父级设置和广告主货币/时区。仅只读。tiktok_health_check:TikTok 凭据、可访问广告主和广告主信息的只读健康检查。绝不返回令牌或密钥。tiktok_list_ad_images:列出广告主的整个图片库(file/image/ad/search):文件名、尺寸、签名、轮播可用性,以及公开提供的图片 URL,签名有效期约为三十天(image_url_expires_at 给出精确时刻)。tiktok_list_ad_videos:列出广告主的整个视频库(file/video/ad/search):文件名、时长、尺寸、签名,以及公开提供的预览和封面 URL。每个 TikTok URL 均带签名,约六小时后过期:使用前请通过 tiktok_get_asset_urls 重新解析。tiktok_list_advertisers:列出当前令牌可访问的所有 TikTok 广告主账户。返回广告主 ID、名称和状态。tiktok_rename_ad(write):重命名一个经典 TikTok 广告。不更改其预算、创意内容或状态。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_rename_adgroup(write):重命名一个经典 TikTok 广告组。不更改其预算、创意内容或状态。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_rename_campaign(write):重命名一个经典 TikTok 广告系列。不更改其预算、创意内容或状态。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_search_keywords:获取 TikTok 搜索广告的关键词建议。返回带搜索量估算的推荐关键词。tiktok_update_ad_status(write):暂停或重新激活恰好一个经典广告。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_update_adgroup_budget(write):更改 TikTok 广告组的预算。金额使用账户货币,按原样发送。默认预览。tiktok_update_adgroup_configuration(write):更新经典 TikTok 广告组。状态不变。原生目标/格式资格由 TikTok 强制执行。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_update_adgroup_status(write):暂停或重新激活 TikTok 广告组。默认预览。tiktok_update_ads(write):更新经典 TikTok 广告(视频、图片、轮播或授权的 Spark 内容)。状态不变。原生目标/格式资格由 TikTok 强制执行。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_update_campaign_budget(write):更改 TikTok 广告系列预算,使用账户货币。默认预览。tiktok_update_campaign_configuration(write):更新经典 TikTok 广告系列。状态不变。原生目标/格式资格由 TikTok 强制执行。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_update_campaign_status(write):暂停或重新激活 TikTok 广告系列。默认预览。tiktok_update_smart_plus_ad(write):更新升级版 Smart+ TikTok 广告(视频、图片、轮播或授权的 Spark 内容)。状态不变。原生目标/格式资格由 TikTok 强制执行。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_update_smart_plus_ad_status(write):暂停或重新激活恰好一个 Smart+ 广告。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_update_smart_plus_adgroup(write):更新升级版 Smart+ TikTok 广告组。状态不变。原生目标/格式资格由 TikTok 强制执行。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_update_smart_plus_adgroup_status(write):暂停或重新激活恰好一个 Smart+ 广告组。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_update_smart_plus_campaign(write):更新升级版 Smart+ TikTok 广告系列。状态不变。原生目标/格式资格由 TikTok 强制执行。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_update_smart_plus_campaign_status(write):暂停或重新激活恰好一个 Smart+ 广告系列。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_update_smart_plus_material_status(write):暂停或重新激活一个升级版 Smart+ 广告内的选定创意素材。父级广告系列、广告组和广告状态不变;共享素材库资产不被修改。默认本地预览。无自动重试;应用前会检查广告主所有权。tiktok_upload_ad_image(写入):从公开的 HTTPS 媒体 URL 或 base64 文件(最大 5 MiB)导入图片。TikTok 可能会异步处理;接受并不代表媒体已就绪。默认本地预览。不自动重试;应用前会检查广告主所有权。tiktok_upload_ad_video(写入):从公开的 HTTPS 媒体 URL 或 base64 文件(最大 5 MiB)导入视频。TikTok 可能会异步处理;接受并不代表媒体已就绪。默认本地预览。不自动重试;应用前会检查广告主所有权。tiktok_validate_query:在执行前验证 TikTok 指标/维度组合。检查维度分组规则、生命周期兼容性以及指标/维度兼容性。
Search Console(18 个工具,0 个写入)
适用于已授权且已选择的账户。
gsc_analyze_search_appearance_trends:当 GSC 暴露结构化数据和富结果趋势信号时,通过 Search Analytics 的 searchAppearance 维度分析这些信号。gsc_bulk_inspect_urls:以保守的顺序限制检查多个 URL,并返回规范化的 URL 检查结果。配额:每个资源每天 2000 次请求。gsc_cluster_queries:通过简单标记和意图信号(品牌/非品牌、疑问、类别和主题标记)对 Search Console 查询进行聚类。gsc_compare_search_types:比较 Search Console 搜索类型(网页、图片、视频、新闻、Discover 和 Google 新闻)之间的表现。gsc_detect_cannibalization:检测 Search Analytics 查询-页面行中多个页面竞争点击/展示的查询。gsc_find_losses_gains:比较两个时间段内查询或页面的表现,并返回点击/展示/点击率/平均排名的变化量。gsc_get_data_freshness:通过查询最近的每日行,检测具有 Search Analytics 数据的最新日期。gsc_get_sitemap_health:返回增强的只读站点地图健康摘要,包括状态总计、已提交/已编入索引的内容数量、警告和错误。gsc_health_check:验证 Google Search Console 只读身份验证、可见资源、配置的默认网站和权限级别,而不暴露令牌。gsc_indexation_watchlist:针对关键 URL 的只读 URL 检查监视列表。检查最多 10 个 URL,并返回警报/审查/正常评估,不存储状态。gsc_inspect_url:检查 URL 的 Google 索引状态、抓取信息、移动设备可用性、AMP 和富结果。配额:每个资源每天 2000 次请求。gsc_list_sitemaps:列出为 Search Console 资源提交的站点地图,包括处理状态和已提交/已编入索引的数量。gsc_list_sites:列出当前凭据可访问的所有 Google Search Console 资源。gsc_monitor_indexation_freshness:针对 Search Analytics 新鲜度、站点地图索引总数以及可选的小型 URL 检查样本的只读监控快照。gsc_plan_large_site_sampling:根据站点地图风险信号和 Search Analytics 页面表现,为大型网站构建只读 URL 检查采样计划。gsc_query_search_analytics:查询 Google Search Console Search Analytics。返回查询、页面、国家/地区、设备、日期和搜索展示的点击、展示、点击率和平均排名。 使用 gsc://metrics、gsc://dimensions、gsc://filters 和 gsc://compatibility 获取可用字段和规则。gsc_track_sitemap_deltas:只读站点地图增量跟踪器。获取当前站点地图快照,并与代理提供的基线进行比较;不写入任何状态。gsc_validate_query:在执行 Search Console 指标/维度/搜索类型组合之前验证其有效性。
Google Analytics 4(27 个工具,0 个写入)
适用于已授权且已选择的账户。
ga4_batch_run_pivot_reports:在一次官方 Data API 批量请求中,为同一资源运行 1-5 个独立的只读 GA4 透视报告。ga4_batch_run_reports:在一次官方 Data API 批量请求中,为同一资源运行 1-5 个独立的只读 GA4 核心报告。ga4_check_compatibility:向官方 GA4 Data API 询问哪些维度和指标与建议的核心报告选择兼容。ga4_get_audience_diagnostics:来自 Admin API 受众、Data API 定期受众列表以及观察到的 audienceName 报告回退的只读受众诊断。ga4_get_audience_export_diagnostics:只读受众导出诊断。列出现有的受众导出、状态计数,并可选择从现有导出中采样行。ga4_get_bigquery_export_diagnostics:检测 GA4 BigQuery 导出链接,并诊断导出模式、流覆盖范围、排除的事件和数据集位置。ga4_get_channel_groups:列出为 GA4 资源定义的自定义渠道组。ga4_get_custom_definitions:列出 GA4 Data API 元数据公开的自定义维度和自定义指标。自定义定义清单的只读回退。ga4_get_ecommerce_diagnostics:针对核心电子商务事件、收入指标和项目级报告,在日期范围内的只读电子商务覆盖诊断。ga4_get_event_parameters:从 GA4 元数据和事件报告中尽力而为的事件参数清单。记录 Data API 对原始参数的限制。ga4_get_key_events:使用元数据感知的 Data API 报告盘点 GA4 关键事件/转化。返回尽力而为的事件名称和计数。ga4_get_metadata:获取特定 GA4 资源可用的完整维度和指标列表。有助于发现自定义维度/指标。ga4_get_property_configuration:读取 GA4 资源详细信息以及选定的单例 Admin 设置(归因、保留、Google 信号、报告身份或用户提供的数据设置)。ga4_get_property_quotas_snapshot:从官方 v1alpha 端点读取当前 GA4 Data API 资源配额快照。这不运行报告,但 Google 仍会从剩余配额最多的类别中扣除一个资源配额令牌。ga4_get_server_side_tagging_diagnostics:来自数据流、Measurement Protocol 密钥、事件规则和流设置的尽力而为的只读服务器端标记诊断。ga4_health_check:只读 GA4 健康检查。验证配置的凭据、可访问的资源和元数据/资源访问,而不暴露 OAuth 令牌。ga4_list_accounts:列出已认证用户可访问的原始 GA4 Analytics Admin 账户(只读,自动分页)。ga4_list_admin_resources:以只读模式列出允许列表中的 GA4 Admin 集合:数据流、自定义定义、关键事件、受众、产品链接、注释、渠道组、扩展数据集、子资源/汇总配置和访问绑定。ga4_list_audience_exports:列出现有的 GA4 受众导出快照和定期受众列表,而不创建新的导出。ga4_list_properties:列出当前凭据可访问的所有 GA4 资源。返回资源 ID、显示名称、时区和货币。ga4_query_audience_export:查询现有 GA4 受众导出的行。用户/设备标识符默认被编辑;仅通过明确选择加入才包含它们。ga4_run_advanced_funnel_report:运行 GA4 Data API v1alpha runFunnelReport 端点,可选用细分/下一步操作,如果不可用则回退到只读步骤计数。ga4_run_funnel_recipe:使用每个 eventName/pagePath 步骤一个 GA4 报告运行只读可配置漏斗配方,并返回简单步骤计数。ga4_run_pivot_report:运行只读 GA4 Data API 透视报告,支持原生过滤器、排序、配额状态、多个日期范围以及最多 250,000 个透视单元格。每个透视都需要明确的限制。ga4_run_realtime_report:运行只读 GA4 Data API 实时报告。实时仅支持有限的维度和指标子集。ga4_run_report:运行具有智能查询规划的 GA4 分析报告。支持 52 个指标、63 个维度、自动分页。 使用 ga4://metrics 和 ga4://dimensions 资源获取可用字段。每个请求最多 9 个维度 + 10 个指标。ga4_validate_query:在执行之前验证指标/维度组合。检查最大限制(9 个维度、10 个指标)、电子商务规则和维度兼容性。