名称： adcp-advertising
displayName: AdCP 广告
描述： 利用 AI 自动化广告活动。创建广告、购买媒体、管理广告预算、发现广告库存、投放展示广告、视频广告、CTV 广告系列，并优化广告效果。适用于营销自动化、程序化广告、媒体购买、广告管理、广告系列优化、创意管理和效果追踪。使用自然语言启动 Facebook 广告、Google 广告、展示广告、视频营销和多渠道广告系列。支持广告定向、受众细分、投资回报率追踪和自动竞价。
作者： AdCP 社区
许可证： MIT
主页： https://docs.adcontextprotocol.org
仓库： https://github.com/edyyy62/openclaw-adcp
category: advertising
subcategory: marketing-automation
type: agent
关键词：
- advertising
- ads
- marketing
- campaigns
- adcp
- programmatic
- media-buying
- display-ads
- video-ads
- facebook-ads
- google-ads
- ctv
- connected-tv
- marketing-automation
- ad-management
- campaign-optimization
- targeting
- roi-tracking
- performance-marketing
- retargeting
利用 AI 自动化您的广告活动。 此技能使 OpenClaw 智能体能够通过自然语言指令，发现广告库存、启动广告系列、管理创意素材，并优化展示、视频、CTV、音频等渠道的效果。
无需操作面板。无需填写表单。无需广告平台专业知识。
营销团队 - 投放 Facebook 广告、Google 广告和多渠道广告系列
媒体购买方 - 跨发布商管理程序化广告支出
广告代理商 - 自动化客户广告系列管理和报告
电商品牌 - 启动产品广告和再营销广告系列
初创公司 - 利用 AI 驱动的自动化进行精益营销
跳过学习曲线 - 无需掌握复杂的广告平台
节省时间 - 5 分钟启动，而非数小时的手动设置
更明智地支出 - AI 自动将预算优化给表现最佳者
更快扩展 - 通过简单指令管理无限广告系列
无风险测试 - 包含公共测试智能体，无需设置
官方 AdCP 仓库: https://github.com/adcontextprotocol/adcp
官方 AdCP 文档: https://docs.adcontextprotocol.org
完整文档索引: https://docs.adcontextprotocol.org/llms.txt
当用户询问以下内容时触发此技能：
广告系列管理
- "创建一个展示广告系列"
- "为我的产品投放 Facebook 广告"
- "设置一个 5000 美元的视频广告活动"
- "暂停我表现不佳的广告系列"
广告发现与媒体购买
- "寻找奢侈品牌的广告库存"
- "向我展示主要城市的 CTV 广告位"
- "有哪些展示广告选项可用？"
- "为一家科技初创公司购买媒体"
创意素材管理
- "上传这些横幅图片"
- "哪个创意素材表现最好？"
- "将视频广告添加到我的广告系列"
- "管理我的广告素材库"
效果与优化
- "我的广告系列表现如何？"
- "按渠道展示投资回报率"
- "优化我的广告支出"
- "将预算重新分配给表现最佳者"
- "追踪展示次数和点击率"
定向与受众
- "定向加州的专业人士"
- "设置人口统计定向"
- "创建一个再营销广告系列"
- "按设备类型和一天中的时间定向"
无需设置。 使用包含的测试智能体尝试所有功能：
步骤 1：发现可用功能
"向我展示广告功能"
浏览可用渠道、发布商和格式。
步骤 2：查找广告库存
"为一家科技初创公司寻找展示广告，预算 5000 美元"
AI 搜索并显示匹配的产品及定价。
步骤 3：启动广告系列
"使用产品 prod_123 创建广告系列，预算 5000 美元，定向加州科技专业人士"
广告系列即时上线。
步骤 4：上传您的广告
"将这些横幅图片作为创意素材上传"
拖放文件，即时获取创意 ID。
步骤 5：监控效果
"展示广告系列指标和投资回报率"
实时展示次数、点击次数、点击率、支出。
快速启动广告系列：
用户："我需要为我的 SaaS 产品投放展示广告"
智能体：[发现产品] "找到 5 个展示广告包。需要详细信息吗？"
用户："使用产品 1 创建广告系列，预算 1 万美元，定向 CTO"
智能体：[创建广告系列] "广告系列已上线！ID：mb_abc123"
效果优化：
用户："我的视频广告表现如何？"
智能体：[展示指标] "广告包 A：点击率 2.3%，广告包 B：点击率 0.8%"
用户："将 B 的 5000 美元预算转移到 A"
智能体：[重新分配] "预算已更新。广告包 A 现在为 1.5 万美元"
多渠道广告系列：
用户："启动全渠道广告系列：加州展示广告，纽约市视频广告，总计 5 万美元"
智能体：[创建广告包] "跨展示和视频创建了 3 个广告包"
自然交流。此技能理解：
- 预算："5000 美元"、"五千美元"、"5k 预算"
- 地理位置："加州"、"美国主要城市"、"纽约和洛杉矶"
- 受众："科技专业人士"、"25-45 岁"、"高收入"
- 目标："品牌知名度"、"推动转化"、"增加销量"
1. 发现阶段
"为奢侈品牌寻找视频广告"
↓ 智能体搜索库存
↓ 显示匹配的产品及定价
↓ 解释定向和格式
2. 广告系列创建
"使用产品 1 创建广告系列，2.5 万美元，定向专业人士"
↓ 智能体创建媒体购买
↓ 设置定向叠加层
↓ 返回广告系列 ID 和状态
3. 创意素材管理
"上传我的横幅广告"
↓ 智能体同步创意素材
↓ 分配给广告系列
↓ 返回创意 ID
4. 监控与优化
"展示效果"
↓ 智能体获取投放数据
↓ 按广告包/创意展示指标
↓ 建议优化方案
const campaign = await testAgent.createMediaBuy({
buyer_ref: 'campaign-2026-q1',
brand_manifest: { url: 'https://acme.com' },
packages: [{ product_id: 'premium_display', budget: 10000 }]
});
await testAgent.syncCreatives({
creatives: [{
buyer_ref: 'banner-300x250',
url: 'https://cdn.acme.com/banner.jpg'
}]
});
const delivery = await testAgent.getMediaBuyDelivery({
media_buy_id: 'mb_abc123'
});
console.log(`点击率：${delivery.totals.ctr}%，支出：$${delivery.totals.spend}`);
完整 API 文档请参阅 REFERENCE.md，详细工作流请参阅 EXAMPLES.md。
AdCP 为完整的广告生命周期提供了 8 项标准化任务。更多信息请参阅媒体购买协议文档。
完整任务参考：https://docs.adcontextprotocol.org/docs/media-buy/task-reference/
可以通过两种方式提供品牌背景信息：
URL 引用（推荐 - 智能体获取品牌信息）：
{
"brand_manifest": {
"url": "https://brand.com"
}
}
内联清单（完整的品牌详细信息）：
{
"brand_manifest": {
"name": "品牌名称",
"url": "https://brand.com",
"tagline": "品牌标语",
"colors": { "primary": "#FF0000" },
"logo": { "url": "https://cdn.brand.com/logo.png" }
}
}
产品支持多种定价模型：
- CPM（每千次展示成本） - 每 1000 次展示的固定价格
- CPM-Auction - 基于竞价的展示定价
- CPCV（每完成观看成本） - 视频完播
- Flat-Fee - 固定广告系列成本
- CPP（每百分点成本） - 覆盖受众的百分比
对于竞价定价，请在您的广告包中包含 bid_price。
AdCP 不是实时协议。操作可能需要：
- 约 1 秒 - 简单查询（格式、创意列表）
- 约 60 秒 - AI/推理操作（产品发现）
- 分钟到天 - 需要人工审批的操作（广告系列创建）
始终检查响应中的 status 字段：
- completed - 操作成功完成
- pending - 等待审批或处理中
- failed - 操作失败（检查错误详情）
对广告系列应用定向叠加层：
{
targeting_overlay: {
geo: {
included: ['US-CA', 'US-NY'], // DMA 代码或区域
excluded: ['US-TX']
},
demographics: {
age_ranges: [{ min: 25, max: 44 }],
genders: ['M', 'F']
},
behavioral: {
interests: ['technology', 'gaming'],
purchase_intent: ['consumer_electronics']
},
contextual: {
keywords: ['innovation', 'design'],
categories: ['IAB19'] // 技术与计算
}
}
}
// 1. 发现功能
const caps = await agent.getAdcpCapabilities({});
// 2. 查找产品
const products = await agent.getProducts({
brief: '针对科技初创公司的 2026 年第一季度品牌知名度广告系列',
brand_manifest: { url: 'https://startup.com' },
filters: { channels: ['display', 'video'] }
});
// 3. 检查创意素材格式
const formats = await agent.listCreativeFormats({
format_types: ['display', 'video']
});
// 4. 创建广告系列
const campaign = await agent.createMediaBuy({
buyer_ref: 'q1-2026-awareness',
brand_manifest: { url: 'https://startup.com' },
packages: [
{
buyer_ref: 'pkg-001',
product_id: products.products[0].product_id,
pricing_option_id: 'cpm-standard',
budget: 15000
}
],
start_time: { type: 'asap' },
end_time: '2026-03-31T23:59:59Z'
});
// 5. 上传创意素材
await agent.syncCreatives({
creatives: [...], // 您的创意素材
assignments: {
'creative_001': ['pkg-001']
}
});
// 6. 监控效果
const delivery = await agent.getMediaBuyDelivery({
media_buy_id: campaign.media_buy_id
});
// 暂停、调整预算并恢复广告系列
await agent.updateMediaBuy({
media_buy_id: 'mb_abc123',
updates: {
status: 'paused',
budget_change: 5000, // 增加 5000 美元
end_time: '2026-04-30T23:59:59Z'
}
});
// 调整后恢复
await agent.updateMediaBuy({
media_buy_id: 'mb_abc123',
updates: { status: 'active' }
});
更多工作流示例：请参阅 EXAMPLES.md 了解完整的广告系列场景，包括创意素材管理、多渠道广告系列和优化工作流。
用于开发和测试的公共测试智能体：
智能体 URL：https://test-agent.adcontextprotocol.org/mcp
认证令牌：1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ
import { testAgent } from '@adcp/client/testing';
// 测试智能体无需认证
const result = await testAgent.getProducts({
brief: '测试广告系列',
brand_manifest: { url: 'https://example.com' }
});
交互式测试地址：testing.adcontextprotocol.org
常见错误模式：
400 错误请求 - 参数无效：
{
"error": {
"code": "VALIDATION_ERROR",
"message": "预算必须大于 0",
"field": "packages[0].budget"
}
}
401 未授权 - 缺少或认证无效：
{
"error": {
"code": "UNAUTHORIZED",
"message": "认证令牌无效"
}
}
404 未找到 - ID 引用无效：
{
"error": {
"code": "NOT_FOUND",
"message": "未找到产品",
"resource": "product_id: premium_video_30s"
}
}
处理响应前始终检查错误：
if (result.error) {
console.error(`错误：${result.error.message}`);
return;
}
在发出其他请求之前，先调用 get_adcp_capabilities 以了解智能体支持的功能。
使用描述性的 buyer_ref 值以便追踪：
- 推荐：'campaign-2026-q1-tech-launch'
- 避免：'c1'、'test'、'abc'
检查 status 字段，并为待处理操作实现轮询：
let status = 'pending';
while (status === 'pending') {
await sleep(5000); // 等待 5 秒
const update = await agent.getMediaBuyDelivery({
media_buy_id: campaign.media_buy_id
});
status = update.status;
}
更好的简报带来更好的产品匹配：
- 推荐：'针对 35-54 岁主要都市区高收入专业人士的奢侈汽车品牌优质视频库存。专注于品牌知名度，完播率高于 70%。'
- 避免：'视频广告'、'需要广告'
在上传之前，始终检查 list_creative_formats 以确保您的创意素材符合要求。
定期检查投放指标以确保广告系列进度正常：
const delivery = await agent.getMediaBuyDelivery({
media_buy_id: campaign.media_buy_id
});
const pacing = delivery.delivery.spend / delivery.delivery.budget;
console.log(`预算进度：${(pacing * 100).toFixed(1)}%`);