SuperAPI AI 工具集

ads-start

营销与增长

查看项目

更新于 10-15 22:11

技能介绍

用途:ads-start 是 claude-ads 的引导式首次运行/重入向导,负责生成并维护 ~/.claude-ads/profile.json,是新用户的规范入口,也是重新编辑已保存上下文的唯一位置。向导本身不会自动调用其他 /ads 命令,结束时只建议下一条命令并退出。

主要能力:一次只问一个问题,每步用 AskUserQuestion 提供 2–4 个选项,并在问下一题前通过 python3 scripts/profile.py set <dot.path> <value> 写入答案,支持部分完成后续恢复。采集内容包括行业、月广告花费、主要目标、活跃平台(Meta/Google/TikTok)。随后按平台逐一选择连接层级:MCP 服务器、直连 API(免费,OAuth 一次)、手动导出、或跳过。OAuth/MCP 设置按步骤逐条指引,等待用户确认后运行验证调用并诊断错误,每平台最多重试 3 次,之后可跳过。

使用方式:无参数时检测首次运行或重入;status 打印五行摘要后退出;edit 跳到编辑选择器;reset 经确认后调用 python3 scripts/profile.py reset --yes 并从头开始。首次运行会执行 python3 scripts/profile.py init。验证成功后写入 ad_account_id、connected_at、last_verified_at。可选流程包括 Meta for Developers 账号创建与 Zernio 发布(免费层覆盖 2 个已连接账号)。最后推荐 /ads audit、/ads <单平台>、/ads plan <industry> 或直接退出,并打印确切的下一条命令而不执行。

限制:不在 profile 中存储密钥,令牌与 API 密钥只放环境变量,profile 仅记录 api_key_present 的 true/false。若 MCP 工具在当前会话不可用,则回退为手动粘贴账号 ID 并跳过实时调用,记录 last_verified_at 为 null。若 ~/.claude-ads/ 只读,需用户先修复权限。向导不生成报告文件,只写 profile.json 并输出面向用户的文字。其他 /ads 命令通过 python3 scripts/profile.py get 读取该配置。