wanyi-watermark-skill

抖音/小红书无水印资源下载与文案提取

从抖音、小红书(及未适配平台的通用兜底)分享链接获取无水印视频/图文资源, 下载到本地, 并可使用语音识别提取视频文案保存为 Markdown 文件.

功能概述

• 智能解析: 自动识别平台(抖音/小红书/通用)与内容类型(视频/图文), 无需手动指定
• 无水印视频: 解析出无水印视频直链, 可直接下载
• 图文资源: 解析图文笔记的全部图片; 小红书图片提供 WebP(轻量)与 PNG(高清)双格式
• 下载资源: 将视频或图集下载到本地指定目录
• 提取文案: 通过语音识别从视频中提取文字内容（支持阿里云百炼 / 硅基流动双后端）
• 通用兜底: 遇到未适配平台时, 自动基于页面 og:video / video 标签等通用信息尝试提取

环境要求

依赖安装

本技能依赖 wanyi-watermark 包及其声明的运行依赖. 在 server/mcp-server 目录下:

pip install -e .

API 密钥配置 (仅"提取文案"需要)

文案提取支持两种 ASR 后端，通过 ASR_BACKEND 环境变量切换（默认 dashscope）：

方案 A — 阿里云百炼（默认，URL 直传无需 ffmpeg）：

export DASHSCOPE_API_KEY="your-dashscope-api-key"

获取 API 密钥: https://help.aliyun.com/zh/model-studio/get-api-key

方案 B — 硅基流动 SenseVoice（需本地 ffmpeg）：

export SILICONFLOW_API_KEY="your-siliconflow-api-key"
export ASR_BACKEND="siliconflow"

获取 API 密钥: https://cloud.siliconflow.cn/

链接解析、资源下载均无需 API 密钥; 仅"提取文案"需要.

使用方法

方法一: 使用命令行 (推荐)

技能脚本 scripts/media_cli.py 是对包内 CLI 的轻量封装, 可直接运行:

# 获取信息和无水印直链 (无需 API 密钥, 支持抖音/小红书/通用)
python scripts/media_cli.py --link "分享链接" --action info

# 下载视频或图集到指定目录
python scripts/media_cli.py --link "分享链接" --action download --output ./output

# 提取视频文案（默认百炼，需 DASHSCOPE_API_KEY）
python scripts/media_cli.py --link "分享链接" --action extract --output ./output

# 使用硅基流动 SenseVoice 后端（需 SILICONFLOW_API_KEY + ffmpeg）
python scripts/media_cli.py --link "分享链接" --action extract --backend siliconflow --output ./output

# 提取文案并同时保存视频
python scripts/media_cli.py --link "分享链接" --action extract --output ./output --save-video

若已 pip install -e . 安装本包, 亦可使用模块或控制台入口:

python -m wanyi_watermark.cli --link "分享链接" --action info
# 或
wanyi-watermark-cli --link "分享链接" --action info

输出目录结构

output/
├── 7600361826030865707/        # 视频ID / 笔记ID 为文件夹名
│   ├── transcript.md           # extract 时生成的 Markdown 文案
│   └── 7600361826030865707.mp4 # 使用 --save-video 时保存
├── <note_id>/                  # 图文笔记: 图集逐张保存
│   ├── 01.png
│   └── 02.png
└── ...