用途:该技能用于端到端规划和管理 OpenAI Ads(ChatGPT 广告)广告系列,所有操作经由 https://api.ads.openai.com/v1,需先安装并连接 Hyper MCP(https://app.hyperfx.ai/mcp),并在 https://app.hyperfx.ai/apps 连接 OpenAI Ads 集成(API key 仅绑定一个广告账户)。若 search("openai_ads_ad_accounts_get") 找不到该工具,应停止并提示用户启用 Hyper MCP 并连接 OpenAI Ads;连接后用 openai_ads_health_check() 验证密钥。
主要能力:账户查询与状态管理、广告系列/广告组/广告的创建、查询、更新、暂停、激活、归档;图片上传与地理定向查询;自定义受众创建与管理;转化像素、API key、事件设置与转化洞察;账户/系列/广告组/整体洞察;缓存快照读取与刷新。创意类型为 chat_card 和 product_ad_template。
使用方式:在 MCP 客户端中用 search 查找工具、describe 查看、call 调用;在 Hyper CLI 中用 hyperai search、hyperai describe、hyperai call <name> --json '{...}'。建议先执行账户发现(openai_ads_ad_accounts_get、openai_ads_campaigns_list、openai_ads_list_custom_audiences、openai_ads_list_conversion_event_settings),优先读取 openai_ads_caches_get(),为空时执行 openai_ads_caches_refresh()。创建前需与用户确认目标、预算、地理定向、受众、创意文案与图片、最高出价、context_hints 及转化事件设置。
限制与规则:认证为 bearer API key 而非 OAuth,无列出广告账户的接口;金额输入均为整数微(micros),$1.00 = 1_000_000,daily_spend_limit_micros 最低 1_000_000,max_bid_micros 上限 100_000_000,洞察返回为普通浮点数;创建时一律 status="paused",经用户批准后再激活;新广告 review_status 为 in_review,未 approved 不投放;chat_card 需先上传图片(PNG、1024x1024、≤1 MB)取得 file_id 并传 target_url;不支持地理排除;归档不可逆。创意生成与跨平台投放不在本技能范围内。