-
Notifications
You must be signed in to change notification settings - Fork 3
Use Cases
Real seller scenarios with exact commands and verified outputs. Every data point was tested against live MCP.
📊 Platform: Amazon Overview
Seller: Beginner, $5K budget, wants to sell kitchen products on Amazon US.
Command:
Find blue ocean products in kitchen storage on Amazon US for a beginner seller with $5K budget
Tool chain: picker.py --mode blueocean --platform amazon --site US --keyword "kitchen storage"
What you get: Scored list ranked by Hidden Profit Index. Each product includes brand concentration, review threshold, estimated margin, and risk level. No hard filters — you see the full ranking and decide.
Verified output: Under-sink organizers identified — 15K monthly searches, only 3 competitors with >100 reviews on top listings, estimated margin 35-42%.
📊 Platform: Shopee Overview · Cross-Border Guide
Seller: Cross-border seller evaluating Shopee Malaysia phone case market.
Command:
Compare local vs cross-border seller density for Shopee MY category 100490 — is cross-border viable?
Tool chain: shopee_product_search → shop_location: 1 vs shop_location: 2 → compare page_count
Verified output (2026-07-30):
- Local sellers: 16 pages (320 products)
- Cross-border sellers: 7 pages (140 products)
- Ratio: 44% — cross-border is viable, not locked by local sellers
Follow-up: Check cohort analysis to see if new products survive:
Check Shopee MY 100490 Listed1MonthSalesVolumeRatio trend — is the new product window still open?
Verified: Listed1Month ratio dropped from 2.05% to 0.0% — new product window is closing. Enter now or don't enter.
📊 Platform: 1688 Sourcing · Shopee Overview
Seller: Has identified a winning product on Shopee, wants to find the supplier on 1688.
Step 1 — Find the product on Shopee:
Show me Shopee MY 100490 Top 20 — what are the bestsellers?
Verified: UGREEN iPhone Case RM13.90, 3,477 monthly sales.
Step 2 — Search 1688 for similar products:
Search 1688 for "iphone case clear" — sort by price and sales volume
Verified: 100 results, ¥0-18 price range.
Step 3 — Filter for quality suppliers:
Search 1688 for phone case — filter: Verified Merchant, repurchase rate >30%, service rating >4.5, 30-day sales >50
Tool: ali1688_product_search with supplier_type: 1, repurchase_rate_min: 0.3, service_score_min: 4.5.
Step 4 — Check SKU detail:
Get SKU breakdown for this 1688 product — price, stock, weight, dimensions per variant
Verified: 83 SKU variants with exact stock (>977K units), weight (0.02kg), dimensions per variant.
Step 5 — Calculate margin: Shopee retail RM13.90 (≈¥21) vs 1688 wholesale ¥0.12-5 → 60-99% margin potential before logistics.
📊 Platform: Cross-Platform Overview
Seller: Amazon seller looking to expand to Walmart with existing products.
Command:
Compare yoga mat prices, seller count, and top brands between Amazon US and Walmart US
Verified findings: Premium Yoga Block Set — $34.99 Walmart vs $24.99 Amazon (40% premium on Walmart). Only 3 Walmart sellers vs 12 on Amazon — low competition entry point.
Loop setup:
/loop 7d Scan Walmart vs Amazon price gaps — alert if new product gap exceeds 20%
📊 Platform: Shopee Overview · Loop Engineering
Seller: Wants to monitor UGREEN's flagship product on Shopee MY daily.
Command:
Track Shopee MY 44411123270 daily sales & price for the last 6 months — alert if sales drop >50% or price changes
Loop:
/loop 1d Track Shopee MY 44411123270 daily sales & price — alert on >50% sales drop or any price change
Verified output: 208 days of daily sales data. Peak: 3,525/day. Latest: 3,477/day. Price: RM13.90 (stable). Coefficient of variation: 2.17 — pulse-style burst pattern, not steady daily sales.
📊 Platform: Shopee Overview
Seller: Building Shopee MY keyword library for phone accessories category.
Step 1 — Grab hot keywords:
Pull Shopee MY hot keyword ranking Top 20
Verified: XIAOMI, blouse women, powerbank, baju perempuan, glad2glow, skintific...
Step 2 — Save to favorites:
Add "phone case" to my Shopee MY favorites list "SP-MY-PhoneCase"
Tool: shopee_favorite_keyword(keyword, dict, site)
Step 3 — Weekly tracking:
/loop 7d Pull Shopee MY hot keyword Top 20 — flag new entries and rank jumps >5 positions
📊 Platform: Shopee Overview
Seller: Analyzing UGREEN's Shopee MY store to understand their strategy.
Command:
Analyze Shopee MY store 82080415 — scale, layout, is it a single-product or matrix store?
Verified output:
- Store: Ugreen Flagship Store, ★ 4.95, Selangor
- Top500 products: 253
- Monthly sales: 87,722 units, RM 3.3M revenue
- Average per-product: 347 units/month
- Verdict: Matrix strategy — broad catalog, moderate per-SKU sales
Compare with competitor:
Compare Shopee MY store 82080415 vs 1578947481 — scale difference
SnapNest.my: 7 products in Top500, 3,992 monthly sales. 18x difference in scale.
📊 Platform: Shopee Overview · Cross-Border Guide
Seller: Evaluating if now is the right time to enter Shopee MY phone case market.
Commands:
Check Shopee MY 100490 Flagship/Preferred/Regular store sales ratio trend — is the category brandifying?
Check Shopee MY 100490 Listed1Month/3Month/6Month new product sales ratio — survival window?
Check Shopee MY 100490 Top3/Top10 seller & product concentration trend
Verified findings (July 2026):
- Flagship store ratio: 3.06% → 3.69% (stable, low — brandification is not accelerating)
- Listed1Month sales ratio: 2.05% → 0.0% (new products dying out)
- Top3 product concentration: 5.14% → 4.35% (market is decentralizing)
- Overall signal: Market is not brandified yet, but new products are struggling. Need strong differentiation or a clear niche.
📊 Platform: Amazon Overview
Seller: Found a competitor doing well. Wants to reverse-engineer their entire strategy.
Commands:
Break down ASIN B0CCY6NFNY on Amazon US — traffic keywords, pricing history, review velocity, variations
Tool chain:
-
product_detail→ full product profile (price, brand, dimensions, category, BSR) -
product_traffic_terms→ 19 traffic keywords with monthly search volume and bid estimates -
competitor_product_keywords→ 7 keywords where this ASIN ranks, with exact page positions -
product_variations→ 55 child ASINs (identify which variant drives the most volume)
Verified output (live MCP, 2026-07-30): Area rug ASIN — 19 traffic keywords, top keyword "8x10 area rugs boho" (4,403 monthly searches, $0.86 bid), 7 competitor keywords tracked with page positions, 55 child ASIN variations.
📊 Platform: Amazon Overview
Seller: Wants to understand what customers hate about a competitor's product — and build a better one.
Command:
Analyze reviews for ASIN B0CCY6NFNY on Amazon US — what are customers complaining about?
Tool chain: product_reviews → 35+ reviews with star rating, variant attribute, review date, and title
What you extract:
- Most common pain points across 1-2 star reviews
- Variant-specific issues (e.g., "grey color fades" but "blue holds up")
- Review velocity pattern (are negative reviews increasing over time?)
Verified (live MCP, 2026-07-30): 35 reviews, average 4.1 stars, 100% variant-level attribution — every review tagged to a specific color/size combination.
📊 Platform: Amazon Overview
Seller: Crunching numbers before committing to a product.
Command:
Calculate FBA profit for a yoga mat: selling price $29.99, unit cost $8.50, weight 1.2lb
Tool chain: calculator.py --platform amazon --price 29.99 --cost 8.5 --weight 1.2
What you get: Gross margin, break-even daily sales, return rate sensitivity analysis. FBA fee estimated by weight — verify with actual dimensional weight from product detail.
Verified: Gross margin 38%, break-even 9 units/day, profit stays positive up to 12% return rate — viable.
📊 Platform: TikTok Shop
Seller: Exploring TikTok Shop US for beauty products — wants to understand the content-driven marketplace.
Command:
Show me top-selling TikTok Shop US beauty products — who are the top authors driving sales?
Tool chain:
-
tiktok_category_report→ Top 50 products with sales, price, seller, ratings -
tiktok_product_detail→ full product data -
tiktok_author→ author metrics (followers, engagement, product portfolio)
Verified (live MCP, 2026-07-30): TikTok US Vitamins category — 50 top products, 1.15M total monthly sales. Top product: Toplux Magnesium Complex, $14.97, 166,681 monthly sales. TikTok Shop data reveals which categories are driven by viral content vs steady search demand.
📊 Platform: TEMU
Seller: Manufacturer evaluating TEMU's semi-managed model vs traditional Amazon FBA.
Command:
Analyze TEMU US phone case category — price bands, managed types, monthly sales distribution
Tool chain:
-
temu_category_search_from_name→ find categories (US + EU sites) -
temu_category_request→ Top products withmanaged_typefield (semi-managed vs marketplace) -
temu_product_trend→ 7-dimension trend (sales, cumulative sales, price, reviews, rating)
Verified (live MCP, 2026-07-30): TEMU US phone case category — 20 products, $0-6.27 price range, 100% Semi-Managed. Top seller: 50,000 monthly sales at $1.17. The managed_type field confirms TEMU's model — platform controls pricing and fulfillment, sellers focus purely on supply.
📊 Platform: Cross-Platform Overview
Seller: Has a product idea but wants to validate real demand before committing.
Command:
Search "yoga mat" on Amazon US, Walmart US, TEMU US, and TikTok Shop US simultaneously — compare price bands, seller density, and review velocity
Tool chain: Parallel queries across 4 platforms — Amazon product_search, Walmart walmart_keyword_search_results, TEMU temu_product_search_from_name, TikTok tiktok_similar_product
Decision matrix:
| Signal | Meaning |
|---|---|
| All 4 platforms have volume | Real universal demand — invest confidently |
| Only Amazon shows volume | Search-driven demand — not necessarily a "real" trend |
| TEMU volume > Amazon volume | Price-sensitive market — manufacturing advantage wins |
| TikTok viral but no Amazon presence | Content-driven fad — move fast or skip |
See also: Loop Engineering
| # | Use Case | Loop Command | Frequency |
|---|---|---|---|
| 5 | Category scan |
/loop 1d Shopee MY Top 20 ranking diff |
Daily |
| 6 | Price alert |
/loop 1d product price & sales monitor |
Daily |
| 7 | Keyword tracking |
/loop 7d hot keyword diff |
Weekly |
| 8 | Store health |
/loop 7d competitor store metrics |
Weekly |
| 4 | Cross-platform arbitrage |
/loop 7d Walmart vs Amazon price gap |
Weekly |
| 2 | Seasonality prep |
/loop 30d peak season forecast update |
Monthly |
- 🆕 Closed-Loop Selection ← Full pipeline
- 📖 Case Study: Water Bottle ← Real data example
- Loop & Goal Templates ← 58 automation recipes