保姆级教程 输入抖音关键词 Agent自动提取视频转文字稿 附赠源码

近日有读者咨询：能否只输入一个关键词（例如“短视频带货”），让智能体（Agent）自动完成从搜索到文字稿的完整流程？

过去，完成这一流程需要手动浏览抖音、逐一记录、复制链接、下载音频并转写，非常耗时。后续的爆款拆解与二次创作脚本属于附加价值，可按需使用，不影响本教程的核心目标：

根据抖音关键词，批量提取相关视频内容并生成文字稿件。

本次我们将整个流程封装为一个智能体技能（Agent Skill）。您无需编写代码，只需安装该技能，并向智能体发出指令：

请使用 RedFox 抖音视频转文字技能，搜索关键词“短视频带货”，帮我找出相关视频，下载音频，并转写成文字稿。

智能体会自动执行流程。本教程面向新手，特别适合自媒体从业者、短视频创作者、电商运营人员、直播带货主播以及内容选题策划者，可按照步骤轻松操作。

准备工作

开始前，请准备好以下三项内容： 1. 一个支持智能体运行的工具，例如 Codex 或 WorkBuddy（本文以 WorkBuddy 为例，其他智能体用法类似）。 2. RedFox API Key，用于搜索抖音视频内容。 3. 阿里云百炼 API Key（即 DASHSCOPE_API_KEY），主要用于音频转文字、文稿校正及脚本生成。

第一步：获取 Skill 源码

完整的技能源码已整理好，可通过公众号后台获取。回复关键词即可自取源码包。

拿到的是一个压缩包：redfox-douyin-viral-script.zip

拿到以后无需手动修改代码，直接让智能体帮忙安装即可。

第二步：让 Agent 帮你安装 Skill

将源码包交给智能体，用一句提示词即可完成安装，整个流程可参考下图：

在 Codex 中安装

打开 Codex，将源码包放入当前工作区，然后发送：

请帮我安装这个 skill：/Users/wample/coding/me/test/redfox-douyin-viral-script.zip
要求：
1. 解压源码包；
2. 安装到当前工作区的 .agents/skills 目录；
3. 同步一份到 Codex 全局 skills 目录 ~/.codex/skills；
4. 安装后检查 SKILL.md 是否存在；
5. 告诉我安装是否成功。

安装成功后，Codex 即可识别该技能。

在 WorkBuddy 中安装

打开 WorkBuddy，将源码包上传或放置到 WorkBuddy 可访问的工作区，然后发送：

请帮我安装这个 skill：/Users/wample/coding/me/test/redfox-douyin-viral-script.zip
要求：
1. 解压源码包；
2. 安装到 WorkBuddy 可识别的 skills 目录；
3. 检查 SKILL.md 是否存在；
4. 安装完成后告诉我如何调用这个 skill。

不同智能体的技能目录可能略有差异，无需死记硬背路径，找到自己下载技能的实际路径并替换即可。核心原则是：将源码包交给智能体，让智能体自行安装，并检查安装结果。

第三步：创建 RedFox API Key

RedFox 是本次教程最核心的 API 平台，它整合了多个公开内容平台的数据接口，方便调用。对于初学者而言，无需编写爬虫代码或研究数据抓取方法，只需获得 API Key，再将关键词交给智能体，即可自动查询作品、获取标题、作者、互动数据及音频链接。 本次主要使用 RedFox 的抖音接口：搜索关键词获取抖音作品。返回数据包括作品标题、作者、发布时间、点赞数、评论数、收藏数、转发数、视频链接，以及关键的 audioUrl（音频地址）。拿到音频地址后，可下载音频并交由千问进行语音识别，最终转写成文字稿件。 官方文档地址：https://redfox.hk/apis/douyin/0OT1E306 RedFox 接口文档显示，它支持抖音、小红书、公众号、B站、今日头条、TikTok等多个平台，以及工具类接口（图片生成、视频生成、素材上传、短视频下载器）和人工智能搜索（豆包、DeepSeek）。可将其视为“自媒体数据 API 工具箱”。本文以抖音为例，演示最小可跑通的案例，因为抖音视频转文字是最直观、最实用的场景。以下是 RedFox 接口文档的目录截图，展示覆盖的平台和接口类型：

需要特别说明：RedFox 官方文档中默认可用的接口数据并非实时，而是截至昨天的 T-1 数据。但对大多数自媒体场景（如选题分析、爆款拆解、脚本参考、内容趋势判断）而言，昨日数据已足够支撑决策。如需实时数据，需向 RedFox 单独申请，且实时接口另行收费。实时接口覆盖更广，包括小红书、抖音、B 站等平台的账号信息、作品列表、评论列表、关键词搜索等。以下是实时接口目录截图：

注册登录账号，请访问官网：https://redfox.hk/invite?invitationCode=paAgcN8v

进入控制台后，依次点击「控制台」→「密钥管理」→「创建密钥」，获取个人 API Key 并妥善保存，后续步骤将使用。

第四步：申请阿里云百炼 API Key

此步骤用于将下载的抖音音频转写成文字，并利用千问模型校正为通顺的文稿。考虑到大部分读者为国内用户，本文统一使用阿里云百炼。文本校正和脚本生成默认采用当前千问文本模型中能力最强的 qwen3.7-max。若仅为测试或节省成本，可后续改为 qwen3.7-plus 或 qwen3.6-flash。 打开阿里云百炼控制台，开通模型服务，然后创建 API Key。阿里百炼地址：https://bailian.console.aliyun.com/cn-beijing?tab=model#/api-key 创建自己的 API Key：

第五步：配置 API Key

安装好技能后，需将 API Key 配置到智能体的运行环境中。无需手动输入命令，只需将两个 Key 交给智能体，让其协助配置。可这样对智能体说：

请帮我配置 redfox-douyin-viral-script skill 的运行环境。
我的 RedFox API Key 是：这里粘贴你的 RedFox API Key
我的阿里云百炼 API Key 是：这里粘贴你的阿里云百炼 API Key
请配置完成后检查一次环境变量是否生效，但不要在回复里显示完整 Key。

第六步：开始跑流程

直接让智能体一次性完成： 1. 根据关键词搜索抖音作品。 2. 按互动数据筛选高价值视频。 3. 下载视频音频。 4. 用千问把音频转成文字稿。 5. 用 AI 矫正文字稿。 6. 顺手生成可参考的二创脚本。 对智能体说：

请使用 redfox-douyin-viral-script skill，搜索关键词“短视频带货”，筛选前 3 条高互动作品，下载音频，用千问转写音频，保留原始文字稿和 AI 矫正稿，并生成一份原创二创脚本。完成后请告诉我生成目录和报告路径。

接下来交给智能体。无需手动敲命令或理解脚本参数。运行完成后，它会直接告知： - 结果保存在哪个文件夹。 - 视频提取报告位置。 - 文字稿位置。 - 二创脚本位置。

第七步：查看最终结果

成功后，所有过程文件均会保留，方便复盘和二次修改。

先打开：transcripts/

重点关注这两个文件：

作品ID.raw.txt         原始语音识别稿
作品ID.cleaned.txt      AI 矫正后的通顺稿

这两个文件是本教程的核心产出。raw.txt 是原始识别结果，可能包含口语、错别字和断句问题；cleaned.txt 是 AI 校正后的版本，更适合阅读、整理和二次创作。 再打开生成的报告文件：

报告中包含： - 接口状态。 - 搜索总结果数。 - Top 作品列表。 - 作者信息。 - 视频链接。 - 音频路径。 - 点赞、评论、收藏、转发、粉丝数。 - 是否完成转写。

如果想继续做内容创作，可打开附加生成的脚本文件：

outputs/remix_scripts.md

脚本中包含智能体自动生成的： - 标题。 - 3 秒开头钩子。 - 45-60 秒口播稿。 - 分镜建议。 - 封面文案。 - CTA。 注意：生成的是原创二创脚本，非直接照搬原视频。至此，整个流程已完成。如需自行尝试，完整源码已整理好。