addashboard-cli

広告ダッシュボード操作用の CLI。詳細な使い方・運用フローは社内マニュアル参照。

インストール

Node.js 18+ が必要。

# 都度実行 (推奨)
npx -y addashboard-cli@latest --help

# あるいはグローバルインストール
npm install -g addashboard-cli
webgram --help

ログイン

webgram auth login    # ブラウザで認証
webgram auth whoami   # 状態確認
webgram auth logout

主なコマンド

webgram list --platform <p> --resource <accounts|campaigns|resources|media|image-library|video-library> [--account-id <id>]
webgram submit --platform <p> --json-file <path>                        # dry-run 既定
webgram submit --platform <p> --json-file <path> --no-dry-run --yes    # 実入稿
webgram submit-plan --plan-file <入稿計画.json>                          # 入稿計画の一括検証 (dry-run 既定)
webgram submit-plan --plan-file <入稿計画.json> --no-dry-run --yes      # 1キャンペーンずつ実入稿 (再開可能)
webgram update-status --level <campaign|adGroup|ad> --account-id <id> --ids <id1,id2> --status <ACTIVE|PAUSED>   # ステータス ON/OFF (yda のみ・dry-run 既定)
webgram freee <login|templates|issue>                                   # freee 請求書発行 (allowlist 制)
webgram review --team <伊藤T|松井T> [--week <YYYY-MM-DD>]                # チーム週次レビュー取得 (省略時は先週)
webgram pl summary [--month YYYY-MM]                                    # 予実サマリ（CV/コスト/売上/粗利/日次推移/案件別内訳/着地予測/目標、省略時は当月）
webgram pl projects [--month YYYY-MM] [--status <s>] [--platform <p>]   # 案件別の予実明細

<p> = 対応媒体 (yda / meta / google / smartnews / bytedance)。submit-plan は yda / meta 対応（入稿計画JSON の plan.platform で自動判別、未記載は yda 扱い）。 --resource の媒体制約: resources は smartnews 非対応 / media は yda のみ（登録画像 mediaId）/ image-library・video-library は meta のみ（imageHash / videoId。--account-id は act_ 付き）。 pl summary / pl projects は JSON をそのまま出力する（要約は呼び出し側の Claude Code が行う）。

review はチーム × 週で全案件の週次レビュー（課題・今週のアクションプラン）を 1 回で取得する (JSON 出力)。--week 省略時は先週の月曜 (JST) を自動採用。要約は Claude Code / Codex (LLM) 側で行う。

入稿ボディ JSON の雛形と必須フィールドは fixtures/README.md。 入稿計画 JSON は同梱の入稿プランナー (skills/ad-ops/ad-planner.html) が書き出す。プランナーはヘッダーの媒体セレクタで YDA / Meta を切り替える（アカウント参照データは skills/ad-ops/アカウント/<platform>/<名前>.json）。

update-status は既存のキャンペーン / 広告グループ / 広告の配信ステータスを一括で切り替える（現状 yda のみ。削除は未対応）。既定は dry-run で、対象の「現status → 新status」を表示するだけ。本実行は --no-dry-run --yes、ACTIVE 化（配信開始）はさらに --confirm-activate が要る。ID は --ids（カンマ / 空白 / 改行 区切り）か --ids-file <path> で渡す（併用可・重複は畳まれる）。未解決 ID が 1 件でもあれば本実行は中断する（部分実行させない）。上限 200 件。exit code は 0=成功 / 1=エラー / 2=--yes・--confirm-activate 未指定 / 3=一部失敗。

submit-plan の本実行（--no-dry-run --yes）は 1 キャンペーンずつ入稿し、進捗を計画ファイルに書き戻す（途中失敗後の再開可・submitted はスキップ）。未登録クリエイティブは本実行時のみ解決される（YDA: /api/submission/yda/upload-image、Meta: /api/submission/meta/upload-image = imageHash / /api/submission/meta/upload-video = videoId）。dry-run ではアップロードしない。 Meta は本番アカウントでの入稿 PoC 未実施のため、初回は配信オフ（PAUSED）・1 キャンペーン・最小予算から検証すること。

Skill として使う

Claude Code / Codex CLI 用の ad-ops skill (広告運用スキル・入稿プランナー同梱 / YDA・Meta 対応) と invoice-issue-freee skill を同梱。配置手順は skills/ad-ops/README.md。

開発

npm install
npm run build
npm test