AdsGPT

面向 AI 客户端的 AdsGPT

在你的 AI 客户端中，为组织连接到 AdsGPT 的广告平台（例如 Google Ads）创建、审核和优化广告系列。此软件包为 Claude、Codex 和 Grok 添加了两项内容：

• AdsGPT MCP 服务，通过你的 AdsGPT 账户读取和修改广告账户。
• AdsGPT skills，用于指导模型完成各项任务的说明：如何使用平台的创建工具创建广告系列、如何在各格式的限制内撰写广告、如何审核和优化支出，以及各平台和广告系列类型的规则。

MCP 服务无需 skills 即可运行；skills 能让模型提出恰当的问题，并在首次尝试时就正确创建每个广告系列。

你需要一个连接了广告账户的 AdsGPT 账户。除非你另有要求，否则新广告系列会以暂停状态创建；每个会进行修改的工具都会明确说明这一点，因此客户端可以在执行前征求你的批准。

安装

Claude Code

/plugin marketplace add adsgpt-dev/agent-plugins
/plugin install adsgpt@adsgpt

然后运行 /mcp，选择 plugin:adsgpt:adsgpt，并使用你的 AdsGPT 账户登录。

Claude（网页和桌面版）

在 Customize > Plugins 中，添加 marketplace adsgpt-dev/agent-plugins，并安装 AdsGPT。然后从插件的 Connectors 标签页连接 AdsGPT 服务并登录。

Codex 和 ChatGPT 桌面应用

codex plugin marketplace add adsgpt-dev/agent-plugins

然后在 Codex 中打开 /plugins，或打开 ChatGPT 桌面应用的插件，从 adsgpt 安装 AdsGPT 并开始新会话。客户端提示时，使用你的 AdsGPT 账户登录。

Grok

添加 marketplace adsgpt-dev/agent-plugins，并从 adsgpt 安装 adsgpt。Grok 会在首次使用时使用你的 AdsGPT 账户登录。

它运行、发送和读取的内容

• 不会在你的设备上运行任何内容。 此软件包不包含脚本、钩子、命令或二进制文件：只有供模型阅读的 Markdown 格式 skills、各客户端的清单，以及 MCP 服务地址。skills 不会从其他任何地方获取指令。
• 一个远程服务： https://mcp.adsgpt.dev，通过 HTTPS（.mcp.json）连接。客户端使用 OAuth 2.1 登录并保存令牌；它会请求 ads:read 权限，并在工具首次进行修改时请求 ads:write 权限。
• 发送到服务的内容： 客户端模型对工具发起的调用及其输入，例如账户 ID、你要求的报告和时间段、新广告系列及其预算、定向设置和广告、广告文案、图片 URL、YouTube 链接或着陆页 URL。绝不会发送你的对话内容。
• 服务对这些内容的处理： 通过各平台的 API 读取和修改组织连接到 AdsGPT 的广告账户，并在你的 AdsGPT 组织中保留每项修改的日志。它会下载你通过 URL 提供的图片进行检查，并将其缺少的图片上传到广告账户；每次修改发送着陆页时，它也会打开该页面以检查是否正常运行。

隐私政策说明了 AdsGPT 存储和共享哪些内容。

工具

工具	功能说明	是否会更改内容
list_accounts	列出已连接的广告账户和可连接的平台。	否
google_ads_report	报告账户的效果、预算、建议、政策问题和变更。	否
google_ads_compare_periods	将某个时间段与之前的时间段进行比较，显示变化最大的内容和所做的变更。	否
google_ads_get_campaign	读取广告系列及变更所需的各个部分，从结构到定位。	否
google_ads_get_ads	读取广告的文案、图片和 Google 审批状态。	否
google_ads_list_assets	列出账户中的图片和视频。	否
google_ads_list_negative_keyword_lists	列出账户的共享否定关键字列表。	否
google_ads_research_keywords	根据词语或网页查找关键字创意及其月搜索量和出价。	否
google_ads_forecast_keywords	根据出价和预算预测关键字的点击次数、费用和转化次数。	否
google_ads_search_targeting	按名称查找地点、语言、兴趣、受众和主题。	否
google_ads_create_campaign	创建任意类型的广告系列，并设置预算、定位和广告；除非另有要求，否则创建后会暂停。	是
google_ads_create_ad_group	创建广告组，并添加首条广告；对于搜索广告系列，还会添加关键字。	是
google_ads_create_ad	在广告组中创建广告。	是
google_ads_create_asset_group	创建 Performance Max 素材资源组。	是
google_ads_create_conversion_action	创建转化操作。	是
google_ads_create_negative_keyword_list	创建共享否定关键字列表，并可选择将其应用于广告系列。	是
google_ads_upload_images	将图片上传到账户素材库。	是
google_ads_add_keywords	向广告组添加关键字。	是
google_ads_add_negative_keywords	向广告系列或共享列表添加否定关键字。	是
google_ads_attach_negative_keyword_list	将共享否定关键字列表应用于广告系列。	是
google_ads_add_extensions	添加附加链接、宣传信息、结构化摘要、电话号码、商家名称或徽标。	是
google_ads_add_targeting	添加地点、语言、受众和其他定位条件。	是
google_ads_set_targeting	替换广告系列的广告投放时间安排或设备出价调整，或广告组的人口统计特征。	是
google_ads_add_labels	为广告系列、广告组或广告添加标签。	是
google_ads_update_budget	更改广告系列的预算。	是
google_ads_update_status	暂停或启用广告系列、广告组、素材资源组、广告、关键字或附加信息。	是
google_ads_update_bid_strategy	更改广告系列的出价策略及其目标。	是
google_ads_update_campaign_settings	更改广告系列的名称、日期、网络、跟踪、转化目标和其他设置。	是
google_ads_update_ad_group	更改广告组的名称、出价、轮播、跟踪或受众。	是
google_ads_update_ad	更改搜索广告的文案或着陆页。	是
google_ads_update_asset_group	更改 Performance Max 素材资源组的素材资源、着陆页或受众信号。	是
google_ads_update_keywords	更改关键字的出价或着陆页。	是
google_ads_update_conversion_action	更改转化操作的名称、类别、计数方式、价值或状态。	是
google_ads_apply_recommendations	应用 Google 的建议。	是
google_ads_dismiss_recommendations	忽略 Google 的建议。	是
google_ads_remove_keywords	移除关键字。	是
google_ads_remove_negative_keywords	移除否定关键字。	是
google_ads_remove_extensions	取消关联附加信息；其素材资源会保留在素材库中。	是
google_ads_remove_targeting	移除地点、受众和其他定位条件。	是
google_ads_remove_labels	移除标签。	是
google_ads_remove_campaigns_groups_or_ads	永久移除广告系列、广告组、素材资源组或广告。	是
只有在你的组织连接了 Google Ads 后，google_ads_* 工具才会出现。

技能

技能	涵盖内容
adsgpt-agent	关于你的广告账户的各类请求所遵循的规则。
adsgpt-create-campaign	创建广告系列，从确定目标到创建广告系列。
adsgpt-google-ads	Google Ads：其工具、报告、目标和广告系列类型。
adsgpt-write-ads	根据品牌事实撰写广告文案，并遵守各格式的限制。
adsgpt-optimize	审查效果并优化支出。

关于此文件夹

AdsGPT 从其自己的代码仓库发布此插件：此处的技能是其副本，每次发布时都会替换。 请在 adsgpt-dev/agent-plugins 的问题跟踪中报告问题。

许可证

MIT（LICENSE）。