← Back to Skills Marketplace
simoncai519

Amz Hot Keywords

by simoncai519 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
138
Downloads
0
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install amz-hot-keywords
Description
Scrape Amazon Brand Analytics (ABA) weekly hot keyword rankings from AMZ123 and return structured keyword trend data. Use when the user asks about Amazon key...
README (SKILL.md)

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

  1. User provides a base keyword.
  2. scripts/amz_scraper.py launches a headless Selenium Chrome session, navigates to AMZ123, searches the keyword, and scrapes up to 200 related terms.
  3. The script calculates the trend by comparing the current rank with the previous week’s rank.
  4. Results are saved to amz123_hotwords_\x3Ckeyword>_\x3Ctimestamp>.csv (or .json).
  5. 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.md for a step‑by‑step guide and troubleshooting tips.
  • See references/output.md for 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

Usage Guidance
This skill appears to do exactly what it claims: automated scraping of AMZ123 and writing a CSV/JSON file locally. Before installing or running it, ensure you: (1) have Python 3.9+, Google Chrome, and the listed Python packages installed (pip install selenium pandas python-dotenv if needed); (2) understand scraping third-party sites may violate terms of service or trigger CAPTCHAs/bot defenses; (3) run it on a trusted machine because it launches a browser and writes files locally; and (4) inspect/keep the SELECTORS up to date if AMZ123 changes layout. If you expect to store credentials or cookies in the future (workflow mentions this as optional), treat those values as sensitive and only provide them after reviewing how they will be stored/used.
Capability Analysis
Type: OpenClaw Skill Name: amz-hot-keywords Version: 1.0.0 The amz-hot-keywords skill is a legitimate web scraper designed to extract Amazon keyword ranking data from the public AMZ123 website. The core logic in scripts/amz_scraper.py uses Selenium and Pandas to automate data collection and formatting into CSV/JSON files as described in the documentation. There is no evidence of data exfiltration, malicious command execution, or prompt injection; the script's behavior is transparent and strictly aligned with its stated purpose.
Capability Assessment
ℹ Purpose & Capability
The skill's name, description, SKILL.md, and included scraper implementation are consistent: it uses Selenium to scrape AMZ123 and write CSV/JSON output. Minor mismatch: the registry metadata lists no required binaries whereas the workflow and script require Python 3.9+, Google Chrome, and Python packages (selenium, pandas). This looks like an omission in metadata rather than malicious intent.
✓ Instruction Scope
SKILL.md and references/workflow.md restrict actions to launching a headless Chrome via Selenium, navigating to https://www.amz123.com/usatopkeywords, reading table rows, computing trends, and writing a local CSV/JSON file. The instructions do not ask the agent to read unrelated files, access unrelated environment variables, or send scraped data to any external endpoint other than AMZ123.
ℹ Install Mechanism
There is no install spec (instruction-only), which is low risk. However the workflow documents pip-based dependencies and a requirement for Chrome; the package does not provide an automated install step. Users must manually ensure Python, Chrome, and required Python packages are installed.
✓ Credentials
The skill declares no required environment variables or credentials and the code does not read secrets. The workflow notes that credentials/cookies could be added if ABA becomes gated, but that is optional and not present in current code.
✓ Persistence & Privilege
The skill does not request permanent/always-on presence, does not modify other skill or system configs, and only writes its own output files. It runs only when invoked.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install amz-hot-keywords
  3. After installation, invoke the skill by name or use /amz-hot-keywords
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Added a version field (1.0.0) to the skill metadata. - Included author attribution and links to Simon Cai’s GitHub and related e-commerce skills at the end of the document. - No changes to core functionality or usage.
v0.1.1
- Added a notice at the top of SKILL.md referencing the source GitHub repository and linking to more e-commerce skills. - No changes to functionality or usage; documentation only.
v0.1.0
initial release
Metadata
Slug amz-hot-keywords
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 3
Frequently Asked Questions

What is Amz Hot Keywords?

Scrape Amazon Brand Analytics (ABA) weekly hot keyword rankings from AMZ123 and return structured keyword trend data. Use when the user asks about Amazon key... It is an AI Agent Skill for Claude Code / OpenClaw, with 138 downloads so far.

How do I install Amz Hot Keywords?

Run "/install amz-hot-keywords" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Amz Hot Keywords free?

Yes, Amz Hot Keywords is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Amz Hot Keywords support?

Amz Hot Keywords is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Amz Hot Keywords?

It is built and maintained by simoncai519 (@simoncai519); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 Comments