SkillHub

skill-amazon-review-request

v1.0.0

通过SP-API向符合条件的已发货订单发送评论请求，支持重试、去重、资格检查及试运行模式。

Sourced from ClawHub, Authored by Zero2Ai

Installation

Please help me install the skill `skill-amazon-review-request` from SkillHub official store. npx skills add Zero2Ai-hub/skill-amazon-review-request

skill-amazon-review-request

Sends Amazon review requests for eligible Shipped orders via SP-API Messaging API. Hardened with retry logic, deduplication, eligibility window enforcement, and dry-run mode.

Prerequisites

  • SP-API credentials in ~/amazon-sp-api.json: json { "refreshToken": "...", "clientId": "...", "clientSecret": "...", "marketplaceId": "A2VIGQ35RCS4UG" }
  • Or set env vars: SP_API_REFRESH_TOKEN, SP_API_CLIENT_ID, SP_API_CLIENT_SECRET, SP_API_MARKETPLACE_ID
  • SP-API app must have Messaging permission granted

Usage

# Dry run — see what would be sent (no requests made)
node scripts/request-reviews.js --dry-run

# Live run
node scripts/request-reviews.js

Behavior

Feature Detail
Eligibility window Orders 5–30 days old only (Amazon's allowed window)
Deduplication Skips orders already logged as sent in the tracking log
Retry logic Up to 3 attempts with 5s delay on 5xx / 429 responses
Rate limiting 1.1s pause between requests
Dry-run --dry-run flag — logs what would be sent, no API calls
Tracking log data/review-requests-log.json — per-order status, sentAt, attempts
Text log data/review-requests.log — timestamped human-readable run log

Tracking Log Schema

data/review-requests-log.json:

[
  {
    "orderId": "123-4567890-1234567",
    "sentAt": "2026-03-01T10:00:00.000Z",
    "status": "sent",       // "sent" | "failed" | "skipped"
    "attempts": 1,
    "reason": "optional error string for failed/skipped"
  }
]

Summary Output

=== DONE | Sent: 12 | Skipped: 4 | Failed: 1 ===

Dry-run:

=== DONE [DRY RUN] | Would send: 15 | Skipped: 4 ===

Run daily via cron:

# 9am UAE time (UTC+4) = 5am UTC
0 5 * * * cd $HOME/.openclaw/workspace && node skills/skill-amazon-review-request/scripts/request-reviews.js >> data/review-requests-cron.log 2>&1

Region Note

Script targets sellingpartnerapi-eu.amazon.com (EU endpoint, covers UAE marketplace). Change to sellingpartnerapi-na.amazon.com or sellingpartnerapi-fe.amazon.com for other regions.