用途：通过 Hyper MCP 调用 Snapchat Marketing API v1，端到端规划并创建 Snapchat 广告，包括广告系列、广告组、广告、媒体上传、创意、定向、Snap Pixel 与报表。
前置条件：需安装并连接 Hyper MCP（https://app.hyperfx.ai/mcp），并在 https://app.hyperfx.ai/apps 连接 Snapchat Ads 集成（具备广告账户权限的 Snap Business 账户）。若 search("snapchat_ads_list_organizations") 找不到该工具，应停止并提示用户启用 Hyper MCP 并连接 Snapchat Ads。创建广告组或投放广告还需广告账户有可用资金来源；广告系列、媒体与创意无需资金即可创建。
调用方式：MCP 客户端（Claude、Cursor、Codex、ChatGPT）用 search("<目标>") 再 describe("<名称>")，然后 call("<名称>", {...})；Hyper CLI 用 hyperai search "<目标>"、hyperai describe <name>、hyperai call <name> --json '{...}'。工具未找到说明集成未连接或未启用。
主要能力：组织与账户查询；广告系列、广告组、广告的增删改查；创意与媒体（含上传）；报表与异步报表；Snap Pixel 与自定义转化查询；受众细分（含客户名单上传）；受众规模、竞价估算与受众洞察；定向搜索。参考文件位于 references/，如 references/discovery.md、campaign-creation.md、targeting.md、conversions-and-reporting.md。
关键规则：所有预算与出价使用微货币，$1.00 = 1,000,000 micros，$50/天 = 50000000，广告系列最低日预算/总支出上限为 $20（20000000）。创建广告系列、广告组、广告时状态设为 PAUSED，未经用户明确审核不得上线。更新为 JSON-Patch 局部更新，只传需改字段并挂在父实体上：update_campaign 需 ad_account_id，update_ad_squad 需 campaign_id，update_ad 需 ad_squad_id。账户级统计（entity_type="adaccounts"）仅支持 fields="spend"。无 time_range 预设，需传 start_time 与 end_time（ISO 8601），省略则返回生命周期总计。广告组 billing_event 恒为 IMPRESSION；bid_strategy 为 LOWEST_COST_WITH_MAX_BID 或 TARGET_COST 时必填 bid_micro，AUTO_BID 时省略。创意需 top_snap_media_id 与标题（≤34 字符），brand_name ≤32 字符。客户名单需已规范化并 SHA-256 哈希的标识符，每次调用一种类型，最多 100,000 条，禁止发送原始 PII，匹配为异步。
工作流：发现组织/账户 → 审计账户 → 调研（目标、受众、预算、素材）→ 确认策略 → 创建广告系列（PAUSED）→ 上传媒体 → 创建创意 → 创建广告组 → 创建广告 → 与用户复核 → 激活。
限制：创意创建失败常因缺少 profile_properties.profile_id；广告创建类型不匹配时可省略 type 由其推导；预测返回 OE101 时该账户类型可能不支持，改用 Ads Manager；媒体需符合 1080×1920 规格且 media_status 为 READY；上传失败可改用 file_id；广告组创建在未充值账户会失败；大于 32 MB 媒体自动分块上传（最高 1 GB）。