产品与设计
当需要从已查询的商品标题中提取场景词、人群词…
对当前会话中已检索到的商品标题进行分词分析,按单一属性维度提取关键词并分组计数,用于Listing标题优化与竞品关键词规律发现。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
当需要从已查询的商品标题中提取场景词、人特定
解决思路
- 确认当前会话中已有查询到的商品数据;工具会自动聚合当前对话轮次中所有先前步骤(含分页查询)的商品,无需手动传入商品数据,除非引用的是上一轮对话的数据。
- 每次调用只分析一个属性维度(例如场景词或人群词),不要在一次调用中请求多个维度;需要多个维度时拆分为多次调用并依次呈现结果。
- 通过 tokenizationAndCountingRequest 参数用自然语言描述要提取的属性维度,例如场景词用 "Count scene words appearing in product titles",人群词用 "Count audience words appearing in product titles",材质词用 "Count material-related words appearing in product titles",功能/特性词用 "Count function or feature words appearing in product titles"。
- 按需设置 outputMode:默认 MULTIPLE_RECORDS(每个属性值一条记录,便于计数、排序、分组);若想一眼看到每个 ASIN 的全部属性,则用 COMMA_SEPARATED(多个值合并为一条记录、逗号分隔)。
- 仅在引用上一轮对话的数据时,才通过 refResultData 传入外部商品数据(JSON 字符串)。
- 展示时用清晰的表格呈现提取的属性及其频次,并突出最高频的属性值,使规律一目了然。
- 当返回 attributeGroups 时,先展示分组汇总,再展示逐商品明细。
- 若用户需要多个维度,分别调用并顺序呈现结果。
- 响应中的 costToken 除非用户询问用量,否则不要展示。
- 若工具返回错误,说明原因并给出纠正建议(例如提示 "当前会话未找到商品,请先查询商品")。
- 调用 API 端点 POST /product/titleAnalyze,或运行 python scripts/title_analyze.py '<JSON 参数>' [--inline];完整参数、响应与错误码见 references/api.md。
- 遵守成本约束:同一会话同一参数组合默认只调用一次,脚本带 24h 本地缓存;失败或空结果时不得自动更换关键词、翻页或改邮编连续试探,需要继续检索时先向用户说明会产生额外消耗。
- 输出时始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-product-title-analyze-<timestamp>.json(<cwd> 为脚本执行时的工作目录,<session> 取自环境变量 SESSION_ID;禁止写入 /tmp,当前目录不可写则报错);响应体 ≤ 8 KB 时落盘后将完整 JSON 打印到 stdout,> 8 KB 时 stdout 只输出摘要(顶层字段、total/costToken 等常见计数、最大列表字段长度加前 3 条样本);加 --inline 可强制全量打印到 stdout(同样落盘)。
- 读取数据时先看摘要判断是否足够,需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取,避免整份 JSON 进入上下文。
- 遇到未配置 API Key(环境变量 LINKFOX_AGENT_API_KEY 与 LINKFOXAGENT_API_KEY 均未配置)、响应 401 或 402 状态码、或提示算力/余额不足(含 "算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值" 等含义)时,按 references/onboarding.md 引导解决。
- 注意本技能按动态规则计费(消耗算力 = sum(所有被处理商品标题的(输入消耗的算力 + 输出结果消耗的算力))),且按倍数动态计算,可能一次性消耗大量算力,必须提醒用户并由用户决定是否继续。
适用边界 · 注意事项
- 当前会话中尚未查询任何商品时(工具依赖会话上下文中已存在的商品数据,需先提示用户搜索商品)。
- 用于广告/PPC 关键词建议(本工具分析的是已有标题,而非广告关键词)。
- 用于完整 Listing 文案撰写(本工具只提取和统计词,不生成新标题)。
- 用于后台搜索词分析或 ABA 搜索词数据(前者针对可见标题而非隐藏搜索词,后者应改用 ABA Data Explorer 技能)。