youtube-automation-agent

环境要求

• 已安装 Node.js 与 npm（需能执行 npm install / npm start）
• 准备好 AI 服务商凭证（Gemini 或 OpenAI 等，按向导选择）
• 准备好 YouTube 频道授权信息（向导会引导完成授权）
• 本地可用端口 3456（Web 控制台默认地址）

安装与启动步骤

1. 1克隆项目仓库

   把 GitHub 上的 youtube-automation-agent 仓库拉到本地，命令来自 README 的 Quick start。

   git clone https://github.com/darkzOGx/youtube-automation-agent.git
   cd youtube-automation-agent

   复制

2. 2安装依赖

   在项目根目录安装 Node.js 依赖，需联网，耗时取决于网络情况。

   npm install

   复制

3. 3运行配置向导

   walkthrough 会逐个解释服务商选择、测试凭证，并引导完成 YouTube 授权，建议首次使用都跑一遍。

   npm run walkthrough

   复制

4. 4启动服务

   启动本地服务，默认监听 3456 端口，启动后保持该终端窗口不要关闭。

   npm start

   复制

5. 5打开控制台

   浏览器访问本地控制台，在 Autonomous operator 页面填写频道目标、受众、内容支柱与发布节奏。

6. 6激活并运行运营

   保存策略后点击 Activate & run now，或在界面上调用 operator 接口启动后台运行。

   curl -X POST http://localhost:3456/api/operator/start \
     -H "Content-Type: application/json" \
     -H "x-api-key: $API_KEY" \
     -d '{}'

   复制

关键配置

如何确认成功

终端无报错且服务已启动，浏览器打开 http://localhost:3456 能看到仪表盘即成功。

常见问题

注意事项

• 本项目为 JavaScript/Node.js 项目，必须先装好 Node.js 与 npm 再执行 Quick start。
• 首次使用强烈建议执行 npm run walkthrough，它会测试凭证并引导 YouTube 授权。
• 调用本地 API 时必须携带 x-api-key 请求头，否则请求会被拒绝。
• 按 README 说明，自主运营不会绕过人工审核门禁，付费媒体探测需显式开启 includePaidMedia。