快手账号作品查询

📝 简介

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

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

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

✨ 功能特性

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

🎯 适用对象

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

🔑 鉴权

获取 API Key

1. 访问 红狐Hub 官网 了解服务详情
2. 前往 注册页面 注册账号
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	完整接口说明与返回字段文档