krusemediallc/arcads-claude-code

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

此仓库的功能

Arcads AI Video – Agent Skill Pack 是一套可立即执行的 Claude Code（及 Cursor）“技能”集合，让您能使用 Arcads 生成式媒体平台来生成以广告为重点的图片与短视频。它整合了以下功能：

视频模型 – Seedance 2.0、Sora 2、Veo 3.1、Kling 3.0、Grok Video、OmniHuman、音频驱动 – 每个模型都通过一个小型 CLI 风格的技能公开，处理提示词、API 调用、轮询、成本确认与文件保存。
图片模型 – Nano Banana 2/Pro/Edit 与 ChatGPT Image 2 – 用于网红角色设定表、产品静态图以及 37 种 Meta 静态广告模板库。
多步骤流程 – 例如：分镜脚本生成 → Seedance 视频 → ffmpeg 拼接 → 字幕烧录，或 Pixar 风格 3D 广告、黏土动画风格广告、YouTube 缩略图批处理等。
Meta 广告发布 – 一个 meta-ad-builder 技能，可将完成的素材上传至 Meta Marketing API 作为暂停状态的广告。

所有这些都封装为一组 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 – 五种高点击率 (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-roll 或通用场景生成。
Grok Video	视频	xAI 的文字转视频模型。
Nano Banana 2 / Pro	图片	网红角色设定表、产品静态图、静态广告素材。
ChatGPT Image 2	图片	UI 风格、文字密集的静态 Meta 广告。
OmniHuman / 音频驱动	视频	说话头像或口型同步视频。

总结

arcads-claude-code 是一个真实、功能齐全的工具包，它将一系列生成式 AI 模型（视频、图片、音频）串联成生产就绪的广告流程，并透过 Claude Code/Cursor 技能进行编排。如果您是一位熟悉终端操作的营销人员或开发人员，并希望自动化 Meta 广告活动的创意部分，此仓库为您提供了一个完整且具备文档说明的起点。