中级OpenClaw Skill

搜索 Listing 优化

把“这个商品页面怎么优化”变成一份有条理的 Listing 修改清单。提供销售平台、商品资料、现有文案和已观察到的问题后,这项 Skill 的 Python 程序会整理关键词建议、商品属性检查和可能影响购买理解的内容,方便运营安排下一轮标题、卖点与详情页修改。

浏览量
0
复制次数
0
收藏
0
编辑评分
84/100
01

这个 Skill 是做什么的

这项 Skill 根据你提供的商品和页面资料生成优化简报,不会读取平台实时排名。输出会集中呈现搜索表达、商品属性以及可能让买家犹豫或误解的内容,便于运营把零散的修改想法变成具体任务。

使用时需要逐条对照真实页面确认建议。程序包含默认问题和经验权重,某一项被列出来,不代表页面一定存在该问题,也不代表平台官方认为它有某个权重。适合辅助初步检查,最终改动应结合商品事实、平台要求和已有经营数据。

02

它有什么特色

01

方法与优势

Python 程序把检查结果整理成统一的 Markdown 结构,方便多人协作审核。团队可以带着现有 Listing 和明确目标,一起审核关键词、属性和转化优化建议,不必再汇总多人各自提出的零散意见。

02

适用任务

输入时明确平台,并把已确认的问题和待核对建议分开处理。程序遇到未知平台会默认按 Amazon 处理,也可能采用通用权重;因此更适合用来列检查事项,不能把输出当作排名因素证明或销量提升预测。

03

安装前的特殊要求

需要准备的输入

平台、商品细节、现有商品资料、优化目标和已观察到的问题。

Agent 与运行环境

使用支持 Skill 且能访问文件的 Agent。随包 Python 辅助工具需要 Python 3;提供数据前先查看样例结构。

需确认的适用边界

不读取实时排名或卖家 API。代码会补入默认问题、把未识别平台设为 Amazon,并回退到通用属性权重;这些不等于实测缺陷或官方排名权重。

04

安装与开始使用

将指令发给实际使用该 Skill 的 OpenClaw Agent,由它安装指定发布者的版本并检查工作区配置。

  1. 在需要运行该 Skill 的工作区使用当前 OpenClaw CLI。
  2. 安装下方带发布者标识的固定版本,并用 info 命令查看路径和依赖。
  3. 新开 Agent 会话,先阅读安装后的说明,再配置所需服务。
请在我当前的 OpenClaw 工作区安装 @harrylabsj/search-listing-optimizer,固定版本 1.0.0。使用该发布者的原始 ClawHub 包,不替换成其他同名包。先检查是否已安装,不强制覆盖本地修改。执行: openclaw skills install @harrylabsj/search-listing-optimizer --version 1.0.0 openclaw skills info search-listing-optimizer 阅读 SKILL.md 及安装参考文件,列出所需工具、依赖和凭据,返回实际版本、安装路径和准备状态;需要时新建会话。不把安装完成说成已通过业务任务测试。
05

原始 Skill.md

以下为已核对版本未经改写的 SKILL.md。安装完整包才能保留引用的脚本、素材和指引。下方启动提示词为 EcomAgentTools 编写的示例。

---
name: search-listing-optimizer
description: Optimize ecommerce product listings for Amazon A9, Taobao/1688 search, JD search, TikTok Shop discovery, Xiaohongshu SEO, and Shopify storefront search using keyword density frameworks, attribute-completeness checklists, and conversion-trap detection. Use when sellers need a listing audit, keyword refresh, or conversion improvement brief without live search analytics or platform API access.
---

# Search Listing Optimizer

## Overview

Use this skill to audit a product listing and generate an optimization brief covering keyword targeting, attribute completeness, image metadata, and conversion-trap detection. It applies built-in search-ranking heuristics and best-practice libraries to surface actionable improvements.

This MVP is heuristic. It does **not** connect to live search analytics, A9 algorithms, or platform seller portals. It relies on the user's provided listing notes and product context.

## Trigger

Use this skill when the user wants to:
- audit an Amazon, Taobao, JD, TikTok Shop, Xiaohongshu, or Shopify listing for search visibility
- identify missing keywords, weak attributes, or conversion traps in existing copy
- rebuild a listing keyword strategy for a new product or category entry
- compare listing quality across multiple marketplaces
- generate a before-and-after optimization brief for a product team

### Example prompts

- "Audit our Amazon skincare listing for A9 visibility"
- "Help me optimize our Taobao product listing for crowd-collapse ranking"
- "What's wrong with our JD listing that gets traffic but no conversions?"
- "Create an optimization brief for our new TikTok Shop product"

## Workflow

1. Capture the platform, product context, and optimization goal.
2. Apply keyword-density and search-intent frameworks for the target platform.
3. Assess attribute completeness across key fields.
4. Detect common conversion traps (pricing, images, reviews, description).
5. Return a markdown optimization brief with prioritized action items.

## Inputs

The user can provide any mix of:
- platform: Amazon, Taobao, 1688, JD, TikTok Shop, Xiaohongshu, Shopify, general
- product category: category name, subcategory, price range
- current listing notes: title, bullet points, description, keywords, images, reviews
- optimization goal: visibility boost, conversion improvement, new listing, relaunch
- competitor context: competitor ASINs, titles, or keyword strategies (optional)

## Outputs

Return a markdown brief with:
- platform search algorithm summary (how ranking works on that platform)
- keyword opportunity map (search volume intent × competition)
- listing attribute scorecard (title, bullets, description, backend keywords, images)
- conversion-trap detection (pricing, trust signals, review depth, description clarity)
- prioritized action list with expected impact
- template for revised title, bullets, or description

## Safety

- No live search analytics, ad console, or seller portal access.
- Optimization recommendations are directional; actual ranking depends on platform algorithms.
- Do not claim guaranteed ranking improvements or sales lift.
- Pricing and promotional decisions remain with the operator.

## Best-fit Scenarios

- sellers preparing new listings or refreshing existing ones for better visibility
- teams managing multiple marketplace accounts needing a consistent audit framework
- brands expanding to new platforms and needing a listing best-practice brief

## Not Ideal For

- real-time rank tracking, automated listing updates, or live ad campaign management
- products in highly regulated categories with strict claim restrictions
- very early-stage products with no sales history or review data

## Acceptance Criteria

- Return markdown text.
- Include attribute scorecard, keyword opportunity map, and prioritized action list.
- Make ranking assumptions explicit.
- Keep the brief practical for marketplace sellers and listing specialists.
06

开始使用

以下是主要功能的用例提示词,可以直接复制使用。

01

根据 Amazon 商品说明起草审核

根据 Amazon 商品说明起草审核 适用于:根据 Amazon 商品说明起草审核。请准备:平台、商品细节、现有商品资料、优化目标和已观察到的问题。

查看 Prompt 和变量收起 Prompt 和变量
请使用已安装的 search-listing-optimizer Skill。任务:根据 Amazon 商品说明起草审核。输入:[INPUT]。限制:[CONSTRAINTS]。先检查缺失信息,再输出可审查的结果、依据、假设和下一步。不读取实时排名或卖家 API。代码会补入默认问题、把未识别平台设为 Amazon,并回退到通用属性权重;这些不等于实测缺陷或官方排名权重。

需要替换的变量

[INPUT]
平台、商品细节、现有商品资料、优化目标和已观察到的问题。
[CONSTRAINTS]
任务范围、允许的操作、输出格式和审核要求。
02

制作关键词与属性核对清单

制作关键词与属性核对清单 适用于:制作关键词与属性核对清单。请准备:平台、商品细节、现有商品资料、优化目标和已观察到的问题。

查看 Prompt 和变量收起 Prompt 和变量
请使用已安装的 search-listing-optimizer Skill。任务:制作关键词与属性核对清单。输入:[INPUT]。限制:[CONSTRAINTS]。先检查缺失信息,再输出可审查的结果、依据、假设和下一步。不读取实时排名或卖家 API。代码会补入默认问题、把未识别平台设为 Amazon,并回退到通用属性权重;这些不等于实测缺陷或官方排名权重。

需要替换的变量

[INPUT]
平台、商品细节、现有商品资料、优化目标和已观察到的问题。
[CONSTRAINTS]
任务范围、允许的操作、输出格式和审核要求。
03

区分已观察到的转化问题与默认建议

区分已观察到的转化问题与默认建议 适用于:区分已观察到的转化问题与默认建议。请准备:平台、商品细节、现有商品资料、优化目标和已观察到的问题。

查看 Prompt 和变量收起 Prompt 和变量
请使用已安装的 search-listing-optimizer Skill。任务:区分已观察到的转化问题与默认建议。输入:[INPUT]。限制:[CONSTRAINTS]。先检查缺失信息,再输出可审查的结果、依据、假设和下一步。不读取实时排名或卖家 API。代码会补入默认问题、把未识别平台设为 Amazon,并回退到通用属性权重;这些不等于实测缺陷或官方排名权重。

需要替换的变量

[INPUT]
平台、商品细节、现有商品资料、优化目标和已观察到的问题。
[CONSTRAINTS]
任务范围、允许的操作、输出格式和审核要求。
07

实际使用案例:把信息不足的 Shopify 商品页补成可审稿

输入售价 $24 的杯具主档与现有页面文本,页面缺容量、材质、护理和清晰运费。目标是让站内搜索字段与购买说明使用同一套事实。

使用步骤与 Prompt

  1. 准备下方案例输入资料,保留商品、政策和经营记录中的金额、单位及时间口径。
  2. 找出顾客判断容量、护理和到手价时缺少的信息,重写标题、卖点与描述,并解释各项调整。
  3. 提交下方完整 Prompt,查看右侧主要产物;需要交接给同事时,下载包含全部交付文件的压缩包。

案例输入资料:business-inputs.zip

Use the search-listing-optimizer Skill.

Rewrite our Shopify listing so shoppers can judge capacity, care and delivered price before buying. Review the existing title, attributes and copy, identify relevant keyword themes, then deliver a new title, bullets and description with an explanation of each change. Do not invent search volume, ranking weights, reviews or product claims.

The attached business materials are:
- inputs/brief.json
- inputs/brief.txt

Deliver a complete result.md report that the operations team can read, plus any finished files needed for this task. Keep supporting calculations and evidence with the deliverables. Write the report in English; use the requested target language for customer-facing copy. The business datasets are fictional examples unless the brief explicitly names a live public website.

运行结果

下方直接展示本次 Prompt 产生的主要文件,保留实际输出语言。

HarborMug Shopify listing rewrite

Make capacity, care and the shipping-inclusive price visible beside the purchase controls. Keep the $24 product price, but show $29 for one mug including US shipping, before any applicable tax. Two mugs do not qualify for free shipping.

The supplied business data is synthetic; this report contains draft recommendations, not measured market evidence or achieved results. Customer-facing copy is in English, matching the supplied listing and US market.

Finished customer-facing copy

Title

HarborMug 500 mL Insulated Stainless Steel Mug — Blue

Bullets

  • 500 mL capacity: Blue insulated stainless steel mug.
  • Size and weight: 9 × 9 × 19 cm; 0.35 kg.
  • Care: Hand-wash only. Not microwave safe.
  • Price and shipping: $24 per mug. One mug is $29 including standard US shipping, before any applicable tax. Shipping is $5 on orders below $50 and free on orders of $50 or more.
  • Dispatch and delivery: US shipping only. Dispatch in 2 business days; delivery in 3–5 business days. Allow dispatch time in addition to delivery time.
  • Returns: Unused items may be returned within 30 days. Final refund requires merchant approval.

Description

Choose the HarborMug in blue for a 500 mL insulated stainless steel mug. Check the capacity and measurements against the mug you want: dimensions are 9 × 9 × 19 cm and weight is 0.35 kg. No tested insulation retention duration is available.

Care Hand-wash only. Do not microwave.

Price and US shipping The mug costs $24. Shipping is $5 on orders below $50 and free on orders of $50 or more. One mug costs $29 including shipping, before any applicable tax. Two mugs have a $48 merchandise subtotal and cost $53 including shipping, before any applicable tax.

Orders ship within the US only. Dispatch is in 2 business days, with delivery in 3–5 business days. Allow dispatch time in addition to delivery time.

Returns Unused items may be returned within 30 days. Final refund requires merchant approval.

Frequently asked questions How much does it hold? 500 mL. Can I put it in the dishwasher or microwave? Hand-wash only; it is not microwave safe. How long does it keep drinks hot or cold? The mug is insulated, but no tested retention duration is available. Do two mugs qualify for free shipping? No. Two mugs total $48 before shipping; free shipping starts at $50.

Why each change matters

ElementExisting content or gapChange and purpose
Title“HarborMug Blue Mug”Retains brand and color; adds 500 mL, insulated and stainless steel so shoppers can identify the product and capacity at a glance.
Capacity bulletOnly “Insulated stainless steel mug”Adds the exact 500 mL capacity without inventing serving counts.
Size and weight bulletAbsentAdds the supplied dimensions and weight for fit comparisons. Dimension axes are unspecified, so no diameter or height labels are invented.
Care bulletAbsentMakes hand-washing and microwave restrictions visible before purchase.
Price bulletDescription says only “$24”Separates item price from customer shipping and gives the one-mug total before tax. The merchant’s $4 shipping cost is not the shopper’s $5 shipping charge.
Shipping bulletAbsentStates US-only shipping and separates dispatch from delivery; avoids presenting 3–5 days as an order-to-door guarantee.
Returns bulletNo visible policyAdds the unused condition, 30-day window and merchant approval requirement; does not promise an automatic refund.
Description opening“Your everyday mug. $24.”Replaces generic language with capacity, material, color, measurements and weight. Keeps insulation wording within the supplied claim.
Description care and policy sectionsMissingGives shoppers scannable answers and reinforces the same terms as the bullets.
FAQAbsentAnswers capacity, care, insulation-duration and two-mug shipping questions directly. No retention time, leakproof claim or health/environmental guarantee is added.

Keyword opportunity map

These are product-relevant search themes, not measured demand. Search volume and competition are unknown for every theme; priority reflects match to the product and the shopper’s decision. No ranking weights or target keyword percentages are assumed.

Theme and example queriesIntentVolume / competitionPriority and placement
insulated stainless steel mug; stainless steel mugFind product by material and insulationUnknown / unknownHigh: title and opening description
500 mL mug; 500ml mugFind a specific capacityUnknown / unknownHigh: canonical “500 mL” in title, bullet and description; test “500ml” in storefront search before adding variants
blue mug; HarborMugColor or brand lookupUnknown / unknownHigh: title; blue as a color attribute
mug dimensions; mug weightCompare physical fitUnknown / unknownMedium: specifications and second bullet
hand-wash mug; microwave safe mugCheck care compatibilityUnknown / unknownHigh for decision clarity: care and FAQ; answer microwave queries truthfully with “not microwave safe”
mug shipping cost; mug returnsResolve purchase objectionsUnknown / unknownHigh for decision clarity: purchase-area shipping text and policy sections

Do not target “leakproof,” “spillproof,” “dishwasher safe,” “BPA-free,” “eco-friendly,” “travel mug,” or retention-hour phrases without supporting product evidence. Do not add irrelevant synonyms simply to repeat keywords. Natural coverage of the main product phrase and its attributes is the density framework here; no optimal percentage is established.

Shopify search assumptions

Shopify documents product titles, descriptions and product types as places to use shopper terms; its search behavior depends on the storefront implementation. This draft assumes Shopify’s built-in storefront search. Check the actual theme and any third-party search app before relying on those fields. See Shopify search behavior.

Search & Discovery can use product information including category and tags for semantic understanding. Proposed tags are organizational suggestions, not an Amazon-style backend keyword field or a promise of visibility. No fixed field weights or ranking lift are claimed. See Shopify Search & Discovery.

Attribute scorecard

Qualitative assessment of the supplied listing, not an algorithm score. “Draft complete” means the copy is supplied here, not that a store was changed.

FieldCurrent assessmentFinished draft / operational action
TitlePartial: brand and color onlyDraft complete: material, capacity and insulation added
BulletsPartial: one general featureDraft complete: specifications, care, price, shipping and returns
DescriptionIncomplete: generic wording and item priceDraft complete: product details, policy sections and FAQ
Product attributesFacts supplied but not shown in listingSet vendor HarborMug, product type Mug, color Blue, material stainless steel, capacity 500 mL, weight 0.35 kg, dimensions 9 × 9 × 19 cm; retain supplied SKU internally
CategoryNot suppliedSelect the applicable mug category from the store’s current taxonomy; no category ID is invented
Tags / backend keywordsEmpty keyword listSuggested tags: insulated mug; stainless steel mug; 500 mL mug; blue mug. No separate backend-keyword field assumed
Images and alt textOne clear photo reported; no alt textSuggested primary alt: “HarborMug blue stainless steel mug.” Confirm it describes the actual photo before use
Capacity/care imageMissing infographicAdd a factual 500 mL / dimensions / care graphic; keep the same information in text for accessibility
Lifestyle imageAbsentLower priority: use a real product image in context, with no implication of unsupported lid, fit or leak resistance
Pricing and shippingOnly $24 visibleDraft complete; mirror threshold and charge in shipping settings and cart
Returns and FAQMissingDraft complete, subject to policy detail below
ReviewsSupplied summary onlyNo review badge or quotations drafted; synthetic 12-review, 4.5/5 figures must not be published as real reviews

Images were described in the brief but not supplied for visual inspection. No image asset or lifestyle scene has been fabricated.

Conversion traps and decisions

  • Delivered-price surprise: $24 is the item price, not the single-mug shipping-inclusive total. Display $29 before applicable tax near Add to cart. The final tax-inclusive delivered price cannot be quoted from the supplied data because destination and tax treatment are absent.
  • Threshold confusion: Two mugs cost $48 before shipping and $53 with shipping. Shipping charges do not make this merchandise subtotal eligible for free shipping. Keep the existing threshold; this is a disclosure recommendation, not a pricing change.
  • Care mismatch: Hand-wash only and not microwave safe must be visible without requiring a FAQ click.
  • Insulation expectations: “Insulated” is supported; retention duration is untested. Do not add hot/cold-hour promises.
  • Policy ambiguity: The brief does not say when the 30-day return window begins, who pays return postage, or whether shipping is refundable. The copy preserves the supplied terms. Operations should confirm these details for the full policy before publication; do not silently assume free returns or a delivery-based window.
  • Timing ambiguity: Copy treats delivery as following dispatch to avoid understating elapsed time. Confirm whether the supplied 3–5 business days is transit time before making a combined arrival estimate.

Price check

All amounts are USD; totals exclude any applicable tax. Customer shipping uses $5 below a $50 merchandise subtotal and $0 at or above $50. No discounts were supplied.

QuantityMerchandise subtotalCustomer shippingTotal before taxFree shipping?
1$24$5$29No
2$48$5$53No
3$72$0$72Yes

Supporting arithmetic is in price-calculations.csv. No weekly sales comparison is used as evidence of copy effectiveness: these figures precede this unimplemented draft.

Prioritized implementation and validation

PriorityActionExpected practical effect, not a measured lift
1Place capacity, care and the one-mug price before tax near purchase controls; apply the revised title and bulletsHelps shoppers judge size, upkeep and cost before ordering
1Confirm return-window start, return-shipping terms and dispatch/delivery interpretation; align full policies with product textReduces avoidable policy and timing misunderstandings
1Verify cart shipping at $24, $48, below $50, exactly $50 and above $50; confirm US-only eligibility and tax displayKeeps the advertised amount consistent with checkout
2Apply description, product attributes and relevant tags; confirm categoryGives shoppers and storefront search clearer product information
2Add accurate alt text and a factual specifications/care imageMakes supplied facts easier to find and improves image accessibility
3Test storefront queries “HarborMug,” “blue mug,” “500 mL mug,” “500ml mug” and “stainless steel mug,” including mobile predictive searchChecks actual discovery behavior without assuming indexing or rank
3After implementation, compare product add-to-cart and purchase rates over comparable traffic; track care, capacity and shipping questionsProvides evidence for later revisions; no effect is yet measured

No store URL, store configuration or search analytics was supplied, so this is a completed copy and attribute brief, with calculated shipping totals, rather than a live storefront validation. No store changes were made.

Deliverables

  • result.md: full report and finished customer-facing copy.
  • listing-copy.json: reusable title, bullets, description and proposed metadata; not an automatic Shopify import.
  • price-calculations.csv: quantity examples using the supplied customer shipping rules.
  • evidence.md: source facts, claim boundaries and calculation rules.

案例中的商家经营资料为模拟数据;涉及网站检查时,报告中的页面观察来自所列公开网址。

08

风险与使用注意事项

已知限制

不读取实时排名或卖家 API。代码会补入默认问题、把未识别平台设为 Amazon,并回退到通用属性权重;这些不等于实测缺陷或官方排名权重。

证据与复核

核对源码及随包文件:ClawHub 1.0.0。本次为静态审查,不代表已完成安装运行或业务效果测试。

采用结果前

使用获授权输入,不把密钥贴入提示词。采用前检查面向客户的声明、计算、代码改动及任何拟议的外部操作。

常见问题

它能做什么,有什么优势?

根据商品说明和平台背景生成规则式商品审核简报。Python handler 将关键词、属性和转化障碍建议整理为 Markdown。

如何安装和开始使用?

按实际 Agent 选择方式,安装完整包,不要只复制页面中的 SKILL.md。 平台、商品细节、现有商品资料、优化目标和已观察到的问题。 开启新 Agent 会话,明确要求使用 search-listing-optimizer。先用小型样本尝试下方一个场景,并检查输出。

适合哪些使用场景?

根据 Amazon 商品说明起草审核;制作关键词与属性核对清单;区分已观察到的转化问题与默认建议

使用前需要了解哪些限制?

不读取实时排名或卖家 API。代码会补入默认问题、把未识别平台设为 Amazon,并回退到通用属性权重;这些不等于实测缺陷或官方排名权重。

本页核对了什么?

核对源码及随包文件:ClawHub 1.0.0。本次为静态审查,不代表已完成安装运行或业务效果测试。

暂无评论。

发表评论

请先为每一项打分,再分享你的真实使用体验。

任务有效性
安装与使用难度
稳定性与边界
文档清晰度
首次获得有效结果
作者 / 维护者

haidong

核对源码及随包文件:ClawHub 1.0.0。本次为静态审查,不代表已完成安装运行或业务效果测试。