Kuaishou Account Works

---
name: kuaishou-account-works
description: 快手账号作品查询工具，集作品列表与详情两大能力。通过账号平台展示id（kwaiId）或主页链接id（threeXId）查询该账号全部作品列表（按发布时间倒序，含播放/点赞/评论/收藏/分享/时长/封面/视频链接）；通过作品ID（photoId）精确查询单条作品正文详情。当用户需要按账号查询快手作品列表、查看某博主全部作品、分析对标账号作品数据、深挖单条爆款作品、查看作品正文数据时使用。触发词：按账号查作品、快手作品列表、账号作品查询、查账号视频、对标账号作品、作品详情、作品正文、查作品详情、单条作品、爆款详情、作品数据详情。
---
# 快手账号作品查询

## 📝 简介

快手账号作品查询工具，覆盖两个互补场景（Lindorm 数据源）：

1. **账号作品列表**：通过快手账号平台展示 id（kwaiId）或主页链接 id（threeXId）精准匹配查询该账号的作品列表，按发布时间倒序返回。
2. **单条作品详情**：通过作品 ID（photoId）精确匹配查询单条作品正文详情，深挖爆款数据。

标题、播放数、点赞数、评论数、收藏数、分享数、转发数、视频时长、封面与视频链接一览无余。

## ✨ 功能特性

| 功能模块 | 能力描述 | 核心价值 |
|---------|---------|---------|
| 双 ID 查询（列表） | 支持 kwaiId / threeXId 两种账号标识 | 有主页链接或平台 id 均可查询 |
| 账号作品列表 | 精准匹配该账号全部可见作品，发布时间倒序 | 一次拉取完整作品库，掌握最新内容 |
| photoId 精准查询（详情） | 通过作品 ID 精确匹配单条详情 | 深挖单条作品的完整数据 |
| 完整数据维度 | 播放/点赞/评论/收藏/分享/转发/时长 | 全面评估作品表现 |
| 作者信息 | 昵称 + 粉丝数 + 头像 | 快速了解作者影响力 |
| 分页浏览 | 每页最多 50 条，支持多页翻看 | 不遗漏任何一条内容 |
| 作品直达 | 直接输出封面与视频 URL | 快速查看/下载原片 |

## 🎯 适用对象

- 🔍 **内容创作者** — 拆解对标账号作品结构、深挖单条爆款，研究爆款规律。
- 📊 **运营 / 数据分析** — 摸清账号更新频率与流量趋势，精确追踪单条作品表现。
- 🏢 **品牌 / MCN** — 筛查合作达人的作品表现，评估单个合作作品的实际价值。
- 🛒 **电商选品** — 查看带货账号的最新作品，匹配推广方向。

## 🔑 鉴权

### 获取 API Key
1. 访问 [红狐Hub 官网](https://redfox.hk/?source=github) 了解服务详情
2. 前往 [注册页面](https://redfox.hk/login?source=github) 注册账号
3. **新注册用户将获赠免费积分**，可立即开始使用 API 服务
4. 注册登录后，在个人中心获取 API Key，格式为 `ak_xxxxxxxx`

### 配置 API Key
- `REDFOX_API_KEY` 从环境变量获取，格式 `ak_xxxxxxxx`
- 若未设置，提示用户自行配置：`export REDFOX_API_KEY=<你的apikey>`；若用户不会配置，Agent应主动帮用户设置：
  - **macOS/Linux**：将 `export REDFOX_API_KEY=<值>` 追加到 `~/.zshrc`（zsh）或 `~/.bashrc`（bash），然后 `source` 对应文件使其全局生效
  - **Windows**：使用 `[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<值>", "User")` 设置用户级永久环境变量（需重启终端生效）
  - 配置完成后应验证：`echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows），确保换一个skill也能读取到


## 🔄 使用指南

本技能支持两大核心场景：
- **场景 A — 按账号查询作品列表**：通过 kwaiId 或 threeXId 查询账号全部作品，获取播放、点赞、评论等完整互动数据，按发布时间倒序展示
- **场景 B — 查询单条作品详情**：通过 photoId 精确查询单条作品正文详情，深挖爆款数据

> 详细执行步骤、参数说明与输出格式详见 `references/core_workflow.md`

---

## ⏰ 数据时效说明

> 数据每日早上 **06:00** 更新（广域库快照）。

## 📂 相关文件

| 路径 | 用途 |
|------|------|
| scripts/search_ks_work.py | 账号作品列表查询脚本 |
| scripts/search_ks_detail.py | 作品详情查询脚本 |
| `references/core_workflow.md` | 核心执行流程与输出规范 |
| README.md | 完整接口说明与返回字段文档 |