SuperAPI AI 工具集

xhs-competitor-research

营销与增长

查看项目

更新于 10-27 12:29

技能介绍

用途:该技能面向小红书竞品研究,帮助用户从本次提供的笔记附件或从小红书采集的公开样本中完成结构化分析。观察单位默认是一篇公开小红书笔记。

输入路由:先识别本次对话实际可访问的附件、文件路径、工作表和用户目标,不把历史文件、示例数据或未提供材料当作本次输入。已提供逐篇笔记附件时进入附件直读模式,不启动浏览器;用户要求根据附件分析但本次无可访问附件时,输出 ATTACHMENT_REQUIRED,请用户上传或给出明确路径。用户要求从小红书采集样本或明确表示没有现成数据时,进入采集研究模式。输入意图无法判断时,只询问一个路由问题。

主要能力:附件直读模式下,列出附件文件名、格式、工作表、原始行数和观察单位,再运行 scripts/analyze_attachment.py 完成字段映射、去重、缺失率、互动口径、10%/30%/60% 分层、数值特征关联和 Tag 统计;脚本输出 analysis-summary.json、cleaned-notes.csv 和 semantic-coding-template.csv,原附件保持只读。随后先交付字段能力矩阵,字段不足的模块写“无法判断”和所缺字段;再按固定量表分批完成内容类型、标题结构、情绪强度、用户需求、开头钩子、价值呈现、信任手段和结尾行动的语义编码,保存逐篇编码与 note_id 或来源行号后汇总比例。采集研究模式下,先生成客户配置卡与研究执行确认单,确认后选择并验证浏览器执行器,串行低频分批采集并保存检查点,按结构化样本、失败记录和数据质量信息保存,最后清洗分析并交付报告。

使用方式:附件模式运行命令 python3 <skill-dir>/scripts/analyze_attachment.py <attachment> --output-dir <derived-output-dir>;XLSX 有多个工作表时增加 --sheet <sheet-name>。本地只读检查、统计和用户已要求的本地报告输出不需要确认执行;浏览补数、飞书写入等外部动作需另行确认。采集模式未收到明确“确认执行”前,不批量浏览、不创建定时任务、不写入飞书;涉及飞书时只通过 lark-cli 执行。默认使用 Codex 自带的 Chrome 控制能力,web-access 仅作为主执行器发生非策略性技术故障时的候选备用执行器,使用前需动态发现并完整读取其 SKILL.md。

适用场景:适合需要基于现有笔记附件做竞品内容分层、爆款关联因子、用户需求、标题与结构、关键词与话题分析的研究;也适合在没有现成数据时,围绕已确认的业务决策、关键词、竞品范围和样本标准采集公开样本。目标超过 100 篇时需说明是长任务并确认批次、进度保存与时长;目标 200–300 篇不得承诺一次运行必然完成;需要长期稳定的大规模数据时,建议评估授权数据源或合规数据服务。

限制:仅读取公开页面和用户现有登录态下可见内容,串行低频访问,不采集与研究无关的个人敏感信息;不点赞、不收藏、不关注、不评论、不私信、不自动发布;不索取密码、Cookie、令牌或浏览器配置,不绕过验证码、登录墙或风控。明确的浏览器安全、网络、组织、域名或平台策略拒绝,以及登录墙、验证码和风控,不得通过备用通道重试。变量关联不得写成因果或“贡献”;平台级或预测性结论只有在对应外部基线或历史验证数据时才能成立。百分比须能回溯到分子、分母和样本范围。新任务无法保证自动继承旧设置,客户配置卡为可复制内容,不声称已永久保存。