← 全部技能
Keepa 数据1 积分/次

Listing 文案与变体

yasina-keepa-listing-content

取商品的标题、五点描述、图片与 A+ 内容,或列出全部变体。

这个技能能做什么

基于 Keepa 取回亚马逊商品的 listing 内容,用于文案分析与竞品拆解:标题、五点描述(bullet features)、长描述、主图与全部图片 URL、品牌与制造商。可选加上 A+ 页面模块的文字与图片 alt 文本(`includeAPlus`)与视频元数据(标题、时长、创作者、URL,`includeVideos`)—— 这两个开关都不额外收费。HTML 标签已被剥离,拿到的是纯文本。另有 `--variations` 子命令查同一商品家族的全部变体:变体维度(尺寸/颜色/口味)、每个变体的 ASIN 与属性值,可选带上每个变体的当前价格、排名与评分(`includePrices`),也可选包含已下架与断货的历史变体。父 ASIN 或子 ASIN 都能查,数据源两边都能解析出整个家族。覆盖 11 个亚马逊站点。当用户提到 Keepa、keepa、五点描述、bullet point、商品描述、listing 文案、标题怎么写、卖点、A+ 内容、A+ 页面、视频、商品图片、主图、图片链接、抄竞品文案、竞品怎么写的、文案优化、变体、变体列表、有哪些颜色、有哪些尺寸、哪个变体最便宜、父 ASIN、子 ASIN、SKU 家族、listing content, bullet points, product description, a plus content, product images, variations, variants, parent asin, child asin 时触发此技能。即使用户未明确提及“文案”,只要其需求是了解某个商品页面上写了什么、或者这个商品有哪些规格版本可选、哪个版本卖得好,也应触发。不适用于:价格销量排名等数据指标(用 yasina-keepa-asin-insight)、评论正文与星级分布(数据源不提供评论内容)、关键词自然排名(用 yasina-amazon-search)、亚马逊页面的实时抓取(用 yasina-amazon-product-detail)。

怎么用

复制下面这句话,发给你的 AI 助手(WorkBuddy、Claude Code、Codex 都可以):

下载 https://plusskill.oss-cn-guangzhou.aliyuncs.com/skills/yasina-keepa-listing-content.zip 并安装这个 skill,然后阅读这个 skill 告诉我如何使用

助手会自动下载安装并读懂用法,然后告诉你能问它什么。 首次使用它会引导你用手机号注册,赠送 50 积分。

入参

本技能覆盖 2 个端点,参数各不相同,按各自的表来传。

Listing 文案与变体

POST /v2/keepa/get-product-content
参数类型必填说明默认
asinstring是

商品 ASIN(10 位字母数字)

无
domainstring否

站点,见下方取值表

com
includeAPlusbool否

带上 A+ 模块的文字与图片 alt 文本。不额外收费

false
includeVideosbool否

带上视频元数据。不额外收费

false
refreshIfOlderThanHoursint否

数据源数据超过 N 小时则去亚马逊重取。0=每次实时,-1=绝不刷新

数据源默认

变体列表

--variationsPOST /v2/keepa/get-product-variations
参数类型必填说明默认
asinstring是

家族里任意一个 ASIN,父或子都行

无
domainstring否

站点,见下方取值表

com
includePricesbool否

带上每个变体的当前价(priceNew / priceAmazon)与排名(salesRank)。⚠️ 不传的话连 `salesRank` 都是 `None` —— 实测 includePrices: false 时每条只剩 asin 与 attributes,价格和排名全为空。要做价差/排名分析就必须传 true。⚠️ 但 rating / reviewCount 传了也还是 `None`(与商品档案同源的限制)

false
includeUnlistedbool否

包含已下架与断货的历史变体

false
maxVariationsint否

返回几个变体,1~100 是硬上限(商品最多可有 4000 个)。⚠️ 传 101 以上直接报错,而且没有任何翻页手段 —— 见下方 variationCount

20
refreshIfOlderThanHoursint否

数据源数据超过 N 小时则去亚马逊重取。0=每次实时,-1=绝不刷新

数据源默认

返回值

Listing 文案与变体

POST /v2/keepa/get-product-content
字段怎么用
title / brand / manufacturer

标题、品牌、制造商

features[]

五点描述数组。写文案时的主要参考对象。⚠️ 不一定只有 5 条:实测 B07FZ8S74R 返回 8 条(各 85~275 字节)—— 亚马逊前台只显示 5 条,数据源给的是这个字段的全部内容。所以「竞品写了几条五点」要按实际条数说,不要预设 5。

只有前 1000 字节被索引,算的时候按字节而不是字符。实测 B073DTZ6KZ 的 5 条共 1045 字节 —— 第 5 条整条落在索引窗口外;B07FZ8S74R 的 8 条共 1351 字节,第 6 条起就出界了

description

长描述(HTML 已剥离)

imageUrls[]

全部图片 URL

aPlusText

A+ 内容的文字(includeAPlus 时才有;不传这个参数时连这个键都不存在)。⚠️ 传了也可能是空数组:实测 B07FZ8S74R 返回 0 条,同批 B0H35LD67G 14 条、B073DTZ6KZ 4 条。键不存在 = 没传参数;空数组 = 这个品确实没有 A+ —— 两者要分开判断。把空数组说成「忘了传参数」会让用户白跑一次,反过来把没传参数说成「竞品没做 A+」更糟,那是会影响决策的错误结论。

⚠️ 键名是 `aPlusText` 不是 `aPlus`,而且是一个扁平字符串数组,没有任何结构标注 —— 图片 alt 文本、模块标题、模块正文混在同一个数组里,分不出哪条是哪种。实测 B00FLYWNYQ 的 19 条里,前 9 条是重复的图片 alt(Instant Pot Duo 出现 4 次),第 9~17 条才是「标题 + 正文」交替的模块文案。

所以它能回答「A+ 里写了哪些词」,不能回答「A+ 有几个模块」「图片 alt 写了没」。条数差异极大:实测 19 / 28 / 4 / 4 条,条数少不代表 A+ 做得差

videos

视频(includeVideos 时才有)。每条只有 `creator` 与 `url` 两个键,没有时长/标题/封面,creator 多为 Main。实测 10~11 条,url 是 m3u8 流地址(不是可直接播放的 mp4)

变体列表

--variationsPOST /v2/keepa/get-product-variations
字段怎么用
parentAsin

父 ASIN

variationCount

变体总数。⚠️ 它可能远大于你能拿到的条数,而超出 100 的那部分拿不到 —— maxVariations 上限 100,且 page / offset 这类参数传了会被静默忽略(实测传 page: 2 / offset: 100 返回的 100 条与不传时逐条相同,首末 ASIN 都一样;两次不传的结果也完全一致,说明那 100 条是固定子集)。

所以 `variationCount` 大于 100 时,任何「这个家族有几种尺码/颜色」的结论都必须注明「基于前 100 个变体」 —— 实测 522 个变体的父体有 422 个永远看不到

dimensions[]

变体维度名,如 ["Size", "Color"]

variations[].asin

变体的 ASIN

variations[].attributes

该变体在各维度上的取值,如 {"Size": "Medium", "Color": "Navy Blue"}。这是唯一不依赖 `includePrices` 的字段

variations[].priceNew / priceAmazon / salesRank

要传 `includePrices: true` 才有值。注意同家族的 salesRank 全都是同一个数字(排名由变体组共享),不能用它比较哪个变体更好卖

variations[] 里没有库存字段

⚠️ 变体行的全部键就是 asin / attributes / priceNew / priceAmazon / rating / reviewCount / salesRank —— 没有任何库存/在库量字段,「哪个尺码快断货了」这个问题本端点答不了。

替代路径(已实测可行):把子体 ASIN 丢给商品档案端点,读 availabilityAmazon 与 prices.NEW.outOfStockPercentage90(20/20 都有值)。但那是历史断货率,不是当前库存件数;且要挑自己在卖的那个价格类型看,别取各类型最大值 —— 见该字段的说明

note

数据源提示(如只返回了 3 个、共 50 个)

积分收费规则

1 积分/次。A+ 内容与视频(includeAPlus、includeVideos)不额外收费,写 listing 时都打开即可。

--variations 列变体 1 积分/次;要带上每个变体的价格与排名(includePrices),+5 积分/100 个变体。

调用失败(参数错误、数据源不可用)不扣积分。

对应的 API 端点

  • POST/v2/keepa/get-product-content
  • POST/v2/keepa/get-product-variations

同类技能