用途:这是 Meta Ads 技能的首次配置引导流程,用于在本地完成 Meta Marketing API 接入,以便后续拉取实时投放数据、审计账户、搭建活动与受众、生成品牌仪表盘。策略与框架部分无需配置即可使用。
主要步骤:先确认运行环境必须是本地电脑上的 Claude Code(终端 claude CLI 或桌面应用设为 Local),不支持云端 claude.ai。随后引导在 https://developers.facebook.com/apps/ 创建应用(用途选 Other,类型选 Business),添加 Marketing API 产品;在 Graph API Explorer 生成访问令牌并授予 ads_management、ads_read、business_management、read_insights 权限;该令牌约 1 小时后过期,需用 App ID 与 App Secret(app Settings > Basic)换成约 60 天的长期令牌;最后从 Meta Business Suite 的 Settings > Ad Accounts 获取形如 act_XXXXXXXXXXXXXXX 的广告账户 ID,保留 act_ 前缀。
写入配置:执行 cp .env.example .env,将 META_ACCESS_TOKEN、META_AD_ACCOUNT_ID 以及可选的 META_APP_ID / META_APP_SECRET 写入 .env。
测试连接:cd .claude/skills/meta-ads/scripts && pip install requests python-dotenv && python get_active_ads_copy.py,失败时按令牌失效、缺少 act_ 前缀、权限不足排查。
完成后可使用 /meta-ads、/meta-reporting,或用自然语言请求审计账户、查找浪费预算的活动、搭建获客活动、生成近 30 天仪表盘。限制:必须在本地 Claude Code 运行;需自行完成 Meta 应用与 API 授权;令牌会过期需定期更换;资料未提供具体价格、收费与效果数据。