E-Commerce Cluster

Answer natural language e-commerce questions by routing to the right Apify Actor and delivering a synthesized answer.

Prerequisites

(No need to check it upfront)

• .env file with APIFY_TOKEN
• Node.js 20.6+ (for native --env-file support)
• mcpc CLI tool: npm install -g @apify/mcpc

Workflow

Copy this checklist and track progress:

Task Progress:
- [ ] Step 1: Detect intent and select Actor
- [ ] Step 2: Fetch Actor schema via mcpc
- [ ] Step 3: Ask user preferences (format, result count)
- [ ] Step 4: Run the Actor
- [ ] Step 5: Analyze results and deliver synthesized answer

Step 1: Detect Intent and Select Actor

Classify the user's message into an intent, then pick the right Actor.

Intent signals:

Signals in user message	Intent
price, cost, cheapest, compare prices, pricing	pricing
review, rating, sentiment, stars, feedback	reviews
bestseller, top selling, most popular, trending	bestsellers
seller, vendor, reseller, who sells	sellers
all products from, scrape store, full catalog	store-scrape
what platform, built on, tech stack, Shopify or WooCommerce	tech-stack
SEO, listing quality, product page audit	seo-audit
competitor funnel, competitor pricing, conversion elements	competitor
search intent, keyword intent, SERP intent	search-intent
match products, same product on different platforms	product-matching
restaurant, food delivery, DoorDash, UberEats, TheFork	food-delivery
enrich store, store metadata, store list	store-enrichment
event, concert, ticket, Eventbrite	events
property, real estate, house listing, Realtor	real-estate
Facebook ads, Meta ads, ad library, competitor ads	ads-intelligence
classified, Craigslist, used item for sale	classifieds
car, used car, vehicle, automotive, Webmotors	automotive
pins, inspiration, Pinterest boards, visual search, Pinterest trends	content-discovery
TikTok Shop, TikTok store, TikTok creator	tiktok-shop
website for sale, domain for sale, Flippa	website-marketplace

If multiple intents are detected, ask: "Do you want [intent A] or [intent B]?"

Actor routing table — always try Primary first, switch to Fallback only if it fails or returns 0 results:

Intent	Platform	Primary Actor	Fallback Actor
pricing	Amazon / Walmart / generic	apify/e-commerce-scraping-tool	—
pricing	eBay	apify/e-commerce-scraping-tool	ivanvs/ebay-scraper-pay-per-result
pricing	Etsy	apify/e-commerce-scraping-tool	epctex/etsy-scraper
pricing	Google Shopping	apify/e-commerce-scraping-tool	epctex/google-shopping-scraper
pricing	Facebook Marketplace	apify/e-commerce-scraping-tool	apify/facebook-marketplace-scraper
pricing	SHEIN	apify/e-commerce-scraping-tool	seamless_coffer/shein-product-scraper
pricing	Lazada	apify/e-commerce-scraping-tool	fatihtahta/lazada-scraper
pricing	Canadian Tire	apify/e-commerce-scraping-tool	azzouzana/canadiantire-ca-scraper
pricing	Tesco	apify/e-commerce-scraping-tool	radeance/tesco-scraper
pricing	Shopify	apify/e-commerce-scraping-tool	trovevault/shopify-products-scraper
pricing	WooCommerce	apify/e-commerce-scraping-tool	trovevault/woocommerce-products-scraper
reviews	Amazon / Walmart / generic	apify/e-commerce-scraping-tool	junglee/amazon-reviews-scraper
reviews	Trustpilot	apify/e-commerce-scraping-tool	casper11515/trustpilot-reviews-scraper
reviews	TheFork	apify/e-commerce-scraping-tool	jdtpnjtp/thefork-restaurant-scraper-advanced
bestsellers	Amazon	apify/e-commerce-scraping-tool	junglee/amazon-bestsellers
sellers	Amazon	apify/e-commerce-scraping-tool	junglee/amazon-seller-scraper
sellers	eBay	apify/e-commerce-scraping-tool	ivanvs/ebay-scraper-pay-per-result
store-scrape	Shopify	apify/e-commerce-scraping-tool	trovevault/shopify-products-scraper
store-scrape	WooCommerce	apify/e-commerce-scraping-tool	trovevault/woocommerce-products-scraper
store-scrape	Amazon	apify/e-commerce-scraping-tool	junglee/Amazon-crawler
store-scrape	Flippa	apify/e-commerce-scraping-tool	scraped/flippa-scraper
tech-stack	any	apify/e-commerce-scraping-tool	trovevault/e-commerce-tech-stack-detector
seo-audit	any	apify/e-commerce-scraping-tool	trovevault/product-listing-seo-auditor
competitor	any	apify/e-commerce-scraping-tool	trovevault/competitor-intelligence-scraper---funnel-pricing-conversion
search-intent	any	apify/e-commerce-scraping-tool	trovevault/ai-serp-intent-extractor---search-intent-classifier
product-matching	any	apify/e-commerce-scraping-tool	tri_angle/product-matching-vectorizer
store-enrichment	any	apify/e-commerce-scraping-tool	trovevault/e-commerce-store-data-enricher
food-delivery	DoorDash	apify/e-commerce-scraping-tool	tri_angle/doordash-store-details-scraper
food-delivery	UberEats	apify/e-commerce-scraping-tool	e-commerce/ubereats-reviews-scraper
food-delivery	TheFork	apify/e-commerce-scraping-tool	jdtpnjtp/thefork-restaurant-scraper-advanced
ads-intelligence	Facebook / Meta	apify/e-commerce-scraping-tool	apify/facebook-ads-scraper
classifieds	Craigslist	apify/e-commerce-scraping-tool	ivanvs/craigslist-scraper-pay-per-result
automotive	Webmotors	apify/e-commerce-scraping-tool	stealth_mode/webmotors-auto-search-scraper
events	Eventbrite	apify/e-commerce-scraping-tool	aitorsm/eventbrite
real-estate	Realtor.com	apify/e-commerce-scraping-tool	powerai/realtor-properties-search-scraper
content-discovery	Pinterest	apify/e-commerce-scraping-tool	fatihtahta/pinterest-scraper-search
tiktok-shop	TikTok Shop	apify/e-commerce-scraping-tool	lemur/tiktok-shop-creators
website-marketplace	Flippa	apify/e-commerce-scraping-tool	scraped/flippa-scraper

Step 2: Fetch Actor Schema

Fetch the Actor's input schema dynamically using mcpc:

export $(grep APIFY_TOKEN .env | xargs) && mcpc --json mcp.apify.com --header "Authorization: Bearer $APIFY_TOKEN" tools-call fetch-actor-details actor:="ACTOR_ID" | jq -r ".content"

Replace ACTOR_ID with the selected Actor (e.g., apify/e-commerce-scraping-tool).

This returns:

• Actor description and README
• Required and optional input parameters
• Output fields (if available)

Step 3: Ask User Preferences

Before running, ask:

1. Output format:
   • Quick answer (default) — synthesized answer in chat, no file saved
   • CSV — full export saved to disk
   • JSON — full export saved to disk
2. Result count — suggest defaults by intent:

Intent	Default
pricing	50 products
reviews	200 reviews
bestsellers	100 items
sellers	50 sellers
store-scrape	all (unlimited)
food-delivery	50 restaurants
all others	20–50

Step 4: Run the Actor

Quick answer (display in chat, no file):

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT'

CSV:

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output YYYY-MM-DD_filename.csv \
  --format csv

JSON:

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output YYYY-MM-DD_filename.json \
  --format json

Step 5: Analyze Results and Deliver Answer

After the run completes, deliver a direct synthesized answer — not a data dump:

• Pricing: price range, average, top 5 cheapest with URLs
• Reviews: average rating, top 3 positive and negative themes, recent snippets
• Bestsellers: top 10 by rank with name, price, rating, URL
• Sellers: total sellers, price range per seller, unauthorized seller flags
• Store-scrape: total products, category breakdown, price range, stock summary
• Tech-stack: platform detected, confidence level, notable plugins
• Food delivery: restaurant count, average rating, price tier breakdown
• Ads intelligence: total ads, active/inactive split, top creative formats

Error Handling

APIFY_TOKEN not found — Ask user to create .env with APIFY_TOKEN=your_token mcpc not found — Ask user to install: npm install -g @apify/mcpc Actor not found — Check Actor ID spelling in routing table Run FAILED — Ask user to check the Apify console link in error output Timeout — Reduce result count or increase --timeout No results — Broaden keyword or switch to Fallback Actor from routing table proxy is required — Add "proxy": {"useApifyProxy": true} to input Platform not detected — Default to apify/e-commerce-scraping-tool with generic intent