dbs-video-extract
从抖音、小红书、微信视频号等平台链接或分享文案查询作品／账号数据并提取语音文字稿，按作者和标题归档为 Markdown。用户要求解析平台视频或取得数据、文字稿时使用；需配置 TikHub 与轻抖凭证，不负责本地成片章节导航或导航视频渲染。
- Installs
- 7K
- Last 24h
- +118
- Trending rank
- #1797
- Security
- Warn
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/dontbesilent2025/dbskill --skill dbs-video-extract- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads dbs-video-extract automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
Security audits
Independent scans of the skill's instructions and bundled files.
SKILL.md
The instructions your agent reads when the skill is triggered.
dbs-video-extract：短视频信息提取
目标：用一个入口处理同一条短视频分享文案。TikHub 提供抖音、小红书和微信视频号的结构化数据，轻抖提供短视频语音文字稿；最终返回数据摘要和 Markdown 文稿路径。
先检查使用凭证
任何提取任务开始前，先运行只读预检：
python3 scripts/extract_video.py --check-keys
根据 credential_state 处理：
| 状态 | 能力 | 必须告知用户 |
|---|---|---|
complete | 数据与文字稿都可用 | 两部分都可以执行 |
data_only | 只有 TikHub 数据查询可用 | 只能取得作品／账号数据，无法生成语音文字稿 |
transcript_only | 只有轻抖文字稿可用 | 只能取得语音文字稿，无法查询 TikHub 作品／账号数据 |
unavailable | 两部分都不可用 | 当前无法使用；先解释使用凭证，再带用户完成购买和配置 |
只有一个 Key 时允许继续，不要求用户补齐另一个 Key。执行前明确说明本次只能解决哪一部分，默认把模式收窄为当前可用的一侧。用户仍要求 both 时保留单侧结果，并将另一侧标记为缺少凭证。
两个 Key 都没有时停止提取。不要直接用「API Key」「接口鉴权」等术语作为结论。先用下面这句话解释：
想让这个 Skill 工作，需要先开通外部数据服务。API Key 是服务商在开通后提供的一串使用凭证，可以理解为这个 Skill 调用服务的专用通行证。你不需要理解技术原理，也不要把它发到聊天中。
随后告诉用户：「当前两个服务都没有开通。如果不购买并配置至少一个，这个 Skill 无法使用。」再按 references/api-setup.md 完成需求选择、购买、凭证保存和连接测试。
不要替用户付款、接受服务协议或处理完整 Key。不要要求用户把 Key 发到对话里。购买入口、逐步引导、安全配置脚本和连接测试见 references/api-setup.md。
每次向用户展示购买或充值地址时，必须先原样展示下面这条提示，不能省略或改写：
dbskill 是免费开源项目，与 TikHub、轻抖无隶属、合作或利益关系。充值由用户自主决定，相关交易、服务、争议及风险由用户自行承担；法律另有规定的除外，dbskill 不承担责任。
用户没有进入购买或充值引导时不重复展示。
缺少凭证时的对话要求
缺少任一服务时，回复必须形成下面的连续路径：
- 先用普通语言解释 API Key；
- 让用户按结果选择：完整功能、只看数据、只要文字稿；
- 说明每个选择需要购买哪个服务，以及只买一个会少什么；
- 展示固定法律提示，再展示对应充值地址；
- 逐步说明注册／登录、查看页面套餐、充值、进入个人中心或密钥管理页、取得凭证；
- 告诉用户取得凭证后不要发到聊天中，回复「TikHub 已充值」「轻抖已充值」或「两个都已充值」；
- 用户回复已充值后，引导其在本地终端运行安全配置脚本：
python3 scripts/configure_api_key.py tikhub
python3 scripts/configure_api_key.py qingdou
脚本会在终端中隐蔽读取凭证并保存到本地私密配置，不能把完整凭证显示在命令、回复或日志中。保存后重新运行 --check-keys，直到对应状态变为可用。
不要一次只发链接，也不要假定用户知道去哪里找凭证。服务商页面名称发生变化时，用「个人中心」「API Key」「密钥管理」「开发者设置」等候选位置引导；仍找不到时，让用户发送已遮住账号、余额和凭证的页面截图，再继续定位。
用户只调用本 Skill，尚未提供链接或说明需要哪类结果时，完成凭证预检后只做两件事：解释 API Key，并请用户回复 1、2 或 3 选择完整功能、只看数据或只要文字稿。收到选择后再展示法律提示、对应充值地址和购买步骤。用户已经发送视频链接或明确要求完整提取时，默认选择完整功能，无需重复询问。
默认执行
优先使用标准输入，避免分享文案中的特殊字符被 Shell 解释：
python3 scripts/extract_video.py \
--output-dir "/绝对路径/短视频文字稿" \
--stdin
默认模式为 both：
- 从完整分享文案中提取链接；
- 根据链接平台调用 TikHub MCP：抖音支持用户主页或单条作品，小红书与视频号支持单条视频；
- 保留完整分享文案提交轻抖 API，轮询取得文稿；
- 按
{输出目录}/{作者}/{标题}.md保存文稿； - 输出 JSON 汇总，包含凭证状态、TikHub 数据摘要和文稿文件路径。
TikHub 或轻抖任一侧失败时继续完成另一侧，并在汇总中标记 partial_success。已经取得的结果不能因单侧失败而丢弃。
可选模式
只有用户明确只需要一侧结果，或预检确认只有一侧 Key 时才切换：
python3 scripts/extract_video.py --mode data --stdin
python3 scripts/extract_video.py --mode transcript --stdin
data：只查询 TikHub 数据，支持抖音、小红书和微信视频号；transcript：只提取文字稿，支持轻抖 API 能解析的平台；both：同时执行两侧。
同一来源已经存在时默认跳过文稿写入，保护用户编辑；用户明确要求重新生成时加 --overwrite。需要 TikHub 完整响应时加 --raw-data。
密钥与费用
脚本按以下顺序读取 Key：
- 环境变量：
TIKHUB_API_KEY、QINGDOU_API_KEY； - 用户指定的本地文件：
TIKHUB_API_KEYS_FILE、QINGDOU_API_KEYS_FILE； ~/.config/dbs/API_Keys.md；- macOS 钥匙串：
dbs-tikhub-api-key、dbs-qingdou-api-key。
禁止把 Key 写入 Skill、命令参数、Markdown、Git 或日志。TikHub 查询和轻抖转写都可能计费；执行前告知用户。用户已经明确要求提取时无需重复确认。
数据边界
- TikHub 负责作品／账号资料、统计和媒体元信息；抖音作品优先 App V3，无有效数据时只回退 1 次 Web；小红书使用 App V2 视频笔记详情；视频号使用 Channels V2 作品详情。
- 轻抖负责语音文字稿。正文忠实保存 API 返回内容，不补写、润色或修订口误。
- 当前 TikHub 专用数据解析支持抖音、小红书和微信视频号；其他轻抖可识别的平台仍可只执行文字稿提取。
- 公开、删除、私密、版权和可见范围限制以接口返回为准，不尝试绕过。
- 不自动下载媒体、发布内容、提交 Git 或推送。
TikHub 调用细节见 references/tikhub-api.md；轻抖状态码和兼容逻辑见 references/qingdou-api.md。只在排错或维护对应部分时读取。
交付
完成后简洁报告：
- 当前配置了哪一个 API Key，以及可用能力范围；
- 数据查询是否成功、使用的 MCP 工具、是否发生 App → Web 回退；
- 关键作品／账号数据；
- 文稿是否成功、生成或跳过的 Markdown 绝对路径；
- 单侧缺少 Key 或执行失败的具体原因；
- 接口是否明确返回已计费。
不要在回复中展示 API Key、batchId 或无必要的内部请求标识。
完成当前任务后直接结束。用户的请求超出本 Skill 的范围、任务完成后用户的材料里出现明确的后续需求，或用户询问下一步时，用一句话说明还需要哪种能力，不点名其他 Skill；当前环境已经安装 /dbs 时，补一句「可以输入 /dbs，由它匹配对应的 Skill」。
FAQ
What does the dbs-video-extract skill do?
从抖音、小红书、微信视频号等平台链接或分享文案查询作品／账号数据并提取语音文字稿，按作者和标题归档为 Markdown。用户要求解析平台视频或取得数据、文字稿时使用；需配置 TikHub 与轻抖凭证，不负责本地成片章节导航或导航视频渲染。
How do I install dbs-video-extract?
Run npx skills add https://github.com/dontbesilent2025/dbskill --skill dbs-video-extract in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/dbs-video-extract/ (personal) or .claude/skills/dbs-video-extract/ (project).
Which AI agents can use dbs-video-extract?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is dbs-video-extract safe to install?
Security partners have reviewed it: Gen Agent Trust Hub passed; Socket passed; Snyk flagged items to review. As with any skill, read the SKILL.md and bundled scripts before installing.
Who maintains dbs-video-extract?
It is published by dontbesilent2025 in dontbesilent2025/dbskill. It has 7,037 recorded installs.
More from dontbesilent2025/dbskill
dbs
dontbesilent2025/dbskill
dontbesilent 商业工具箱的技能调度台，根据当前问题和反馈选择下一步，在对话中直接执行、澄清、组合或对照尝试 Skill。用户不知道从哪里开始、需要调整处理方法、第一次使用 dbskill、输入三位编号或查询隐藏款目录时使用；仅需推荐或可复制提示词时按请求交付。
dbs-content
dontbesilent2025/dbskill
围绕已经确定的选题诊断内容怎么组织、论证和表达，形成创作方案。用户要把选题做成内容时使用；不负责已有稿件的逐句删改和标题开头成稿。
dbs-diagnosis
dontbesilent2025/dbskill
自动识别用户是在解决具体商业问题，还是希望全面检查商业模式，并进入对应诊断流程。用户希望拆解业务、检查商业模式或消解具体商业困境时使用。
dbs-benchmark
dontbesilent2025/dbskill
用五重过滤法寻找值得模仿的对标，并排除主体差异造成的噪音。用户要求找对标、选择模仿对象或分析竞争参照时使用。
dbs-deconstruct
dontbesilent2025/dbskill
用维特根斯坦与奥派经济学方法拆解模糊的商业概念。用户要求解释一个词、澄清概念边界或识别概念混用时使用。
Popular media & creative skills
hyperframes
heygen-com/hyperframes
Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
media-use
heygen-com/hyperframes
Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
hyperframes-registry
heygen-com/hyperframes
About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
hyperframes-creative
heygen-com/hyperframes
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.
ai-video-generation
101-skills/superpowers
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse
ai-image-generation
101-skills/superpowers
Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image