Amazon Hot Keywords Skill
Overview
This skill extracts weekly search‑term rankings from Amazon Brand Analytics via the public AMZ123 site. It returns a CSV (or JSON) containing the keyword, current week rank, last week rank, and trend (up/down/flat/new).
Core Workflow
- User provides a base keyword.
scripts/amz_scraper.pylaunches a headless Selenium Chrome session, navigates to AMZ123, searches the keyword, and scrapes up to 200 related terms.- The script calculates the trend by comparing the current rank with the previous week’s rank.
- Results are saved to
amz123_hotwords_<keyword>_<timestamp>.csv(or.json). - The file path is returned to the caller.
Usage
# Basic usage – CSV output
python3 $(pwd)/scripts/amz_scraper.py --keyword "dog bed"
# Limit results to 100 entries and specify output folder
python3 $(pwd)/scripts/amz_scraper.py \
--keyword "yoga mat" \
--max-results 100 \
--output-dir ./data
Parameters
| Flag | Required | Description | Default |
|---|---|---|---|
--keyword |
Yes | Search term to seed the scrape | - |
--max-results |
No | Max number of keywords to collect (max 200) | 200 |
--output-dir |
No | Directory for the CSV/JSON file | current directory |
--format |
No | csv or json (default csv) |
|
--headless |
No | Run Chrome headlessly (true/false) |
true |
References
- See
references/workflow.mdfor a step‑by‑step guide and troubleshooting tips. - See
references/output.mdfor the exact CSV column order and JSON schema.
Scripts
The scraper implementation lives in scripts/amz_scraper.py.
Created by Simon Cai · More e-commerce skills: github.com/simoncai519/open-accio-skill