SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场linkfox-product-title-analyze

linkfox-product-title-analyze

营销与增长

查看项目

更新于 10-15 09:31

技能介绍

用途

Product Title Analyzer 用于对产品标题进行分词分析，帮助亚马逊卖家从商品 Listing 标题中提取关键词规律、场景词、人群词、材质词等属性维度。它对当前对话中已经检索到的商品标题进行智能分词，使用 LLM 驱动的分析从自由文本标题中抽取结构化属性（场景词、人群词、材质、颜色等），然后分组计数以发现规律。

主要能力

  • 智能分词与属性抽取：对已检索到的产品标题进行分词，提取结构化属性维度。
  • 多维度分析：可分析场景词（使用地点/时间）、人群词（目标用户）、材质词、功能/特性词等。每次调用只分析一个属性维度。
  • 自动数据聚合：工具自动收集当前对话轮次中所有先前步骤的产品，包括跨分页查询，无需手动传入产品数据（除非引用上一轮对话的数据）。
  • 分组统计：返回属性分组（attributeGroups），包含属性名、属性值、共享该值的商品数量及 ASIN 列表。
  • 商品字段输出：返回 ASIN、标题、属性名、属性值、价格、月销量、月销售额、评分、评分数、上架日期、品牌、主图 URL 等。
  • 输出模式：MULTIPLE_RECORDS（默认，每个属性值一条记录）或 COMMA_SEPARATED（多值合并为一条记录，逗号分隔）。

使用方式

API 端点：POST /product/titleAnalyze（完整参数/响应/错误码见 references/api.md）

Python 脚本：python scripts/title_analyze.py '<JSON 参数>' [--inline]

请求字段：

  • tokenizationAndCountingRequest（必填）：自然语言指令，描述要从标题中提取哪个属性维度，例如 "Count scene words in product titles"。
  • outputMode（可选）：多值属性的返回方式，默认 MULTIPLE_RECORDS。
  • refResultData（可选）：外部提供的产品数据，仅在引用上一轮对话数据时需要。

参数示例：

  • 场景词：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 in product titles

注意：不要在一次请求中分析多个维度，应拆分为多次调用。

输出策略（脚本默认行为）：

  • 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-product-title-analyze-<timestamp>.json（<cwd> 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；<session> 取自环境变量 SESSION_ID；禁止写入 /tmp，当前目录不可写则报错）。
  • 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout。
  • 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）。
  • 加 --inline 强制全量打印到 stdout（同样落盘）。
  • 读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

展示规则：

  • 用表格呈现数据：以清晰、可排序的表格展示提取的属性和频率。
  • 突出高频关键词：标出最频繁的属性值，使规律一目了然。
  • 分组摘要优先：当返回 attributeGroups 时，先呈现分组摘要，再呈现逐商品明细。
  • 一次一个维度：若用户想分析多个维度，分别调用并依次呈现结果。
  • Token 成本意识：响应包含 costToken，除非用户询问用量，否则不显示。
  • 错误处理：若工具返回错误，说明原因并建议纠正措施（例如 "当前对话中未找到产品——请先查询产品"）。

适用场景

  • "这些标题里有哪些场景词？"——场景词提取
  • "分析标题关键词"、"标题词频"——通用标题分词
  • "这些产品面向什么人群？"——人群词提取
  • "这些 Listing 常见材质"——材质词提取
  • "帮我根据竞品优化标题"——竞品标题关键词分析
  • "头部卖家标题里用了哪些词？"——高频关键词发现
  • "按标题属性给这些产品分组"——基于属性的产品分组

限制

  • 不适用场景：
    • 尚未查询产品：工具要求产品已存在于对话上下文中，需先提示用户搜索产品。
    • 广告/PPC 关键词建议：本工具分析已有标题，而非广告关键词。
    • 完整 Listing 文案撰写：本工具只提取和计数词语，不生成新标题。
    • 后台搜索词分析：用于可见标题分析，而非隐藏搜索词。
    • ABA 搜索词数据：应改用 ABA Data Explorer 技能。
  • 成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。
  • 算力消耗规则：按动态规则计费，消耗算力 = sum(所有被处理商品标题的(输入消耗的算力 + 输出结果消耗的算力))。本技能的服务按倍数动态计算，可能一次性消耗大量算力，必须提醒用户，由用户决定是否继续。

认证与算力问题

发生以下异常情况时，采用 references/onboarding.md 引导解决：

  • 未配置 API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
  • 响应 401 或 402 状态码。
  • 响应提示算力或余额不足：消息含 "算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。