← 返回 Skills 市场
377
总下载
0
收藏
2
当前安装
2
版本数
在 OpenClaw 中安装
/install skill-amazon-ads-reporter
功能描述
Fetch Amazon Ads Sponsored Products campaign reports asynchronously by requesting and polling separately to avoid API timeouts, with no npm dependencies.
安全使用建议
This package mostly does what it says (fetch reports, list bids) but it is inconsistent and incomplete. Before using it: 1) Do not run with real credentials until you verify the missing scripts — SKILL.md references request-report.js, poll-report.js, and get-report.js but only keyword-report.js and get-bids.js are included. 2) Inspect or obtain the missing scripts from a trusted source or ask the author for a complete release. 3) Store credentials carefully: amazon-ads-api.json contains a refresh token and client secret in plaintext — keep it readable only by you and consider using a short-lived profile or limited-scope account. 4) Confirm CAMPAIGN_IDS is set when running get-bids.js and that your Node runtime provides global fetch (or run on a Node version that supports it) or adjust the script. 5) Note that both scripts call Amazon endpoints and do not contact any other external servers — if you see network calls to non-Amazon domains, do not proceed. 6) Because the package metadata didn't declare required env vars, treat the skill as incomplete and verify behavior in a safe/test environment; rotate secrets if you accidentally exposed them during testing.
功能分析
Type: OpenClaw Skill
Name: skill-amazon-ads-reporter
Version: 1.1.0
The skill bundle provides legitimate tools for interacting with the Amazon Ads Reporting API v3. The scripts (get-bids.js and keyword-report.js) correctly implement OAuth2 token refreshing and async report polling as per Amazon's documentation. While they access sensitive credentials from a local JSON file (~/amazon-ads-api.json), the data is only transmitted to official Amazon endpoints (api.amazon.com and advertising-api-eu.amazon.com). No malicious execution, data exfiltration to third parties, or prompt injection attempts were found.
能力评估
Purpose & Capability
Name/description align with the two included scripts (keyword-report.js and get-bids.js). However SKILL.md documents additional scripts (request-report.js, poll-report.js, get-report.js) and output files (~/.openclaw/workspace/tmp/amazon-report-*.json) that are not present in the package; region selection described in the README is not honored (both scripts hardcode the EU advertising API endpoint). These mismatches mean the skill package is incomplete or inconsistently documented.
Instruction Scope
Instructions tell the agent to run scripts that are missing and to write/read specific workspace files that the provided scripts do not create. Both scripts read credentials from a local JSON file (AMAZON_ADS_PATH or default in home). That credential access is expected for this purpose, but the SKILL.md and code disagree on how reports are requested/polled and where artifacts are stored — the agent would likely error or behave differently than documented.
Install Mechanism
No install spec (instruction-only plus two code files). No downloads or external installers are present, which lowers installation risk. The scripts use only Node built-ins and make HTTPS calls.
Credentials
The code reads sensitive local credentials from amazon-ads-api.json (refresh token, client id/secret, profileId) and get-bids.js expects CAMPAIGN_IDS in env. The registry metadata declares no required env vars or primary credential, which is inconsistent with the scripts and SKILL.md. Requesting a refresh token and client secret is appropriate for the advertised purpose, but the missing metadata and plaintext local credential requirement should be noted and validated.
Persistence & Privilege
always:false and user-invocable:true (defaults). The skill does not request persistent system-wide privileges or modify other skills' configs. It runs as ad-hoc Node scripts and does not install background services.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install skill-amazon-ads-reporter - 安装完成后,直接呼叫该 Skill 的名称或使用
/skill-amazon-ads-reporter触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.1.0
**Expanded functionality: adds keyword analytics and live bid inspection tools.**
- Introduced `keyword-report.js` for keyword-level winner/dead analysis across campaigns.
- Added `get-bids.js` script for instant, live export of all keywords and bids (enabled and paused).
- Updated configuration to support required Amazon Ads refresh/key fields.
- Removed old reporting scripts and references; documentation now covers new keyword features.
- Clarified output formats for both campaign and keyword-level reports.
v1.0.0
Initial release with async Amazon Ads report retrieval:
- Supports decoupled two-step process: request then poll for report
- Handles Sponsored Products campaign performance via the v3 Reporting API
- Prevents API timeouts by splitting report request and download for cron usage
- Outputs summarized CSV with key campaign metrics
- Requires no external npm dependencies (only Node.js built-ins)
- Reads credentials from a JSON config file specified by an environment variable
元数据
常见问题
Amazon Ads Reporter 是什么?
Fetch Amazon Ads Sponsored Products campaign reports asynchronously by requesting and polling separately to avoid API timeouts, with no npm dependencies. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 377 次。
如何安装 Amazon Ads Reporter?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install skill-amazon-ads-reporter」即可一键安装,无需额外配置。
Amazon Ads Reporter 是免费的吗?
是的,Amazon Ads Reporter 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Amazon Ads Reporter 支持哪些平台?
Amazon Ads Reporter 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Amazon Ads Reporter?
由 Zero2Ai(@zero2ai-hub)开发并维护,当前版本 v1.1.0。
推荐 Skills