方法与优势
Python 程序把检查结果整理成统一的 Markdown 结构,方便多人协作审核。团队可以带着现有 Listing 和明确目标,一起审核关键词、属性和转化优化建议,不必再汇总多人各自提出的零散意见。
把“这个商品页面怎么优化”变成一份有条理的 Listing 修改清单。提供销售平台、商品资料、现有文案和已观察到的问题后,这项 Skill 的 Python 程序会整理关键词建议、商品属性检查和可能影响购买理解的内容,方便运营安排下一轮标题、卖点与详情页修改。
这项 Skill 根据你提供的商品和页面资料生成优化简报,不会读取平台实时排名。输出会集中呈现搜索表达、商品属性以及可能让买家犹豫或误解的内容,便于运营把零散的修改想法变成具体任务。
使用时需要逐条对照真实页面确认建议。程序包含默认问题和经验权重,某一项被列出来,不代表页面一定存在该问题,也不代表平台官方认为它有某个权重。适合辅助初步检查,最终改动应结合商品事实、平台要求和已有经营数据。
Python 程序把检查结果整理成统一的 Markdown 结构,方便多人协作审核。团队可以带着现有 Listing 和明确目标,一起审核关键词、属性和转化优化建议,不必再汇总多人各自提出的零散意见。
输入时明确平台,并把已确认的问题和待核对建议分开处理。程序遇到未知平台会默认按 Amazon 处理,也可能采用通用权重;因此更适合用来列检查事项,不能把输出当作排名因素证明或销量提升预测。
平台、商品细节、现有商品资料、优化目标和已观察到的问题。
使用支持 Skill 且能访问文件的 Agent。随包 Python 辅助工具需要 Python 3;提供数据前先查看样例结构。
不读取实时排名或卖家 API。代码会补入默认问题、把未识别平台设为 Amazon,并回退到通用属性权重;这些不等于实测缺陷或官方排名权重。
将指令发给实际使用该 Skill 的 OpenClaw 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 及安装参考文件,列出所需工具、依赖和凭据,返回实际版本、安装路径和准备状态;需要时新建会话。不把安装完成说成已通过业务任务测试。以下为已核对版本未经改写的 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.
以下是主要功能的用例提示词,可以直接复制使用。
根据 Amazon 商品说明起草审核 适用于:根据 Amazon 商品说明起草审核。请准备:平台、商品细节、现有商品资料、优化目标和已观察到的问题。
请使用已安装的 search-listing-optimizer Skill。任务:根据 Amazon 商品说明起草审核。输入:[INPUT]。限制:[CONSTRAINTS]。先检查缺失信息,再输出可审查的结果、依据、假设和下一步。不读取实时排名或卖家 API。代码会补入默认问题、把未识别平台设为 Amazon,并回退到通用属性权重;这些不等于实测缺陷或官方排名权重。[INPUT][CONSTRAINTS]制作关键词与属性核对清单 适用于:制作关键词与属性核对清单。请准备:平台、商品细节、现有商品资料、优化目标和已观察到的问题。
请使用已安装的 search-listing-optimizer Skill。任务:制作关键词与属性核对清单。输入:[INPUT]。限制:[CONSTRAINTS]。先检查缺失信息,再输出可审查的结果、依据、假设和下一步。不读取实时排名或卖家 API。代码会补入默认问题、把未识别平台设为 Amazon,并回退到通用属性权重;这些不等于实测缺陷或官方排名权重。[INPUT][CONSTRAINTS]区分已观察到的转化问题与默认建议 适用于:区分已观察到的转化问题与默认建议。请准备:平台、商品细节、现有商品资料、优化目标和已观察到的问题。
请使用已安装的 search-listing-optimizer Skill。任务:区分已观察到的转化问题与默认建议。输入:[INPUT]。限制:[CONSTRAINTS]。先检查缺失信息,再输出可审查的结果、依据、假设和下一步。不读取实时排名或卖家 API。代码会补入默认问题、把未识别平台设为 Amazon,并回退到通用属性权重;这些不等于实测缺陷或官方排名权重。[INPUT][CONSTRAINTS]输入售价 $24 的杯具主档与现有页面文本,页面缺容量、材质、护理和清晰运费。目标是让站内搜索字段与购买说明使用同一套事实。
案例输入资料: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 产生的主要文件,保留实际输出语言。
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.
HarborMug 500 mL Insulated Stainless Steel Mug — Blue
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.
| Element | Existing content or gap | Change 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 bullet | Only “Insulated stainless steel mug” | Adds the exact 500 mL capacity without inventing serving counts. |
| Size and weight bullet | Absent | Adds the supplied dimensions and weight for fit comparisons. Dimension axes are unspecified, so no diameter or height labels are invented. |
| Care bullet | Absent | Makes hand-washing and microwave restrictions visible before purchase. |
| Price bullet | Description 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 bullet | Absent | States US-only shipping and separates dispatch from delivery; avoids presenting 3–5 days as an order-to-door guarantee. |
| Returns bullet | No visible policy | Adds 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 sections | Missing | Gives shoppers scannable answers and reinforces the same terms as the bullets. |
| FAQ | Absent | Answers capacity, care, insulation-duration and two-mug shipping questions directly. No retention time, leakproof claim or health/environmental guarantee is added. |
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 queries | Intent | Volume / competition | Priority and placement |
|---|---|---|---|
| insulated stainless steel mug; stainless steel mug | Find product by material and insulation | Unknown / unknown | High: title and opening description |
| 500 mL mug; 500ml mug | Find a specific capacity | Unknown / unknown | High: canonical “500 mL” in title, bullet and description; test “500ml” in storefront search before adding variants |
| blue mug; HarborMug | Color or brand lookup | Unknown / unknown | High: title; blue as a color attribute |
| mug dimensions; mug weight | Compare physical fit | Unknown / unknown | Medium: specifications and second bullet |
| hand-wash mug; microwave safe mug | Check care compatibility | Unknown / unknown | High for decision clarity: care and FAQ; answer microwave queries truthfully with “not microwave safe” |
| mug shipping cost; mug returns | Resolve purchase objections | Unknown / unknown | High 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 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.
Qualitative assessment of the supplied listing, not an algorithm score. “Draft complete” means the copy is supplied here, not that a store was changed.
| Field | Current assessment | Finished draft / operational action |
|---|---|---|
| Title | Partial: brand and color only | Draft complete: material, capacity and insulation added |
| Bullets | Partial: one general feature | Draft complete: specifications, care, price, shipping and returns |
| Description | Incomplete: generic wording and item price | Draft complete: product details, policy sections and FAQ |
| Product attributes | Facts supplied but not shown in listing | Set 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 |
| Category | Not supplied | Select the applicable mug category from the store’s current taxonomy; no category ID is invented |
| Tags / backend keywords | Empty keyword list | Suggested tags: insulated mug; stainless steel mug; 500 mL mug; blue mug. No separate backend-keyword field assumed |
| Images and alt text | One clear photo reported; no alt text | Suggested primary alt: “HarborMug blue stainless steel mug.” Confirm it describes the actual photo before use |
| Capacity/care image | Missing infographic | Add a factual 500 mL / dimensions / care graphic; keep the same information in text for accessibility |
| Lifestyle image | Absent | Lower priority: use a real product image in context, with no implication of unsupported lid, fit or leak resistance |
| Pricing and shipping | Only $24 visible | Draft complete; mirror threshold and charge in shipping settings and cart |
| Returns and FAQ | Missing | Draft complete, subject to policy detail below |
| Reviews | Supplied summary only | No 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.
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.
| Quantity | Merchandise subtotal | Customer shipping | Total before tax | Free shipping? |
|---|---|---|---|---|
| 1 | $24 | $5 | $29 | No |
| 2 | $48 | $5 | $53 | No |
| 3 | $72 | $0 | $72 | Yes |
Supporting arithmetic is in price-calculations.csv. No weekly sales comparison is used as evidence of copy effectiveness: these figures precede this unimplemented draft.
| Priority | Action | Expected practical effect, not a measured lift |
|---|---|---|
| 1 | Place capacity, care and the one-mug price before tax near purchase controls; apply the revised title and bullets | Helps shoppers judge size, upkeep and cost before ordering |
| 1 | Confirm return-window start, return-shipping terms and dispatch/delivery interpretation; align full policies with product text | Reduces avoidable policy and timing misunderstandings |
| 1 | Verify cart shipping at $24, $48, below $50, exactly $50 and above $50; confirm US-only eligibility and tax display | Keeps the advertised amount consistent with checkout |
| 2 | Apply description, product attributes and relevant tags; confirm category | Gives shoppers and storefront search clearer product information |
| 2 | Add accurate alt text and a factual specifications/care image | Makes supplied facts easier to find and improves image accessibility |
| 3 | Test storefront queries “HarborMug,” “blue mug,” “500 mL mug,” “500ml mug” and “stainless steel mug,” including mobile predictive search | Checks actual discovery behavior without assuming indexing or rank |
| 3 | After implementation, compare product add-to-cart and purchase rates over comparable traffic; track care, capacity and shipping questions | Provides 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.
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.案例中的商家经营资料为模拟数据;涉及网站检查时,报告中的页面观察来自所列公开网址。
不读取实时排名或卖家 API。代码会补入默认问题、把未识别平台设为 Amazon,并回退到通用属性权重;这些不等于实测缺陷或官方排名权重。
核对源码及随包文件:ClawHub 1.0.0。本次为静态审查,不代表已完成安装运行或业务效果测试。
使用获授权输入,不把密钥贴入提示词。采用前检查面向客户的声明、计算、代码改动及任何拟议的外部操作。
根据商品说明和平台背景生成规则式商品审核简报。Python handler 将关键词、属性和转化障碍建议整理为 Markdown。
按实际 Agent 选择方式,安装完整包,不要只复制页面中的 SKILL.md。 平台、商品细节、现有商品资料、优化目标和已观察到的问题。 开启新 Agent 会话,明确要求使用 search-listing-optimizer。先用小型样本尝试下方一个场景,并检查输出。
根据 Amazon 商品说明起草审核;制作关键词与属性核对清单;区分已观察到的转化问题与默认建议
不读取实时排名或卖家 API。代码会补入默认问题、把未识别平台设为 Amazon,并回退到通用属性权重;这些不等于实测缺陷或官方排名权重。
核对源码及随包文件:ClawHub 1.0.0。本次为静态审查,不代表已完成安装运行或业务效果测试。
核对源码及随包文件:ClawHub 1.0.0。本次为静态审查,不代表已完成安装运行或业务效果测试。
暂无评论。