← 返回 Skills 市场
simoncai519

Amz Hot Keywords

作者 simoncai519 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
138
总下载
0
收藏
1
当前安装
3
版本数
在 OpenClaw 中安装
/install 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...
使用说明 (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

安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install amz-hot-keywords
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /amz-hot-keywords 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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
元数据
Slug amz-hot-keywords
版本 1.0.0
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 3
常见问题

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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 138 次。

如何安装 Amz Hot Keywords?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install amz-hot-keywords」即可一键安装,无需额外配置。

Amz Hot Keywords 是免费的吗?

是的,Amz Hot Keywords 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Amz Hot Keywords 支持哪些平台?

Amz Hot Keywords 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Amz Hot Keywords?

由 simoncai519(@simoncai519)开发并维护,当前版本 v1.0.0。

💬 留言讨论