Voc Publish NPIIr8

VOC AI — Amazon Review Intelligence. Input an ASIN, fetch real Amazon reviews via Shulex VOC API and run AI analysis. Outputs a structured bilingual report:...

Security Scan

The skill's scripts and SKILL.md match its stated purpose (fetch reviews from the Shulex VOC API and analyze them), but the package metadata omits the required VOC_API_KEY environment variable and therefore contains an inconsistency that you should verify before installing.

Purpose & Capability

Name/description (Amazon review VOC analysis) align with the included scripts: fetch.sh calls the Shulex VOC OpenAPI and analyze.sh runs an OpenClaw model on the fetched reviews. Nothing in the code requests unrelated cloud credentials or services beyond the VOC API and local OpenClaw model.

Instruction Scope

SKILL.md and the scripts limit their actions to: (1) calling the Shulex API (openapi.shulex.com), (2) invoking the local OpenClaw CLI/agent for analysis, (3) creating/removing temporary files, and (4) rendering a report. They do not attempt to read other system config files or transmit data to unexpected endpoints.

Install Mechanism

No install spec is provided (instruction-only + included scripts). That minimizes installation risk — the skill will not download or extract external archives during install. Scripts run from the skill directory and use standard tools (curl, python3, openclaw).

Credentials

SKILL.md and the scripts clearly require VOC_API_KEY, but the registry metadata lists no required environment variables / primary credential. This metadata omission is an inconsistency that should be resolved before trusting the package. The only secret the code needs is VOC_API_KEY (proportionate), but confirm no other undeclared credentials are required.

Persistence & Privilege

The skill does not set always:true and does not modify other skills or system-wide settings. It uses temporary files and does not persist credentials to disk in the code paths shown.

What to consider before installing

This package is mostly coherent with its stated purpose but the registry metadata does not declare the VOC_API_KEY that the scripts actually require. Before installing: (1) verify the VOC_API_KEY requirement and set the key only if you trust apps.voc.ai / openapi.shulex.com, (2) run the scripts in an isolated environment (or inspect them locally) since they call an external API and your OpenClaw CLI, (3) confirm the package owner/source (GitHub link vs unknown registry owner) to reduce supply-chain risk, and (4) avoid putting any high-privilege or long-lived credentials in VOC_API_KEY — use an account with limited credits/permissions if possible. If you want to proceed, update the skill metadata to declare VOC_API_KEY (so the platform can surface the requirement) or refuse install until metadata matches actual runtime requirements.

VOC AI — Amazon Review Intelligence

Input an ASIN, fetch real Amazon reviews via Shulex VOC API, and get a structured bilingual insight report powered by AI.

Quick Setup (30 seconds)

1. Get your free API key at apps.voc.ai/openapi
2. Create a key at API Keys page
3. Set it:

export VOC_API_KEY="your-api-key"

New accounts include starter credits — enough for multiple analyses.

Usage

# Quick analysis — 8 reviews (5 credits)
bash ~/.agents/skills/voc-amazon-reviews/voc.sh B08N5WRWNW

# Deep analysis — 100 reviews (50 credits)
bash ~/.agents/skills/voc-amazon-reviews/voc.sh B08N5WRWNW --limit 100

# Japan marketplace
bash ~/.agents/skills/voc-amazon-reviews/voc.sh B08N5WRWNW --market JP

# Save report to file
bash ~/.agents/skills/voc-amazon-reviews/voc.sh B08N5WRWNW --limit 100 --output report.md

Supported Marketplaces

Code	Marketplace
US	amazon.com
CA	amazon.ca
MX	amazon.com.mx
GB	amazon.co.uk
DE	amazon.de
FR	amazon.fr
IT	amazon.it
ES	amazon.es
JP	amazon.co.jp
AU	amazon.com.au

Sample Output

╔══════════════════════════════════════════════════════════╗
║     VOC AI Analysis Report                               ║
║  ASIN: B08N5WRWNW  |  Reviews Analyzed: 100              ║
║  Market: US  |  Generated: 2026-04-18                     ║
╚══════════════════════════════════════════════════════════╝

📊 Sentiment Distribution
  Positive  ████████████████░░░░  74%
  Neutral   ███░░░░░░░░░░░░░░░░░  16%
  Negative  ██░░░░░░░░░░░░░░░░░░  10%

🔴 Top 5 Pain Points
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. Short battery life (28 mentions)
   "Battery drained in 2 days, very disappointed"

🟢 Top 5 Selling Points
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. Excellent sound quality (52 mentions)
   "Amazing bass and crystal clear highs for the price"

💡 Listing Optimization Suggestions
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. Add battery capacity and playtime hours to title

How It Works

① Input ASIN
      ↓
② Shulex VOC API fetches real-time Amazon reviews
      ↓
③ Structured review data (rating, body, date, verified, variant)
      ↓
④ AI deep semantic analysis (sentiment, pain points, selling points)
      ↓
⑤ Bilingual report (Chinese + English)

Cost Guide

Reviews	API Credits	Use Case
8 (default)	5 credits	Quick competitor check
50	25 credits	Product validation
100	50 credits	Deep analysis
200	100 credits	Comprehensive audit

Scripts

File	Description
voc.sh	Main entry point — orchestrates fetch + analyze
fetch.sh	Shulex VOC API client (submit task → poll → get reviews)
analyze.sh	AI analysis engine (sentiment, pain points, selling points)
scraper.sh	Legacy browser-based scraper (deprecated)

Environment Variables

Variable	Required	Description
VOC_API_KEY	Yes	Shulex VOC API key (get one free)

Resources

• Shulex VOC API Docs
• API Keys
• Buy Credits