AdHelm icon

AdHelm

AdHelm 是一款免费的 Apache-2.0 命令行工具,支持营销人员通过 AI agent 在本地连接自己的广告与分析账户,查看表现、审计账户状态并获取基于证据的建议。0.1.1 版本为只读模式,支持 macOS、Linux 和 Windows。

AdHelm

本地、由 agent 驱动的账户审计

AdHelm 是一款免费的开源命令行工具,用于让 AI agent 在本地检查广告与分析账户。它使用用户自己的提供商应用或密钥连接账户,报告表现、审计账户状态并生成建议,同时将决策和账户变更留给用户。

该产品在 0.1.1 版本中设计为只读工作流。它可以返回账户身份信息、固定清单和每日汇总数据,然后保留本地审计历史并导出结果以供进一步检查。AdHelm 不提供托管服务,也不会自动应用更改;其列出的写入命令尚未发布且会被拒绝。

功能

由 agent 驱动的 CLI 工作流

AI agent 可以运行 AdHelm 命令来检查已连接的账户并返回结果,无需用户直接在 shell 中操作。

本地提供商连接

用户可以在本地注册自己的提供商应用或密钥、检查连接状态、刷新访问权限、移除本地连接,并获取撤销访问权限的指导。

表现与账户读取

该工具从已连接的广告与分析账户中读取账户身份信息、固定清单和固定的每日汇总表现报告。

基于证据的审计

AdHelm 按维度审计账户状态,记录已读取和未读取的内容,并提供引用支持证据的建议,同时不更改账户设置。

本地审计历史

追加式本地历史记录可以进行验证、与外部发生的变更进行核对,并导出为确定性的 CSV 或 JSON。

报告与 agent 技能

默认输出为简洁的聊天摘要,也可按请求生成文档、电子表格或 HTML 报告;两个内置的 agent 技能用于指导诊断、提出建议和验证的工作流。

实际用途

  • 例行付费媒体审查

    营销人员可以让 AI agent 检查已连接账户的身份信息、清单和每日汇总表现,然后返回简洁摘要,用于例行审查。

  • 变更前账户诊断

    增长或营销运营从业者可以使用按维度的审计结果和引用证据,在决定是否手动进行更改之前识别账户问题。

  • 审计跟踪与核对

    团队可以保留追加式本地记录,与 AdHelm 之外进行的变更进行核对,并导出确定性的 CSV 或 JSON,用于分析或文档记录。

  • 跨账户发现

    需要评估多个广告与分析来源的用户,可以在本地连接自己的提供商应用,并在列出的实验性提供商之间使用相同的 agent 引导式发现和报告工作流。

Pros and Cons

Pros

  • 基于 Apache-2.0 许可证免费开源。
  • 支持在 macOS、Linux 和 Windows 上使用 Python 3.12 或更高版本本地运行。
  • 0.1.1 版本保持工作流为只读模式,建议均有引用证据支持。
  • 支持确定性的 CSV 和 JSON 导出,以及简洁摘要和按请求生成的报告格式。
  • 使用用户自己的提供商应用或密钥,无需托管账户或付费层级。

Cons

  • 在 0.1.1 版本中,提供商集成被标记为实验性,并被描述为经过 fixture 测试,而非在实际账户上进行试运行。
  • 用户必须自行获取提供商 API 访问权限,同时仍受提供商配额和访问级别限制。
  • 文档所述的只读范围不包括 CRM 归因或账户变更。

FAQ

AdHelm 是什么?

AdHelm 是一款命令行工具,AI agent 可以使用它在本地连接受支持的广告与分析账户、报告表现、审计账户状态并提出变更建议。

如何安装 AdHelm?

使用 `uv tool install adhelm` 或 `pipx install adhelm` 安装,然后运行 `adhelm discover`。它要求 Python 3.12 或更高版本,并支持 macOS、Linux 和 Windows。

AdHelm 支持哪些广告与分析提供商?

在 0.1.1 版本中,提供商被标记为实验性,并被描述为经过 fixture 测试,而非在实际账户上进行试运行。用户必须自行获取提供商 API 访问权限,同时适用提供商的配额和访问级别限制。

AdHelm 能更改我的广告账户吗?

AdHelm 在 0.1.1 版本中为只读模式。写入命令尚未发布且会被拒绝,因此该版本不会对广告或分析账户进行更改。

AdHelm 是否需要托管账户或订阅?

根据产品页面,无需托管服务、遥测、账户、许可证密钥或付费层级。用户注册自己的提供商应用,并将凭据保存在操作系统的凭据存储中。

Quick Facts

类别
开发者工具
格式
命令行界面
许可证
Apache-2.0
运行环境
Python 3.12+
操作系统
macOS、Linux 和 Windows
版本范围
0.1.1 只读