@optima-chat/scout-cli

Optima Scout CLI

AI-powered Amazon product research and 1688 supplier sourcing tool for Claude Code and LLMs.

Installation

npm install -g @optima-chat/scout-cli

Quick Start

# Initialize Claude Code skills
scout init

# Search Amazon products
scout search "coffee maker"

# Get product details
scout product B01GJOMWVA

# Search 1688 suppliers
scout supplier-search "咖啡机"

# Search TikTok Shop products
scout tiktok "wireless earbuds"

Commands

scout init

Initialize Optima Scout skills for Claude Code.

Options:

• -f, --force - Overwrite existing skills

scout search <query>

Search Amazon products with structured JSON output.

Options:

• -d, --domain <domain> - Amazon domain (default: amazon.com)
• -l, --limit <number> - Result limit (default: 10)
• -f, --format <format> - Output: json | text

Example:

scout search "wireless mouse" --limit 5 --format json

scout product <asin>

Get detailed product information.

Options:

• -d, --domain <domain> - Amazon domain (default: amazon.com)
• -f, --format <format> - Output: json | text

Example:

scout product B004YAVF8I --domain amazon.com

scout supplier-search <keyword>

Search for suppliers on 1688.com.

Options:

• -l, --limit <number> - Result limit (default: 20, max: 100)
• -f, --format <format> - Output: json | text

Example:

scout supplier-search "咖啡机" --limit 10
scout supplier-search "蓝牙耳机" --format json

scout tiktok <keyword>

Search TikTok Shop products with actual sales data.

Options:

• -l, --limit <number> - Result limit (default: 20, max: 50)
• -f, --format <format> - Output: json | text

Features:

• ✅ Real sales numbers (not estimates)
• ✅ Actual prices and GMV
• ✅ Product ratings and reviews
• ✅ Shop information
• ✅ Direct product links

Example:

# Text format for quick review
scout tiktok "coffee maker" --limit 10 --format text

# JSON format for LLM processing
scout tiktok "wireless earbuds" --limit 20 --format json

Data Source: ScrapeCreators API - $0.002/request

Configuration

Set API endpoint via environment variable:

export API_URL=http://dev.optima.sh:7290

Or create .env file:

API_URL=http://localhost:7290

Features

• JSON-first: Structured output optimized for LLM parsing
• Non-interactive: No spinners, prompts, or colors
• Fast: Backend caching for quick responses
• Claude Code integration: Auto-discovery via skills

Development

# Install dependencies
npm install

# Build
npm run build

# Link locally
npm link

License

MIT