krusemediallc/arcads-claude-code

Arcads external API: agent skills, prompting library, and Cursor/Claude workspace

このリポジトリの機能

Arcads AI Video – Agent Skill Pack は、Arcads 生成メディアプラットフォームを使用して広告向けの画像や短い動画を生成できる、すぐに実行可能な Claude Code（および Cursor）「スキル」のコレクションです。以下を統合しています：

動画モデル – Seedance 2.0、Sora 2、Veo 3.1、Kling 3.0、Grok Video、OmniHuman、音声駆動 – 各モデルは、プロンプト、API 呼び出し、ポーリング、コスト確認、ファイル保存を処理する小さな CLI スタイルのスキルとして公開されています。
画像モデル – Nano Banana 2/Pro/Edit および ChatGPT Image 2 – インフルエンサーのキャラクターシート、製品スチール、37 種類の Meta 静的広告テンプレートライブラリに使用されます。
マルチステップパイプライン – 例：ストーリーボード生成 → Seedance 動画 → ffmpeg 結合 → 字幕焼き込み、または Pixar 風 3D 広告、クレイアニメ風広告、YouTube サムネイルの一括生成など。
Meta 広告公開 – 完成したクリエイティブを 一時停止 状態の広告として Meta Marketing API にアップロードする meta-ad-builder スキル。

これらはすべて Claude Code スキル（Cursor 用にもミラーリング）としてパッケージ化されており、いくつかの Bash/Node ヘルパースクリプトが付属しています。このリポジトリには Arcads サービス自体は含まれていません。Arcads アカウントと API キーが必要で、初回実行の setup.sh スクリプトがローカルの .env ファイルに保存します。

対象ユーザー

メディアバイヤー / パフォーマンスマーケター – Facebook/Meta 広告のクリエイティブ制作を自動化したい方。
フリーランスの広告クリエイター – インフルエンサー風動画、UGC 風クリップ、インパクトのある静的画像広告を生成するための再現可能なワークフローを探している方。
開発者 – 複数の生成 AI モデル（動画、画像、音声）を単一のエンドツーエンドパイプラインでオーケストレーションする方法の具体的な例を探している方。

開始方法（クイックスタート）

クローンしてインストーラーを実行
```
git clone https://github.com/krusemediallc/arcads-claude-code.git
cd arcads-claude-code
./scripts/setup.sh
```
スクリプトが Arcads API キーの入力を求め、.env に書き込み、接続を確認し、個人の MASTER_CONTEXT.md ワークスペースファイルを作成します。
Claude Code（または Cursor）でフォルダを開く – エディタが SessionStart フックを実行し、利用可能なスキルと環境が準備できているかを表示します。
ワークフローを選択 – README にはすぐに使えるプロンプトがリストされています。例：
- Seedance 2.0 UGC selfie – 12 秒の製品レビュー動画。
- generate-youtube-thumbnail – 5 種類の高 CTR サムネイル公式。
- pixar-style-ad – ストーリーボード → Seedance 動画 → ffmpeg 結合。
スキルを実行 – Claude Code の UI または対応する Bash/Node スクリプトを呼び出します。エージェントは以下の処理を行います：
- 不足しているパラメータ（製品名、参照画像など）を尋ねる、
- 推定クレジットコストを表示する、
- Arcads API 呼び出しを開始し、完了をポーリングし、出力ファイルを outputs/ フォルダに書き込む。
(オプション) 公開 – meta-ad-builder スキルと Meta アクセストークンを使用して、クリエイティブを一時停止状態の広告としてアップロードします。

技術的な詳細

領域	リポジトリが提供するもの
コア言語	Arcads API ラッパー用の純粋な Python 3.10+。ほとんどの画像広告スクリプトは標準ライブラリのみを使用（外部パッケージなし）。
CLI ヘルパー	Bash スクリプト (`setup.sh`, `check-arcads-env.sh`, `sync-skill.sh`) およびいくつかの Node ベースのステップ (`npx hyperframes` による字幕焼き込み)。
外部ツール	`ffmpeg` (動画結合、字幕オーバーレイ), `jq` (JSON 処理), `whisper` (音声文字起こし), Node.js (HyperFrames)。
スキルの構成	各機能は `skills/…` 下に配置（例：`skills/arcads-external-api/`, `skills/generate-youtube-thumbnail/`）。共有ユーティリティとプロンプトライブラリは `shared/skills/` にあります。
プロンプトライブラリ	各動画モデル（Seedance, Sora, Veo など）および 37 種類の静的広告テンプレート用の Markdown プロンプトテンプレート。
コスト追跡	すべての API 呼び出しは `logs/arcads-api.jsonl` に `creditsCharged` と共に記録されます。エージェントはこれを読み取り、生成前に正確なコスト見積もりを提供します。
参照アセット	`references/` (git-ignored) には、インフルエンサーの写真、製品ショット、スタイル参照フォルダが保持され、必要に応じてエージェントが自動的にアップスケールします。
ステートフルワークスペース	`MASTER_CONTEXT.md` が永続的なメモリファイルとして機能し、エージェントが製品のデフォルト、ブランドボイス、クレジット合計、セッションノートを読み書きします。

活用シーンと注意点

Arcads アカウントを既にお持ちで、ローカル開発環境から動画/画像モデルを「プラグアンドプレイ」で操作したい場合（特に広告クリエイティブ制作において）は、このリポジトリが最適です。

以下の場合には適していません：

モデルに依存しない汎用的な生成 AI フレームワークが必要な場合（このリポジトリは Arcads に密結合しています）。
ローカル設定なしの完全ホスト型 SaaS ソリューションを求めている場合（Arcads の UI を直接使用してください）。
Claude Code スキルの足場なしの純粋な Python ライブラリを探している場合。

主要サポートモデルのクイックリファレンス

モデル	タイプ	一般的な用途
Seedance 2.0	動画 (4-15秒)	フラッグシップ広告クリップ – UGC 自撮り、プレミアム製品紹介、ヒーローショット、ルックブック、機能デモ。
Sora 2	動画 (最大20秒)	長めのテキスト・トゥ・ビデオのナラティブ。既存アセットのリミックスも可能。
Veo 3.1	動画 (~8秒)	インフルエンサーの静止画を短いクリップにアニメーション化。
Kling 3.0	動画 (5-10秒)	Bロールや一般的なシーン生成。
Grok Video	動画	xAI のテキスト・トゥ・ビデオモデル。
Nano Banana 2 / Pro	画像	インフルエンサーのキャラクターシート、製品スチール、静的広告クリエイティブ。
ChatGPT Image 2	画像	UI スタイル、タイポグラフィ重視の静的 Meta 広告。
OmniHuman / 音声駆動	動画	話すアバターやリップシンク動画。

結論

arcads-claude-code は、一連の生成 AI モデル（動画、画像、音声）をプロダクション対応の広告パイプラインに統合し、Claude Code/Cursor スキルを通じてオーケストレーションする実用的で機能的なツールキットです。ターミナル操作に慣れたマーケターや開発者で、Meta 広告キャンペーンのクリエイティブ面を自動化したい場合、このリポジトリは完全でドキュメント化された出発点となります。