Video_Spider

无水印短视频下载工具

一键解析主流平台视频链接，获取高清无水印版本。

Video_Spider 是一个轻量、高效的开源工具，支持从多个短视频平台提取无水印视频直链。只需提供视频 URL，即可返回纯净的下载地址，适用于内容存档、二次创作或本地观看等场景。

支持平台

⚠️ 注意：部分平台因反爬机制或接口变更，可能临时失效。欢迎通过 Issue 反馈。

快速开始

1. 克隆项目

git clone https://github.com/5ime/video_spider.git
cd video_spider

2. 安装依赖（需 PHP ≥ 8.0）

composer install

3. 启动服务

使用 PHP 内置服务器（开发用）：

php -S localhost:8000 -t public

或配置 Apache / Nginx 作为生产环境。

4. （可选）配置环境变量

在项目根目录创建 .env 文件：

# 微博 Cookie（解析微博视频必需）
WEIBO_COOKIE='XSRF-TOKEN=xxx; SUB=xxx; SUBP=xxx; WBPSESS=xxx'

# 速率限制（默认开启）
RATE_LIMIT_ENABLED=true
RATE_LIMIT_MAX_REQUESTS=60
RATE_LIMIT_TIME_WINDOW=60

# CURL 超时设置
CURL_CONNECT_TIMEOUT=5
CURL_TIMEOUT=10
CURL_MAX_RETRIES=3

5. 开始使用

访问 http://localhost:8000，或通过 API 调用。

API 使用说明

请求参数

• url：目标视频的完整链接（必需）

请求方式

推荐使用 POST（更稳定，避免 URL 编码问题）。

示例 1：POST 请求（推荐）

curl -X POST "http://localhost:8000" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "url=https://v.douyin.com/abc123"

示例 2：GET 请求（需 URL 编码）

curl -G "http://localhost:8000" \
     --data-urlencode "url=https://v.douyin.com/abc123"

响应格式

成功时返回 JSON，包含以下字段（url 为必返）：

❌ 错误码

⚙️ 速率限制

• 默认：60 次请求 / 60 秒（按 IP 限流）
• 可通过 .env 调整或关闭：

  RATE_LIMIT_ENABLED=false
  

常见问题

Q1：GET 请求中链接含 #、& 等字符怎么办？

A：强烈建议改用 POST 请求。若必须用 GET，请确保对 URL 进行 urlencode。

Q2：微博视频无法解析？

A：微博需配置有效 Cookie。请在 .env 中设置 WEIBO_COOKIE，否则只能获取带水印版本。

Q3：解析突然失败？

可能原因：

• 视频已删除或设为私密；
• 平台接口更新；
• Cookie 过期（微博等平台）。

解决方法：验证链接有效性，更新 Cookie，或提交 Issue。