Approach and advantage
A Python handler structures keyword, attribute, and conversion-trap suggestions into Markdown.
Generate a heuristic listing-review brief from product notes and marketplace context.
Generate a heuristic listing-review brief from product notes and marketplace context. A Python handler structures keyword, attribute, and conversion-trap suggestions into Markdown.
A Python handler structures keyword, attribute, and conversion-trap suggestions into Markdown.
Draft a listing audit from supplied Amazon notes; Build a keyword and attribute review checklist; Separate observed conversion issues from default suggestions.
Platform, product details, current listing, optimization goal, and observed issues.
Use a Skill-capable agent with file access. Python 3 is required for the bundled Python helpers; inspect their sample schemas before supplying data.
No live rankings or seller APIs are used. The handler adds default traps, defaults unknown platforms to Amazon, and falls back to generic attribute weights; these are not measured defects or official ranking weights.
Install into the active Agent workspace with a current OpenClaw CLI. Check the installed path with openclaw skills info, then start a new session.
openclaw skills install @harrylabsj/search-listing-optimizer --version 1.0.0This is the unchanged source SKILL.md for the reviewed version. Install the complete package to retain referenced scripts, assets, and instructions. Starter prompts below are EcomAgentTools examples.
Source and package files reviewed on October 25, 2026: ClawHub 1.0.0. This is a static review, not an installation or business-outcome test.
---
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.
Starter prompts for the main use cases—copy and use them directly.
Draft a listing audit from supplied Amazon notes Use for: Draft a listing audit from supplied Amazon notes. Prepare: Platform, product details, current listing, optimization goal, and observed issues.
Use the installed search-listing-optimizer Skill. Task: Draft a listing audit from supplied Amazon notes. Inputs: [INPUT]. Constraints: [CONSTRAINTS]. Check missing information first. Produce a reviewable result with evidence, assumptions, and next steps. No live rankings or seller APIs are used. The handler adds default traps, defaults unknown platforms to Amazon, and falls back to generic attribute weights; these are not measured defects or official ranking weights.[INPUT][CONSTRAINTS]Build a keyword and attribute review checklist Use for: Build a keyword and attribute review checklist. Prepare: Platform, product details, current listing, optimization goal, and observed issues.
Use the installed search-listing-optimizer Skill. Task: Build a keyword and attribute review checklist. Inputs: [INPUT]. Constraints: [CONSTRAINTS]. Check missing information first. Produce a reviewable result with evidence, assumptions, and next steps. No live rankings or seller APIs are used. The handler adds default traps, defaults unknown platforms to Amazon, and falls back to generic attribute weights; these are not measured defects or official ranking weights.[INPUT][CONSTRAINTS]Separate observed conversion issues from default suggestions Use for: Separate observed conversion issues from default suggestions. Prepare: Platform, product details, current listing, optimization goal, and observed issues.
Use the installed search-listing-optimizer Skill. Task: Separate observed conversion issues from default suggestions. Inputs: [INPUT]. Constraints: [CONSTRAINTS]. Check missing information first. Produce a reviewable result with evidence, assumptions, and next steps. No live rankings or seller APIs are used. The handler adds default traps, defaults unknown platforms to Amazon, and falls back to generic attribute weights; these are not measured defects or official ranking weights.[INPUT][CONSTRAINTS]No live rankings or seller APIs are used. The handler adds default traps, defaults unknown platforms to Amazon, and falls back to generic attribute weights; these are not measured defects or official ranking weights.
Source and package files reviewed on October 25, 2026: ClawHub 1.0.0. This is a static review, not an installation or business-outcome test.
Use authorized inputs and keep secrets out of prompts. Review customer-facing claims, calculations, code changes, and any proposed external action before applying them.
Generate a heuristic listing-review brief from product notes and marketplace context. A Python handler structures keyword, attribute, and conversion-trap suggestions into Markdown.
Choose the method for your agent and install the complete package, not just the displayed SKILL.md. Platform, product details, current listing, optimization goal, and observed issues. Start a new agent session and explicitly ask to use search-listing-optimizer. Try one use case below with a small sample and review the output.
Draft a listing audit from supplied Amazon notes; Build a keyword and attribute review checklist; Separate observed conversion issues from default suggestions
No live rankings or seller APIs are used. The handler adds default traps, defaults unknown platforms to Amazon, and falls back to generic attribute weights; these are not measured defects or official ranking weights.
Source and package files reviewed on October 25, 2026: ClawHub 1.0.0. This is a static review, not an installation or business-outcome test.
Source and package files reviewed on October 25, 2026: ClawHub 1.0.0. This is a static review, not an installation or business-outcome test.
Source and package files reviewed on October 25, 2026: ClawHub 1.0.0. This is a static review, not an installation or business-outcome test.
Content checked:
No reviews yet.