AdHelm icon

AdHelm

AdHelmは無料のApache-2.0準拠CLIツール。AIエージェントで広告・分析アカウントをローカル接続し、成果確認、状態監査、根拠に基づく提案を実行。v0.1.1は読み取り専用でmacOS・Linux・Windowsに対応。

AdHelm

ローカルで行うエージェント駆動のアカウント監査

AdHelmは、AIエージェントを使って広告・分析アカウントをローカルで調査できる、無料のオープンソースコマンドラインツールです。ユーザー自身のプロバイダーアプリケーションまたはキーを使ってアカウントに接続し、成果を報告し、アカウント状態を監査して提案を作成しますが、判断とアカウント変更はユーザーに委ねられます。

バージョン0.1.1では、読み取り専用のワークフローとして設計されています。アカウント識別情報、固定されたインベントリ、日次集計データを取得し、ローカルの監査履歴を保持して、さらなる確認のために結果をエクスポートできます。AdHelmはホステッドサービスを提供せず、変更を自動適用しません。記載されている書き込みコマンドは未リリースであり、拒否されます。

機能

エージェント駆動のCLIワークフロー

AIエージェントがAdHelmのコマンドを実行して接続済みアカウントを調査し、ユーザーがシェルを直接操作しなくても結果を返せます。

ローカルなプロバイダー接続

ユーザーは自身のプロバイダーアプリケーションまたはキーをローカルで登録し、接続状態の確認、アクセスの更新、ローカル接続の削除を行い、失効手順の案内を受けられます。

成果とアカウント情報の読み取り

接続済みの広告・分析アカウントから、アカウント識別情報、固定されたインベントリ、固定された日次集計パフォーマンスレポートを読み取ります。

根拠に基づく監査

AdHelmはディメンション別にアカウント状態を監査し、読み取った内容と読み取らなかった内容を記録します。また、アカウント設定を変更せず、裏付けとなる根拠を引用した提案を提供します。

ローカル監査履歴

追記専用のローカル履歴を検証し、帯域外で行われた変更と突き合わせ、決定論的なCSVまたはJSONとしてエクスポートできます。

レポートとエージェントスキル

デフォルトの出力は簡潔なチャット要約です。必要に応じてドキュメント、スプレッドシート、HTMLレポートを利用でき、同梱された2つのエージェントスキルが診断、提案、検証のワークフローを案内します。

実用的な用途

  • 有料メディアの定期確認

    マーケターはAIエージェントに、接続済みアカウントの識別情報、インベントリ、日次集計パフォーマンスを調査させ、定期確認用の簡潔な要約を返させることができます。

  • 変更前のアカウント診断

    グロースまたはマーケティングオペレーションの担当者は、ディメンションレベルの監査結果と引用された根拠を使ってアカウントの問題を特定し、手動で変更するかどうかを判断する前の診断を行えます。

  • 監査証跡と突き合わせ

    チームは追記専用のローカル記録を保持し、AdHelm外で行われた変更と突き合わせ、分析や文書化のために決定論的なCSVまたはJSONとしてエクスポートできます。

  • アカウント横断の探索

    複数の広告・分析ソースを評価するユーザーは、自身のプロバイダーアプリケーションをローカルで接続し、記載された実験的プロバイダー間で同じエージェント主導の探索・レポートワークフローを利用できます。

Pros and Cons

Pros

  • Apache-2.0ライセンスのもとで無料かつオープンソースです。
  • Python 3.12以降で、macOS、Linux、Windows上でローカル実行できます。
  • バージョン0.1.1ではワークフローが読み取り専用に保たれ、提案は引用された根拠によって裏付けられます。
  • 決定論的なCSVおよびJSONエクスポートに加え、簡潔な要約と要求した形式のレポートに対応します。
  • ホステッドアカウントや有料プランを必要とせず、ユーザー自身のプロバイダーアプリケーションまたはキーを使用します。

Cons

  • バージョン0.1.1ではプロバイダー連携が実験的とされており、実際のアカウントで試験運用されたものではなく、フィクスチャでテストされたものとして説明されています。
  • ユーザー自身でプロバイダーAPIへのアクセス権を取得する必要があり、プロバイダーのクォータとアクセス階層が引き続き適用されます。
  • 文書化された読み取り専用の範囲には、CRMアトリビューションやアカウント変更は含まれません。

FAQ

AdHelmとは何ですか?

AdHelmは、AIエージェントが対応する広告・分析アカウントにローカル接続し、成果を報告し、アカウント状態を監査して、変更を提案できるコマンドラインツールです。

AdHelmをインストールするにはどうすればよいですか?

`uv tool install adhelm`または`pipx install adhelm`でインストールし、その後`adhelm discover`を実行します。Python 3.12以降が必要で、macOS、Linux、Windowsに対応しています。

AdHelmはどの広告・分析プロバイダーに対応していますか?

バージョン0.1.1では、プロバイダーは実験的と表示されており、実際のアカウントで試験運用されたものではなく、フィクスチャでテストされたものとして説明されています。ユーザー自身でプロバイダーAPIへのアクセス権を取得する必要があり、プロバイダーのクォータとアクセス階層が適用されます。

AdHelmで広告アカウントを変更できますか?

AdHelmはバージョン0.1.1では読み取り専用です。書き込みコマンドは未リリースで拒否されるため、このバージョンでは広告・分析アカウントに変更を加えません。

AdHelmにホステッドアカウントやサブスクリプションは必要ですか?

製品ページによると、ホステッドサービス、テレメトリ、アカウント、ライセンスキー、有料プランは必要ありません。ユーザーは自身のプロバイダーアプリケーションを登録し、認証情報をオペレーティングシステムの認証情報ストアに保管します。

Quick Facts

カテゴリー
開発者向けツール
形式
コマンドラインインターフェース
ライセンス
Apache-2.0
ランタイム
Python 3.12以降
対応オペレーティングシステム
macOS、Linux、Windows
バージョンの範囲
0.1.1では読み取り専用