imrenagicom/adsctl

这是什么？

核心功能

• 01默认输出带版本号的 JSON 结构，便于 AI 代理与 shell 脚本调用。
• 02广告写操作需显式指定 profile 与账户，并支持 dry-run 预览。
• 03从外部文件或环境变量读取 Meta 访问令牌，配置中不保存令牌值。
• 04提供原生 Insights 查询、异步任务、汇总、排行以及 CSV/JSONL 导出。
• 05运行确定性的只读监控规则，并可比较账户快照之间的变化。
• 06支持可恢复的多步骤广告发布，带状态日志与对账功能。

适用场景

• 让 AI 代理拉取广告表现报表并标记投放异常。
• 在 CI 或定时任务中执行只读账户检查，发现问题时使单次任务失败。
• 通过脚本批量暂停广告或调整多个客户账户的预算。
• 在自动化流程中发布 Instagram 图文、Reels 或轮播内容。

快速上手

1. 1

   运行 README 中的官方安装脚本

2. 2

   在当前 shell 中加载 PATH 配置

   source "$HOME/.adsctl/env"
3. 3

   检查 CLI 是否可以运行

   adsctl version

使用前须知

• !目前仅实现了 Meta 广告，Google 仅是未来计划的适配器。
• !你需要自行创建 Meta 开发者应用并提供访问令牌，CLI 不处理 OAuth。
• !持久化的投放和监控执行不支持 Windows。

收录于专题

标签

常见问题

adsctl 是什么？

面向 AI 代理与脚本的 Go 命令行工具，用于查看、监控、报表分析和发布 Meta 广告。 adsctl 是一个用 Go 和 Cobra 编写的命令行工具，用于查询、监控、创建和管理广告投放。目前首先支持 Meta（Facebook 与 Instagram 广告），Google 适配器在规划中。默认输出 JSON，写操作必须显式指定账户范围，凭证从外部令牌文件或环境变量读取，不存入配置。

adsctl 可以免费使用吗？用的什么许可证？

adsctl 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

adsctl 还在维护吗？

活跃维护中。adsctl 最近一次提交是在 2026年11月5日。

adsctl 适合用来做什么？

让 AI 代理拉取广告表现报表并标记投放异常。 在 CI 或定时任务中执行只读账户检查，发现问题时使单次任务失败。 通过脚本批量暂停广告或调整多个客户账户的预算。 在自动化流程中发布 Instagram 图文、Reels 或轮播内容。

adsctl 怎么安装和运行？

运行 README 中的官方安装脚本 在当前 shell 中加载 PATH 配置: source "$HOME/.adsctl/env" 检查 CLI 是否可以运行: adsctl version

在哪里获取 adsctl？

源代码和安装说明在 GitHub 上：https://github.com/imrenagicom/adsctl