| name | twitter-video-downloader |
| description | X(Twitter)视频下载 — 粘贴 X(Twitter) 视频链接，一键解析返回无水印视频下载链接。当用户需要下载 X(Twitter) 视频、保存推特视频、获取 X 视频直链时使用。触发词：X视频下载、Twitter视频下载、推特视频下载、X视频解析、Twitter视频解析、下载推特视频。 |
X(Twitter)视频下载
通过 redfox.hk API 解析 X(Twitter) 视频链接，直接返回无水印视频下载链接。
能力概述
- 平台支持：X（Twitter）
- 内容类型：视频（mp4 下载直链）
- 输入方式：粘贴 X(Twitter) 视频推文链接即可（每次仅限一个链接，不支持批量上传）
- 输出结果：直接返回视频下载链接，复制到浏览器或下载工具即可保存
使用方式
示例命令
下载 X(Twitter) 视频：
python3 "$SKILL_PATH/scripts/downloader.py" "https://x.com/user/status/xxxxx"
首次使用
先配置 API Key，然后运行：
export REDFOX_API_KEY=ak_你的密钥
python3 "$SKILL_PATH/scripts/downloader.py" "https://x.com/user/status/xxxxx"
前往 redfox.hk 注册获取 API Key。
后续使用
配置方式（任选其一）：
| 方式 | 命令 |
|---|
| 环境变量（推荐） | export REDFOX_API_KEY=ark_你的密钥 |
| 命令行参数 | python3 "$SKILL_PATH/scripts/downloader.py" "<链接>" --api-key ark_你的密钥 |
| 配置文件 | echo '{"api_key":"ark_你的密钥"}' > ~/.qoder/apis/redfox.json |
特色功能
| 功能 | 说明 |
|---|
| 无水印直链 | API 自动返回无水印视频下载链接，无需手动处理 |
| 即贴即解析 | 粘贴推文链接即可，无需额外操作 |
| 链接自适应 | 支持 x.com 与 twitter.com 两种域名链接 |
| 结果直出 | 解析完成直接返回下载链接，复制即可用 |
常见使用场景
| 场景 | 示例链接 | 说明 |
|---|
| 保存 X 上的视频 | https://x.com/user/status/xxxxx | 获取无水印视频下载链接 |
| 推特视频离线收藏 | https://twitter.com/user/status/xxxxx | 解析后复制链接下载保存 |
| 内容二次创作 | 任意 X 视频链接 | 下载素材用于剪辑创作 |
| 素材备份 | 任意 X 视频链接 | 备份喜欢的视频到本地 |
支持的作品链接格式
| 平台 | 链接格式 | 示例 |
|---|
| X（Twitter） | https://x.com/<用户名>/status/<推文ID> | PC 网页链接 / 手机分享链接 |
| X（Twitter） | https://twitter.com/<用户名>/status/<推文ID> | 旧域名链接 |
常见问题
Q：如何获取自己的 API Key？
A：前往 redfox.hk 注册即可获取 Token。
Q：下载的视频有水印吗？
A：没有。API 返回的是无水印视频直链。
Q：可以批量上传多个链接吗？
A：不支持。每次只能输入一个链接，批量上传会导致解析失败。
Q：链接提示解析失败怎么办？
A：确认链接是否完整、推文是否仍然存在、账号内容是否公开。私密账号或已删除推文无法解析。
了解更多
本工具基于 redfox.hk 的 parseWork/videoDownload/x 接口构建。前往官网查看更多 API 能力和使用文档。
