kuaishou-commentlisted

# 快手评论分析 ## 📝 简介 输入快手作品链接即可获取一级评论数据，每页 20 条，支持 cursor 游标分页翻页。在对话中展示当前页全部评论及 AI 总结分析，同时生成包含当前页数据和总结的交互式 HTML 报告。 ## ✨ 功能特性 | 功能模块 | 能力描述 | 核心价值 | |---------|---------|---------| | 评论获取 | 粘贴作品链接即可获取评论 | 实时拉取作品评论区数据 | | 分页浏览 | 每页 20 条，cursor 游标翻页 | 逐页浏览大量评论 | | AI 总结 | 四维情感分析（积极/负面/需求/竞品） | 快速了解评论舆情全貌 | | 置顶标记 | 置顶评论特殊标识 | 一眼识别重要评论 | | HTML 报告 | 深色主题交互式报告 | 离线保存/分享分析结果 | | 合并报告 | 多页合并，超3页自动折叠 | 一次导出全部评论分析 | ## 🔑 鉴权 前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取 API Key，通过以下方式配置： ```bash # 方式一：配置文件（如 OpenClaw 的 ~/.openclaw/openclaw.json） { "env": { "REDFOX_API_KEY": "ak_xxxx..." } } # 方式二：终端环境变量 export REDFOX_API_KEY="ak_xxxx..." ``` ## 🔄 工作流程 ### Step 1：理解用户意图，提取 opusId **⚠️ 核心规则：用户提供作品链接，Agent 从链接中提取 opusId。** - 用户提供作品链接（如 `https://www.kuaishou.com/short-video/3x4ibfzs5e68yxu`），Agent 从链接中提取 opusId - 用户也可能直接提供 opusId（如 `3x4ibfzs5e68yxu`），此时直接使用 - 若用户未提供作品链接，主动询问：「请提供快手作品链接」 - 若用户在上一轮对话中查询过某作品的数据，且本轮输入模糊（如"下一页"、"评论分析"），沿用上一轮的 opusId ### Step 2：调用评论获取脚本（自动生成 HTML） **⚠️ 每次调用仅请求一页数据（一次 API 请求），不可擅自发起多次调用拉取多页。** **脚本每次调用自动生成 HTML 报告**（含占位符，未回填分析数据）。终端展示与 HTML 基于**同一次 API 调用**，确保数据一致。 ```bash python3 ~/.agents/skills/kuaishou-comment/scripts/kuaishou_comment_search.py "<opusId>" [--cursor <cursor>] [--page <page>] ``` **参数说明：** | 参数 | 说明 | 默认值 | |------|------|--------| | `opusId` | 快手作品 opusId（必填） | — | | `--cursor` | 游标，首页传空字符串，次页传上一页返回的 nextCursor | "" | | `--page` | 当前页码（仅用于 HTML 文件名和输出标记） | 1 | | `--output-dir` | HTML 输出目录 | ~/Downloads/Qode