ai-amazon-search-optimization

ai-amazon-search-optimization Amazon Search Optimization Assistant

Overview

Amazon Search Optimization Assistant is used to answer “Can buyers find it?”, organize materials, clean data, and identify action items. It is suitable for operations, product, sales, and software to call after clarifying business goals, content materials, or analysis targets. It will combine pages, keywords or content materials, pasted page content, keywords, site structure, search goals, competitor summaries, or optimization questions. and other inputs, organize key context, and output product/store diagnostics, selling points and risk alerts, and operational action recommendations, making it easy to continue execution, review, or delivery. Capability positioning supplement: skills.sh hot signals show that amazon-search-optimization has user demand; the platform displays it as an ecommerce_retail business assistant directory, outputting reviewable diagnostics, recommendations, or production readiness packages.

When to Use

Applicable Scenarios

Users raise questions such as “Can buyers find it?” and need to quickly break down goals, determine priorities, and form executable results
Operations, product, sales, and software need to generate product/store diagnostics, selling points and risk alerts, and operational action recommendations around Amazon Search Optimization Assistant
Users have already prepared optimization goals (explain the keywords, search intent, visibility, citation opportunities, or conversion goals to improve.), target audience (explain search users, target market, industry, purchase stage, or content audience.), page or site links (fill in publicly accessible pages, sites, SERPs, competitors, or reference links.), and hope to organize them into executable analysis or optimization results
Users need to turn Amazon Search Optimization Assistant-related materials into clear conclusions, priorities, and next actions

How to Call

Call the AI Skills API directly through the exported Python runner:

Command Example

Basic Call

python3 scripts/run.py --params '{}'

Call with Common Parameters

python3 scripts/run.py --params '{"goal":"优化目标"}'

Parameter Description

Parameter	Type	Required	Default	Description
`goal`	string	No	-	Explain the keywords, search intent, visibility, citation opportunities, or conversion goals to improve
`audience`	string	No	-	Explain search users, target market, industry, purchase stage, or content audience
`materialUrl`	string	No	-	Fill in publicly accessible pages, sites, SERPs, competitors, or reference links; a complete accessible URL must be provided
`materialFile`	string	No	-	Upload content drafts, keyword lists, site structure, audit reports, or SEO planning materials
`materialText`	string	No	-	Paste page content, keywords, site structure, search goals, competitor summaries, or optimization questions
`brandRequirements`	string	No	-	Supplement target regions, language, brand restrictions, unchangeable facts, compliance requirements, or manual review priorities

See the complete machine-readable parameter structure at references/form-schema.json。

Parameter Value Reference

The current skill has no categorical parameters that require additional table lookup.

Supported Input Formats

The current skill directly accepts JSON parameters; if the parameters contain a link field, please pass a complete, accessible URL.

Example request

The example parameters below can be passed directly to scripts/run.py, and the runner will send them to the AI Skills API.

python3 scripts/run.py --params '{"goal":"优化目标"}'

Equivalent --params JSON：

{
  "goal": "优化目标"
}

Example return result

{
  "success": true,
  "data": {
    "message": "示例结果请以技能真实返回结构为准。"
  },
  "meta": {
    "executionTime": 842,
    "cached": false
  }
}

Deliverables

Product/store diagnosis, selling points and risk alerts, operational action recommendations: organize the core results around the user's goals that can be directly read, reviewed, or delivered.
Interpretation of input materials: combine the optimization goal (explain the keywords, search intent, visibility, citation opportunities, or conversion goals to be improved.), target audience (explain the search users, target market, industry, purchase stage, or content audience.), page or site links (fill in publicly accessible pages, sites, SERPs, competitor or reference links.) to extract key context and the basis for judgment.
Next steps: provide priorities, execution recommendations, or a content framework that can be further processed.

Suggestions for using the results

First determine whether the output answers the user's core question about the "Amazon Search Optimization Assistant".
Then check whether the results cover product/store diagnosis, selling points and risk alerts, operational action recommendations, and whether clear next steps are given.
If there is little input material, it is recommended to have the user supplement the goals, audience, constraints, or original materials before running.

Preparation before running

AISKILLS_BASE_URL: default https://ai-skills.ai
AISKILLS_API_KEY: required, used for authenticated calls
AISKILLS_TENANT_ID: default default