Video_Spider – 无水印短视频下载工具

Video_Spider 是一款高效、简洁的短视频无水印下载工具。只需提供短视频链接，即可快速获取无水印的视频版本，支持多个主流短视频平台，为用户提供纯净的视频下载体验。

本工具支持从多个短视频平台下载无水印的视频。请注意，部分平台的短视频只能下载水印版本，无法去除水印。

✔️ 完全支持无水印
⭕ 仅支持下载水印版本

1. 安装依赖：

   进入项目目录后，使用 Composer 安装项目依赖：

   cd video_spider
   composer install

2. 启动服务：

   使用 PHP 内置服务器，或根据项目需求配置 Apache/Nginx：

   php -S localhost:8000 -t public

   如果您使用 Apache 或 Nginx，请根据项目的实际情况配置并启动 Web 服务。

3. 配置环境变量（可选）：

   在项目根目录创建 .env 文件，配置 Cookie 和限流参数：

   # 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

4. 开始使用：

   访问 http://localhost:8000 或生产环境地址，即可体验无水印视频下载功能！

• url：视频链接。请确保提供有效且正确的视频 URL。
  • 对于 GET 请求，请务必对 URL 进行 urlencode 编码，避免特殊字符导致错误。

本工具支持 GET 和 POST 请求。建议使用 POST 请求，以保证更高的稳定性。

curl -X POST "http://localhost:8000" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "url=<video_url>"

curl -G "http://localhost:8000" \
     --data-urlencode "url=<encoded_video_url>"

请求成功后，您将获得一个包含以下字段的 JSON 响应。url 字段为必返字段，包含无水印的视频链接。

错误码：

• 400 – 参数错误（如：URL 格式无效、不支持的平台）
• 405 – 不支持的请求方法
• 422 – 参数验证失败（如：URL 参数为空）
• 429 – 请求过于频繁（触发速率限制）
• 500 – 服务器内部错误（如：解析失败）

默认限制为：60 次请求 / 60 秒（基于 IP 地址）

• 可通过环境变量 RATE_LIMIT_MAX_REQUESTS 和 RATE_LIMIT_TIME_WINDOW 调整
• 可通过环境变量 RATE_LIMIT_ENABLED=false 禁用速率限制

当短视频链接包含特殊字符（例如 #、&、= 等）时，GET 请求可能无法正确传递参数。为避免此问题，建议：

• 使用 POST 请求；
• 如果必须使用 GET 请求，请对 URL 进行正确的 urlencode 编码。

有些平台的短视频解析可能会失败，常见原因包括：

• 微博平台：必须配置 WEIBO_COOKIE，否则无法解析（会提示”请先设置微博 cookie”）
• 视频链接无效或已过期
• 平台接口变更导致解析失败

解决方法：

• 确保已在 .env 文件中配置对应平台的 Cookie
• 验证视频链接是否有效
• 如果问题仍然存在，请提交 Issue 反馈，我们将尽快处理