# kuaishou_one_spider

**Repository Path**: elfbobo_admin_admin/kuaishou_one_spider

## Basic Information

- **Project Name**: kuaishou_one_spider
- **Description**: 快手数据爬虫采集软件，GUI工具开箱即用：关键词作品采集、评论采集、作品详情、主页作品、视频下载、链接转换、CSV导出。
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: https://mgnb.pro/product/kuaishou
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-11-06
- **Last Updated**: 2026-11-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">kuaishou_one_spider</h1>

<p align="center">
  <a href="https://gitee.com/mashukui/kuaishou_one_spider"><img src="https://gitee.com/mashukui/kuaishou_one_spider/badge/star.svg?theme=white" alt="stars"></a>
  <a href="https://gitee.com/mashukui/kuaishou_one_spider"><img src="https://gitee.com/mashukui/kuaishou_one_spider/badge/fork.svg?theme=white" alt="forks"></a>
  <a href="https://gitee.com/mashukui/kuaishou_one_spider/releases"><img src="https://badgen.net/badge/release/v2a2/green" alt="release"></a>
  <a href="https://mgnb.pro/product/kuaishou"><img src="https://badgen.net/badge/platform/Windows%20%7C%20macOS/blue" alt="platform"></a>
  <a href="https://gitee.com/mashukui/kuaishou_one_spider/blob/main/LICENSE"><img src="https://badgen.net/badge/license/Proprietary/red" alt="license"></a>
</p>

<p align="center">
  <a href="README.md">简体中文 README</a> | <a href="README.en.md">English README</a>
</p>

> 🔥 快手数据采集工具 / Kuaishou crawler GUI，支持关键词作品采集、评论采集、作品详情采集、主页作品采集、视频下载、CSV 导出和链接转换。
>
> 💡 支持 Windows/macOS，无需配置Python环境；仓库用于软件介绍、版本发布、使用说明和问题反馈，完整源码暂不公开。
>
> [⬇️下载最新版](https://gitee.com/mashukui/kuaishou_one_spider/releases/) | [🎬使用演示](https://www.bilibili.com/video/BV1psRfBkEot/) | [🏠产品主页](https://mashukui.github.io/kuaishou_one_spider/) | [💳开通使用](https://mgnb.pro/product/kuaishou)


## 👋 软件简介

`kuaishou_one_spider` 是一款面向快手数据采集场景的桌面GUI工具，整合了关键词作品采集、评论采集、作品详情采集、主页作品采集、链接转换等常用能力。用户无需配置 Python 环境，下载客户端后登录即可使用。

它适合以下场景：

| 场景 | 说明 |
| --- | --- |
| ✅ 获客线索 | 从行业、品牌、竞品相关作品评论区采集潜在用户线索 |
| ✅ 舆情分析 | 采集关键词相关作品与评论，用于热点事件、传播趋势和口碑分析 |
| ✅ 内容创作 | 分析热门作品的内容风格、话题标签、互动数据和爆款方向 |
| ✅ 快手运营 | 进行主页链接、快手号、uid、作品链接等格式转换和数据归档 |

## ⚙️ 功能概览

| 功能 | 说明 | 输出 |
| --- | --- | --- |
| ✅ 关键词作品采集 | 按关键词搜索快手作品，采集作品基础数据 | CSV |
| ✅ 评论采集 | 根据关键词搜索结果或指定作品链接采集评论 | CSV |
| ✅ 作品详情采集 | 根据作品链接采集作品详情，并支持视频下载 | CSV、视频文件 |
| ✅ 主页作品采集 | 根据达人主页链接采集主页作品列表，并支持视频下载 | CSV、视频文件 |
| ✅ 链接与 uid 转换 | 支持主页链接、快手号、uid、作品链接之间的转换 | CSV |
| ✅ 自动保存 | 每采集一页立即写入 CSV，降低中断丢数风险 | CSV |
| ✅ 运行日志 | 自动记录运行过程，便于排查问题 | logs日志文件 |

## 🚀 快速开始

1. 打开 [Releases](https://gitee.com/mashukui/kuaishou_one_spider/releases/) 下载最新版软件。
2. 解压后运行对应系统的客户端。
3. 使用软件内置的《cookie小工具》完成cookie配置。
4. 登录软件账号。
5. 选择采集模块，填写关键词、作品链接或主页链接。
6. 点击「开始执行」，等待采集完成。
7. 在软件所在目录查看CSV、视频文件和日志文件。

## 💻 支持系统

| 系统 | 支持情况 |
| --- | --- |
| Windows | 支持，下载Windows客户端即可运行 |
| macOS | 支持，下载macOS客户端即可运行 |

## 🖼️ 功能展示

### 关键词作品与评论采集

关键词作品与评论采集界面：![输入图片说明](screenshots/%E7%95%8C%E9%9D%A21.png)

搜索作品结果：![输入图片说明](screenshots/%E6%95%B0%E6%8D%AE-%E6%90%9C%E7%B4%A2.png)

评论采集结果：![输入图片说明](screenshots/%E6%95%B0%E6%8D%AE-%E8%AF%84%E8%AE%BA.png)

### 作品详情采集

作品详情采集界面：![输入图片说明](screenshots/%E7%95%8C%E9%9D%A2-%E9%80%9A%E8%BF%87%E9%93%BE%E6%8E%A5%E9%87%87%E9%9B%86.png)

作品详情采集结果：![输入图片说明](screenshots/%E6%95%B0%E6%8D%AE-%E8%AF%A6%E6%83%85.png)

自动下载的视频文件：![输入图片说明](screenshots/%E8%A7%86%E9%A2%91%E6%96%87%E4%BB%B6-%E8%AF%A6%E6%83%85.png)

### 主页作品采集

主页作品采集界面：![输入图片说明](screenshots/%E7%95%8C%E9%9D%A2-%E9%87%87%E9%9B%86%E4%B8%BB%E9%A1%B5.png)

主页作品采集结果：![输入图片说明](screenshots/%E6%95%B0%E6%8D%AE-%E4%B8%BB%E9%A1%B5%E4%BD%9C%E5%93%81.png)

自动下载的主页视频文件：![输入图片说明](screenshots/%E8%A7%86%E9%A2%91%E6%96%87%E4%BB%B6-%E4%B8%BB%E9%A1%B5%E4%BD%9C%E5%93%81.png)

### 链接与uid转换

主页链接转快手号：

![输入图片说明](screenshots/%E7%95%8C%E9%9D%A2-%E9%93%BE%E6%8E%A5%E8%BD%ACks%E5%8F%B7.png)

![输入图片说明](screenshots/%E6%95%B0%E6%8D%AE-%E8%BD%AC%E6%8D%A21.png)

快手号转主页链接：

![输入图片说明](screenshots/%E7%95%8C%E9%9D%A2-ks%E5%8F%B7%E8%BD%AC%E9%93%BE%E6%8E%A5.png)

![输入图片说明](screenshots/%E6%95%B0%E6%8D%AE-%E8%BD%AC%E6%8D%A22.png)

App端作品链接转PC端作品链接：

![输入图片说明](screenshots/%E7%95%8C%E9%9D%A2-app%E8%BD%ACpc.png)

![输入图片说明](screenshots/%E6%95%B0%E6%8D%AE-%E8%BD%AC%E6%8D%A23.png)

## 📊 输出字段

软件会根据不同采集模块生成对应的 CSV 文件。字段较多，下面先按数据类型展示主要字段范围；需要完整字段时，可展开查看。

### 搜索作品数据

- 采集信息：关键词、页码
- 作品信息：视频标题、话题标签、视频链接、视频时长、发布时间
- 作者信息：作者昵称、作者 uid、作者主页链接
- 互动数据：点赞数、观看数

<details>
<summary>查看搜索作品完整字段</summary>

关键词、页码、视频标题、话题标签、视频链接、点赞数、观看数、视频时长_秒、发布时间、作者昵称、作者 uid、作者主页链接

</details>

### 评论数据

- 采集信息：作品 id、作品链接、页码
- 评论者信息：用户昵称、用户 id、用户主页
- 评论信息：评论时间、评论点赞数、评论级别、评论内容

<details>
<summary>查看评论完整字段</summary>

作品 id、作品链接、页码、用户昵称、用户 id、用户主页、评论时间、评论点赞数、评论级别、评论内容

</details>

### 作品详情数据

- 采集信息：关键词、作品 id、作品链接
- 作品信息：视频标题、话题标签、发布时间、视频时长、IP 属地、封面链接、视频直链
- 作者信息：作者昵称、作者 uid、作者主页链接
- 互动数据：点赞数、观看数、评论数、收藏数、转发数

<details>
<summary>查看作品详情完整字段</summary>

关键词、作品 id、作品链接、视频标题、话题标签、作者昵称、作者 uid、作者主页链接、发布时间、视频时长_秒、点赞数、观看数、评论数、收藏数、转发数、IP 属地、封面链接、视频直链

</details>

### 主页作品数据

- 采集信息：页码
- 作者信息：作者昵称、uid、作者主页链接
- 作品信息：视频标题、视频标签、视频链接、发布时间、视频时长
- 互动数据：点赞数、收藏数、观看数

<details>
<summary>查看主页作品完整字段</summary>

页码、作者昵称、uid、作者链接、视频标题、视频标签、视频链接、发布时间、视频时长、点赞数、收藏数、观看数

</details>

## 🛠️ 技术说明

软件采用 Python 开发，核心模块包括：

| 模块 | 用途 |
| --- | --- |
| tkinter | GUI 软件界面 |
| requests | 接口请求 |
| json | 响应数据解析 |
| pandas | CSV 数据保存 |
| logging | 运行日志记录 |

软件通过接口协议采集数据，不依赖模拟浏览器等 RPA 操作。采集过程中默认按页保存结果，每页请求间隔约 1-2 秒，便于控制采集节奏并降低异常中断造成的数据损失。

## 💰 价格说明

| 类型 | 使用期限 | 价格 | 适用场景 |
| --- | --- | --- | --- |
| 日卡 | 1 天 | 29 元 | 临时试用、小批量任务 |
| 月卡 | 1 个月 | 149 元 | 短期采集需求 |
| 季卡 | 3 个月 | 349 元 | 中期采集需求 |
| 年卡 | 1 年 | 799 元 | 长期稳定使用 |

开通入口：[https://mgnb.pro/product/kuaishou](https://mgnb.pro/product/kuaishou)

## 🔐 授权规则

- 软件采用一机一码机制，一个卡密仅支持一台电脑使用。
- 一台电脑仅允许运行一个软件实例，不支持多开。
- 软件由作者长期维护，后续版本通过 Gitee Releases 发布。

## ❓ 常见问题

### 是否需要安装 Python？

不需要。软件已打包为桌面客户端，下载对应系统版本后即可运行。

### cookie 是做什么用的？

cookie 用于让软件以当前账号状态访问平台数据。请使用自己的账号 cookie，并妥善保管相关文件。

### 采集中断后数据会丢失吗？

软件按页保存 CSV，不是等全部采集结束后才保存。即使中途中断，已完成页的数据通常仍会保留在结果文件中。

### 结果文件保存在哪里？

默认保存在软件所在文件夹。CSV、视频文件和日志文件会根据功能模块分别生成。

### 支持采集多少数据？

实际可采集数量会受到关键词、账号状态、平台接口返回、网络环境和采集频率等因素影响。建议合理设置采集范围和请求间隔。

### 软件报错怎么办？

请优先查看 `logs` 目录下的日志文件，并在反馈时提供以下信息：

- 软件版本
- 操作系统
- 使用的功能模块
- 输入的关键词、主页链接或作品链接
- 报错截图
- 对应时间段的日志内容

## ⚠️ 合规声明

本软件仅供合法合规的数据分析、学习研究和自有业务场景使用。使用者应自行遵守目标平台服务协议、隐私政策以及所在地法律法规。

请勿将本软件用于以下用途：

- 高频、恶意或破坏性请求
- 未经授权采集、传播或售卖个人敏感信息
- 侵犯平台、作者或用户合法权益的行为
- 违反法律法规或平台规则的其他行为

因使用者不当使用造成的风险和责任，由使用者自行承担。

## 📦 获取软件

- Gitee Releases：[https://gitee.com/mashukui/kuaishou_one_spider/releases/](https://gitee.com/mashukui/kuaishou_one_spider/releases/)
- 公众号 `老男孩的平凡之路` 后台回复：`快手`

<img width="573" height="196" alt="二维码-公众号放底部v4" src="https://github.com/user-attachments/assets/7508c875-4df8-4442-a532-a2a9d10b1833" />