https://github.com/ethanz-code/short-video-extractor
一个稳定快速的短视频解析服务，部署即可使用，目前支持小红书作品去水印
https://github.com/ethanz-code/short-video-extractor
api douyin kuaishou parse-server short-video xiaohongshu
Last synced: 3 months ago
JSON representation
一个稳定快速的短视频解析服务，部署即可使用，目前支持小红书作品去水印
- Host: GitHub
- URL: https://github.com/ethanz-code/short-video-extractor
- Owner: ethanz-code
- License: apache-2.0
- Created: 2025-01-17T13:49:17.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-06-10T03:10:32.000Z (4 months ago)
- Last Synced: 2025-06-24T12:53:13.277Z (3 months ago)
- Topics: api, douyin, kuaishou, parse-server, short-video, xiaohongshu
- Language: TypeScript
- Homepage: https://sv-extractor.itcox.cn/
- Size: 3.13 MB
- Stars: 69
- Watchers: 3
- Forks: 14
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Video Parser Service
✨✨✨这是一个可以快速部署的短视频解析服务，开箱即用，目前支持小红书解析服务✨✨✨
[](./LICENSE)
[](https://github.com/yassine-zhang/short-video-extractor/stargazers)
[](https://github.com/yassine-zhang/short-video-extractor/forks)
[](https://github.com/yassine-zhang/short-video-extractor/issues)
[](https://github.com/yassine-zhang/short-video-extractor/issues?q=is%3Aissue%20state%3Aclosed)
[](https://hub.docker.com/r/yassine778/video-parser)
[](https://status.itcox.cn/?monitor=sve-api)
[](https://status.itcox.cn/?monitor=sve-api)
## 功能列表🎉🎉🎉
1. 每次解析速度稳定在 3 ~ 12s ，速度取决于页面内解析量和服务器下行网速✨；
2. 小红书实况图解析后会被作为视频返回，我们加入了 type 变量来区分解析的资源类型🎉；
3. ...
## 注意⚠️
当前项目通过 Node.js puppeteer 模拟点击操作并监听资源实现短视频解析，受限于页面结构和反爬机制，无法保证长期稳定性。
## TodoList📍
在不久的将来，我将新开一个专门仓库，基于 Node.js 或 Python，直接调用小红书 API 接口获取数据，从而大幅提升解析的稳定性与兼容性，欢迎持续关注项目进展。
## API 接口
### 标准接口
| 接口路径 | 请求方法 | Content-Type | 请求参数示例 | 说明 |
| ------------------ | -------- | ---------------- | ------------------------------------------------------------------------ | ------------------------ |
| /pv | POST | application/json | {
"url": "https://www.xiaohongshu.com/explore/xxx"
} | 解析短视频接口，简化地址 |
| /public/parseVideo | POST | application/json | {
"url": "https://www.xiaohongshu.com/explore/xxx"
} | 解析短视频接口 |
---
## 环境变量说明
- `PORT`：服务监听端口（开发环境建议 10010，生产环境建议 7777）
- `PUPPETEER_EXECUTABLE_PATH`：指定 Puppeteer 启动时所用 Chromium/Chrome 浏览器的绝对路径，建议在 Docker 或服务器环境下设置为 `/usr/bin/chromium-browser`，否则 Puppeteer 可能无法正常启动。
## 本地运行
### 安装依赖
```bash
bun install
```
### 直接运行源代码
```bash
bun run dev
```
### 编译并运行
```bash
bun run build-local && bun run start
```
## Docker 镜像快速使用
你可以直接拉取并运行我们已构建好的官方镜像，无需本地构建：
### 1. 拉取镜像
```bash
docker pull yassine778/video-parser:latest
```
### 2. 运行容器
```bash
docker run -d \
-p 10010:7777 \
--name video-parser \
yassine778/video-parser:latest
```
### 3. 验证服务
容器启动后，发起 POST 请求 `http://localhost:10010/public/parseVideo` 即可调用接口。
---
详情内容请参考[详细部署文档](./docs/DEPLOYMENT.md)。
如遇镜像拉取缓慢，可参考[镜像源配置指南](./docs/DOCKER_MIRROR.md)加速 Docker 镜像下载。
---
如需进一步定制或有疑问，欢迎随时联系技术支持。
## 联系我们
- QQ: 57878778
- 邮箱：support@itcox.cn
## 赞助支持
## 许可证
本项目采用 [Apache License 2.0](LICENSE) 许可证。Copyright © 2025 济宁若森软件开发中心（个人独资）