imrenagicom/adsctl

これは何？

主な機能

• 01バージョン付きのJSONエンベロープを標準で返すため、AIエージェントやシェルスクリプトでの利用に適しています。
• 02広告への書き込み操作では、プロフィールとアカウントの明示的な指定が必要で、dry-runプレビューにも対応します。
• 03Metaのアクセストークンは外部ファイルまたは環境変数から読み込み、設定ファイルには保存しません。
• 04ネイティブInsightsのクエリ、非同期ジョブ、要約、ランキング、CSV/JSONLエクスポートに対応します。
• 05決定的な読み取り専用監視ルールを実行し、アカウントのスナップショット間の変更を報告します。
• 06状態ジャーナルと整合性調整に対応した、再開可能な複数ステップのキャンペーンローンチをサポートします。

ユースケース

• AIエージェントにキャンペーンのパフォーマンスレポートを取得させ、配信上の問題を検出させる。
• CIやcronで読み取り専用のアカウントチェックを定期実行し、検出事項があればジョブを失敗させる。
• スクリプトから、複数のクライアント広告アカウントで広告を一括停止したり、予算を調整したりする。
• 自動化パイプラインからInstagramの投稿、Reels、カルーセルを公開する。

クイックスタート

1. 1

   README に記載されている公式インストールスクリプトを実行します

2. 2

   PATH の設定をシェルに読み込みます

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

   CLI が実行できることを確認します

   adsctl version

使う前に知っておきたいこと

• !現在実装されているのは Meta 広告のみです。Google は今後追加予定のアダプターです。
• !Meta の開発者アプリを作成し、アクセストークンを自分で用意する必要があります。CLI は OAuth に対応していません。
• !Windows では、常駐起動とモニターの実行はサポートされていません。

収録されている特集

トピック

よくある質問

adsctl とは？

Meta広告キャンペーンの調査、監視、レポート作成、配信開始を行う、AIエージェント向けのGo製CLI。JSON出力と明示的なアカウント指定に対応。 adsctlは、広告アカウントを操作するためのGo製コマンドラインツールで、Cobraを採用しています。最初の対応プラットフォームはMeta（FacebookとInstagramの広告）で、Googleアダプターも予定されています。標準ではJSONを返し、書き込み操作ではアカウントの明示的な指定が必要です。認証情報は設定ファイルに保存せず、外部のトークンファイルまたは環境変数から読み込みます。

adsctl は無料で使えますか？ライセンスは？

adsctl は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

adsctl は今もメンテナンスされていますか？

活発にメンテナンス中。adsctl の最終コミットは 2026年11月5日 です。

adsctl は何に使えますか？

AIエージェントにキャンペーンのパフォーマンスレポートを取得させ、配信上の問題を検出させる。 CIやcronで読み取り専用のアカウントチェックを定期実行し、検出事項があればジョブを失敗させる。 スクリプトから、複数のクライアント広告アカウントで広告を一括停止したり、予算を調整したりする。 自動化パイプラインからInstagramの投稿、Reels、カルーセルを公開する。

adsctl のインストール方法は？

README に記載されている公式インストールスクリプトを実行します PATH の設定をシェルに読み込みます: source "$HOME/.adsctl/env" CLI が実行できることを確認します: adsctl version

adsctl はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/imrenagicom/adsctl