kuaishou-account-works

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

SKILL.md

GitHub

快手账号作品查询

📝 简介

快手账号作品查询工具,覆盖两个互补场景(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 完整接口说明与返回字段文档