{
  "schemaVersion": "1.0",
  "item": {
    "slug": "amazon-reviews-api-skill",
    "name": "Amazon Reviews Api Skill",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/phheng/amazon-reviews-api-skill",
    "canonicalUrl": "https://clawhub.ai/phheng/amazon-reviews-api-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/amazon-reviews-api-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=amazon-reviews-api-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/amazon_reviews_api.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/amazon-reviews-api-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/amazon-reviews-api-skill",
    "agentPageUrl": "https://openagent3.xyz/skills/amazon-reviews-api-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/amazon-reviews-api-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/amazon-reviews-api-skill/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "📖 Introduction",
        "body": "This skill provides a one-stop Amazon review collection service through BrowserAct's Amazon Reviews API template. It can directly extract structured review results from Amazon product pages. By simply providing an ASIN, you can get clean, usable review data without building crawler scripts or requiring an Amazon account login."
      },
      {
        "title": "✨ Features",
        "body": "No Hallucination, Ensuring Stable and Accurate Extraction: Preset workflows avoid AI-generated hallucinations.\nNo Anti-Bot Issues: Built-in mechanisms bypass reCAPTCHA and other verification challenges.\nNo IP Restrictions or Geofencing: Breaks through regional IP limits to ensure stable global access.\nAgile Execution: Tasks run faster than pure AI-driven browser automation solutions.\nHigh Cost-Efficiency: Significantly reduces data acquisition costs compared to token-heavy AI schemes."
      },
      {
        "title": "🔑 API Key Setup Flow",
        "body": "Before running, you must check for the BROWSERACT_API_KEY environment variable. If it's not set, do not take other actions; instead, request and wait for the user to provide it.\nAgent must inform the user:\n\n\"Since you haven't configured the BrowserAct API Key, please go to the BrowserAct Console to get your Key and provide it to me here.\""
      },
      {
        "title": "🛠️ Input Parameters",
        "body": "When calling the script, the Agent should flexibly configure parameters based on user needs:\n\nASIN (Amazon Standard Identification Number)\n\nType: string\nDescription: The unique identifier for the product on Amazon.\nExample: B07TS6R1SF, B08N5WRWJ6"
      },
      {
        "title": "🚀 Usage (Recommended)",
        "body": "The Agent should execute the following standalone script to \"get results in one line\":\n\n# Example call\npython -u ./scripts/amazon_reviews_api.py \"ASIN_HERE\""
      },
      {
        "title": "⏳ Runtime Monitoring",
        "body": "Since this task involves automated browser operations, it may take several minutes. The script will continuously output status logs with timestamps (e.g., [14:30:05] Task Status: running).\nAgent Note:\n\nKeep monitoring the terminal output while waiting for results.\nAs long as the terminal is outputting new status logs, the task is running normally; do not misjudge it as stuck or unresponsive.\nOnly consider retrying if the status remains unchanged for a long time or the script stops outputting without returning results."
      },
      {
        "title": "📊 Output Data",
        "body": "After successful execution, the script will parse and print results directly from the API response. Each review item includes:\n\nCommentator: Reviewer's name\nCommenter profile link: Link to the reviewer's profile\nRating: Star rating\nreviewTitle: Headline of the review\nreview Description: Full text of the review\nPublished at: Date the review was published\nCountry: Reviewer's country\nVariant: Product variant info (if available)\nIs Verified: Whether it's a verified purchase"
      },
      {
        "title": "⚠️ Error Handling & Retry",
        "body": "If an error occurs (e.g., network issues or task failure), follow this logic:\n\nCheck Output:\n\nIf output contains \"Invalid authorization\", the API Key is invalid or expired. Do not retry; guide the user to check and provide a correct API Key.\nIf output does not contain \"Invalid authorization\" but the task fails (e.g., starts with Error: or returns empty results), the Agent should automatically try to re-execute the script once.\n\n\n\nRetry Limit:\n\nAutomatic retry is limited to once. If the second attempt fails, stop and report the specific error to the user."
      },
      {
        "title": "🌟 Typical Use Cases",
        "body": "Competitor Analysis: Extract reviews for competitors' products to understand their strengths and weaknesses.\nProduct Feedback: Summarize feedback for your own products to identify areas for improvement.\nMarket Research: Collect data on customer preferences and common complaints in a specific category.\nSentiment Monitoring: Monitor recent reviews to detect shifts in customer sentiment.\nQA Insights: Use customer reviews to identify potential quality issues or bugs."
      }
    ],
    "body": "Amazon Reviews Automation Extraction Skill\n📖 Introduction\n\nThis skill provides a one-stop Amazon review collection service through BrowserAct's Amazon Reviews API template. It can directly extract structured review results from Amazon product pages. By simply providing an ASIN, you can get clean, usable review data without building crawler scripts or requiring an Amazon account login.\n\n✨ Features\nNo Hallucination, Ensuring Stable and Accurate Extraction: Preset workflows avoid AI-generated hallucinations.\nNo Anti-Bot Issues: Built-in mechanisms bypass reCAPTCHA and other verification challenges.\nNo IP Restrictions or Geofencing: Breaks through regional IP limits to ensure stable global access.\nAgile Execution: Tasks run faster than pure AI-driven browser automation solutions.\nHigh Cost-Efficiency: Significantly reduces data acquisition costs compared to token-heavy AI schemes.\n🔑 API Key Setup Flow\n\nBefore running, you must check for the BROWSERACT_API_KEY environment variable. If it's not set, do not take other actions; instead, request and wait for the user to provide it. Agent must inform the user:\n\n\"Since you haven't configured the BrowserAct API Key, please go to the BrowserAct Console to get your Key and provide it to me here.\"\n\n🛠️ Input Parameters\n\nWhen calling the script, the Agent should flexibly configure parameters based on user needs:\n\nASIN (Amazon Standard Identification Number)\nType: string\nDescription: The unique identifier for the product on Amazon.\nExample: B07TS6R1SF, B08N5WRWJ6\n🚀 Usage (Recommended)\n\nThe Agent should execute the following standalone script to \"get results in one line\":\n\n# Example call\npython -u ./scripts/amazon_reviews_api.py \"ASIN_HERE\"\n\n⏳ Runtime Monitoring\n\nSince this task involves automated browser operations, it may take several minutes. The script will continuously output status logs with timestamps (e.g., [14:30:05] Task Status: running). Agent Note:\n\nKeep monitoring the terminal output while waiting for results.\nAs long as the terminal is outputting new status logs, the task is running normally; do not misjudge it as stuck or unresponsive.\nOnly consider retrying if the status remains unchanged for a long time or the script stops outputting without returning results.\n📊 Output Data\n\nAfter successful execution, the script will parse and print results directly from the API response. Each review item includes:\n\nCommentator: Reviewer's name\nCommenter profile link: Link to the reviewer's profile\nRating: Star rating\nreviewTitle: Headline of the review\nreview Description: Full text of the review\nPublished at: Date the review was published\nCountry: Reviewer's country\nVariant: Product variant info (if available)\nIs Verified: Whether it's a verified purchase\n⚠️ Error Handling & Retry\n\nIf an error occurs (e.g., network issues or task failure), follow this logic:\n\nCheck Output:\n\nIf output contains \"Invalid authorization\", the API Key is invalid or expired. Do not retry; guide the user to check and provide a correct API Key.\nIf output does not contain \"Invalid authorization\" but the task fails (e.g., starts with Error: or returns empty results), the Agent should automatically try to re-execute the script once.\n\nRetry Limit:\n\nAutomatic retry is limited to once. If the second attempt fails, stop and report the specific error to the user.\n🌟 Typical Use Cases\nCompetitor Analysis: Extract reviews for competitors' products to understand their strengths and weaknesses.\nProduct Feedback: Summarize feedback for your own products to identify areas for improvement.\nMarket Research: Collect data on customer preferences and common complaints in a specific category.\nSentiment Monitoring: Monitor recent reviews to detect shifts in customer sentiment.\nQA Insights: Use customer reviews to identify potential quality issues or bugs."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/phheng/amazon-reviews-api-skill",
    "publisherUrl": "https://clawhub.ai/phheng/amazon-reviews-api-skill",
    "owner": "phheng",
    "version": "0.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/amazon-reviews-api-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/amazon-reviews-api-skill",
    "agentUrl": "https://openagent3.xyz/skills/amazon-reviews-api-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/amazon-reviews-api-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/amazon-reviews-api-skill/agent.md"
  }
}