利用Node.js与Claude API批量生成短视频文案脚本

Node.js 用 Claude API 批量生成短视频文案脚本

短视频内容创作最磨人的地方，往往不是剪辑技术，而是文案创意。一个内容矩阵账号每天要吃掉 5-10 条高质量脚本，纯靠手写不现实。下面从工程化角度，拆解如何用 Node.js 配合 Claude API 搭建一套可靠的批量文案生成系统——从零到一部署，15 分钟内搞定。

一、为什么选 Node.js + Claude API 这个组合

动手之前，先梳理一下技术选型的逻辑。

纯手工写文案成本太高——一条 60 秒的脚本平均需要 30-60 分钟。ChatGPT 网页版虽然免费，但没法批量跑，每一条都得手动输入、复制、粘贴。Claude Code Skills 或 Remotion 框架虽然功能强，可学习曲线陡峭，而且绑定特定工具链。

相比之下，纯 Claude API 调用 + Node.js 这个方案有三个实在的优势：

1. 完全可编程：数据流的每个环节都在你手里，可以灵活对接各种输入源（数据库、CSV、API）和输出端（视频制作工具、内容管理系统）
2. 成本透明可控：按 token 计费，没有隐形消费，还能做并发控制和缓存优化
3. 适合批量运营：配一次就能反复用，支持定时任务、AB 测试、多账号轮换

这套方案尤其适合日更账号、内容矩阵运营、电商带货、知识科普这类高频更新的场景。

二、环境准备与项目搭建

2.1 前置要求

先确认开发环境能满足这些条件：

• Node.js 18.x 或更高版本（推荐 20.x LTS）
• Claude API Key（从 Anthropic 官方或兼容接入平台获取）
• 基础 Ja vaScript 知识（理解 async/await、Promise）
• 文本编辑器（VS Code 推荐）

验证 Node.js 版本：

node --version  # 应显示 v18.0.0 或更高
npm --version   # 应显示 9.0.0 或更高

2.2 项目初始化

创建项目目录并初始化：

mkdir video-script-generator
cd video-script-generator
npm init -y

安装必要依赖：

npm install @anthropic-ai/sdk dotenv fs-extra p-limit pino

各依赖的作用：

• @anthropic-ai/sdk：Claude API 官方 SDK
• dotenv：管理环境变量（API Key）
• fs-extra：增强文件操作
• p-limit：并发控制（防止 API 限流）
• pino：结构化日志记录

2.3 项目结构与配置

创建以下目录结构：

video-script-generator/
├── .env                    # 环境变量配置
├── .env.example            # 配置模板
├── config/
│   └── settings.js         # 全局配置
├── prompts/
│   ├── knowledge.md        # 知识科普类提示词
│   ├── product.md          # 产品种草类提示词
│   └── story.md            # 故事叙述类提示词
├── utils/
│   ├── claude-client.js    # API 调用封装
│   ├── batch-processor.js  # 批量处理逻辑
│   └── logger.js           # 日志工具
├── data/
│   ├── input.json          # 输入数据示例
│   └── output/             # 生成结果存储
└── index.js                # 主程序入口

创建 .env 文件：

# Claude API 配置
CLAUDE_API_KEY=sk-ant-xxxxxxxxxxxxx
CLAUDE_MODEL=claude-3-5-sonnet-20241022
CLAUDE_BASE_URL=https://api.anthropic.com

# 生成参数
TEMPERATURE=0.7
MAX_TOKENS=1000

# 并发控制
CONCURRENT_LIMIT=3
RETRY_ATTEMPTS=3
RETRY_DELAY=1000

# 日志级别
LOG_LEVEL=info

三、核心代码实现：从单次到批量

3.1 Claude API 基础调用封装

创建 utils/claude-client.js：

const Anthropic = require("@anthropic-ai/sdk");
const logger = require("./logger");

class ClaudeClient {
  constructor() {
    this.client = new Anthropic({
      apiKey: process.env.CLAUDE_API_KEY,
      baseURL: process.env.CLAUDE_BASE_URL,
    });
    this.model = process.env.CLAUDE_MODEL;
    this.temperature = parseFloat(process.env.TEMPERATURE || 0.7);
    this.maxTokens = parseInt(process.env.MAX_TOKENS || 1000);
  }

  /**
   * 单次生成文案
   * @param {string} systemPrompt - 系统提示词
   * @param {string} userMessage - 用户输入
   * @returns {Promise} - 生成的文案
   */
  async generateScript(systemPrompt, userMessage) {
    try {
      const response = await this.client.messages.create({
        model: this.model,
        max_tokens: this.maxTokens,
        temperature: this.temperature,
        system: systemPrompt,
        messages: [
          {
            role: "user",
            content: userMessage,
          },
        ],
      });

      // 提取文本内容
      const content = response.content[0];
      if (content.type !== "text") {
        throw new Error("Unexpected response type");
      }

      logger.info(
        `Generated script successfully. Tokens: input=${response.usage.input_tokens}, output=${response.usage.output_tokens}`
      );

      return {
        text: content.text,
        tokens: {
          input: response.usage.input_tokens,
          output: response.usage.output_tokens,
        },
      };
    } catch (error) {
      logger.error(`Claude API error: ${error.message}`);
      throw error;
    }
  }

  /**
   * 批量生成文案（带重试机制）
   * @param {string} systemPrompt - 系统提示词
   * @param {Array} messages - 用户输入数组
   * @param {number} retries - 重试次数
   * @returns {Promise