MetaAds 是面向创业者/投放人员的 Claude 技能,通过 Meta(Facebook/Instagram)Marketing API 发布、管理并分析广告活动,并内置首次使用引导。它会按用户意图路由到不同工作流:设置/配置(Setup.md)、发布活动(PublishCampaign.md)、效果分析(AnalyzePerformance.md),以及直接调用脚本管理活动状态。
主要能力:引导完成 Business Manager→开发者应用→令牌→.env 的配置,支持 System User(不过期)或 User Token(60 天,可自动刷新);上传本地图片并创建完整活动层级(campaign→ad set→creative→ad),支持 Advantage+ 灵活创意;创建对象默认暂停以便人工复核;以 JSON 配置驱动,可复现。分析方面提供账户级摘要及 DTC 基准(CTR、CPM、CPA、ROAS),campaign/ad set/ad 级指标,每日趋势,受众细分(年龄、性别、平台、设备),数据同步到 Analytics/meta-ads/,并支持 CSV 导出。管理方面支持列出活动、查看层级、暂停/恢复。
使用方式:脚本 tools/Publish.py 用于创建、上传、暂停/恢复,tools/Analytics.py 用于指标、细分、同步与导出;二者使用 PEP 723 内联依赖,直接从技能目录用 uv run 运行,无需安装。需从项目根目录运行以便加载 .env。示例:uv run ~/.claude/skills/MetaAds/tools/Publish.py --check、uv run ~/.claude/skills/MetaAds/tools/Analytics.py --summary。前置条件:已安装 uv(未安装可用 curl -LsSf https://astral.sh/uv/install.sh | sh)。
环境变量:META_ADS_ACCESS_TOKEN 必填;META_ADS_ACCOUNT_ID 必填(带 act_ 前缀);FACEBOOK_APP_ID、FACEBOOK_APP_SECRET 用于刷新。
限制与注意:配置中 daily_budget 以分为单位;genders 0=全部、1=男、2=女;{{ad.name}} 为动态参数。资料未提供具体收费、价格、平台或效果保证,亦未说明其他限制,缺失事实暂未提供。