AI-Powered Features — MyntCart Docs

Setup Required

Go to Admin Panel → System Settings → AI Settings. Enter your Anthropic API key, enable the master switch, then toggle individual features. Database-only features (Recommendations, Delivery ETA, Pricing, Forecasting) work without an API key.

Phase 1 — Product AI Tools

AI tools integrated directly into admin and vendor product add/edit forms. Available on web panel and Flutter vendor/store apps.

AI Product Descriptions

Click "Generate with AI" next to the description field. Claude generates an SEO-optimized 80-150 word description from the product name, category, and price.

Trigger	Button on product add/edit form
Input	Product name, category, price
Output	Plain text description (2-3 paragraphs)
API Key Required	Yes (Claude)
Platforms	Admin Panel, Vendor Panel, Vendor App (v3), Store App (v4)

Auto-Categorization

Click "AI Suggest" next to the category dropdown. Claude analyzes the product name against all available categories and auto-selects the best match.

Trigger	Button on product form, next to category
Input	Product name + category tree
Output	category_id + sub_category_id (auto-selects dropdowns)
API Key Required	Yes (Claude)

Auto Image Tagging

Click "AI Tags" in the SEO section after uploading a product thumbnail. Claude Vision analyzes the image and generates 5-10 relevant SEO keywords.

Trigger	Button in SEO section of product form
Input	Product thumbnail image + name
Output	Array of SEO tags → populates meta fields
API Key Required	Yes (Claude Vision)

AI Meta Description

Click "Generate with AI" next to the meta description field. Generates a 160-character SEO meta description from the product name and category.

Trigger	Button next to meta description textarea
Output	Plain text, max 160 chars
API Key Required	Yes (Claude)

Phase 2 — Customer Experience

AI features that enhance the shopping experience for customers on the website and mobile app.

Shopping Assistant Chatbot

Floating chat widget on the storefront (bottom-left corner). Customers can search products, track orders, and get store info via natural conversation.

Location	All 3 themes (Classic, Modern, Semi-Classic)
Intent Detection	product_search, order_tracking, store_info, greeting, general
Product Search	Returns product cards with images, prices, and links
Order Tracking	Shows order status, payment, amount, date (requires login)
API Key Required	Yes (Claude)
API Endpoint	`POST /api/v1/ai/chatbot`

Review Summarization

AI generates a 2-3 sentence summary of all customer reviews, shown at the top of the Reviews tab. Cached for 24 hours, auto-invalidates on new reviews.

Minimum Reviews	3 reviews required to generate summary
Cache Duration	24 hours
Display	Green card above individual reviews
API Key Required	Yes (Claude)
API Endpoint	`GET /api/v1/ai/review-summary/{productId}`

Background Removal

One-click product image background removal using remove.bg API. Replaces busy backgrounds with clean white for professional product photos.

External API	remove.bg (API key required)
Max Image Size	5MB
Output	PNG with white background
Setup	Enter remove.bg API key in AI Settings

Phase 3 — Smart Commerce

Intelligent search and recommendation systems that boost discovery and conversions.

Smart NLP Search

Customers search naturally: "blue cotton shirt under 500 for men". Claude parses the query into structured filters (keywords, price range, color, brand, category, sort order).

Input	Natural language search query (max 200 chars)
Parsed Filters	keywords, min_price, max_price, color, brand, category, sort
Cache	5 minutes per unique query
Fallback	Regular keyword search if AI disabled
API Key Required	Yes (Claude)
API Endpoint	`POST /api/v1/ai/smart-search`

Product Recommendations Engine

Four recommendation algorithms — all database-driven (no AI API calls). Displayed on product detail pages and homepage across all 3 themes.

Frequently Bought Together	Co-purchase analysis from order history
Similar Products	Same category + similar price range
Trending Now	Most ordered products in last 7 days
Personalized	Based on customer's purchase history categories
Cache	30-60 minutes
API Key Required	No (database queries only)
API Endpoints	`GET /api/v1/ai/recommendations/fbt/{id}` `GET /api/v1/ai/recommendations/similar/{id}` `GET /api/v1/ai/recommendations/trending` `GET /api/v1/ai/recommendations/personalized`

Phase 4 — Business Intelligence

AI-powered pricing, delivery prediction, and discount optimization tools for smarter business decisions.

Smart Delivery ETA

Predicts delivery time based on historical order data, haversine distance, vendor performance, and day-of-week patterns. Shown on product detail page for all 3 themes.

Logged-in Users	Uses saved shipping address (server-side, instant)
Guest Users	Browser geolocation prompt (client-side AJAX)
Distance Factors	<5km: 0.8x, <20km: 1.0x, <50km: 1.3x, <200km: 1.6x, >200km: 2.0x
Weekend Factor	Saturday/Sunday: 1.15x slower
Display	"1-2 Days (18.6 km away)" in green
API Key Required	No (historical data + math)
API Endpoint	`POST /api/v1/ai/delivery-eta`

Pricing Suggestions

Click "AI Price" on the product form. Analyzes all products in the same category and returns median price, average, min/max range, and competitive range (P25-P75).

Trigger	Button next to unit price field
Output	Suggested price, average, range, competitor count
Auto-fill	Fills unit price field if empty
API Key Required	No (database queries only)

Discount Optimizer

Analyzes product metrics (views, sales, conversion rate, stock levels, days since last sale) and suggests an optimal discount percentage. Uses Claude API or falls back to rule-based engine.

Metrics Analyzed	Views, sales, conversion %, stock, days listed, days since last sale
Output	Suggested discount (0-50%), reasoning, urgency level
Fallback	Rule-based engine if no API key
API Key Required	Optional (works without, better with)

Phase 5 — Advanced Features

Visual search, sales forecasting, and fraud detection for enterprise-grade intelligence.

Visual Search

Customer uploads a photo → Claude Vision identifies the product type, color, material, and style → searches the catalog for matching products.

Input	Product photo (JPEG/PNG/WebP, max 5MB)
AI Analysis	Product type, color, material, style, search query
Output	Up to 12 matching products
API Key Required	Yes (Claude Vision)
API Endpoint	`POST /api/v1/ai/visual-search`

Sales Forecasting Dashboard

Admin page showing 7-day revenue and order predictions with growth trends, daily breakdown table, and low-stock alerts. Uses moving averages and seasonal patterns.

Location	Admin Panel → System Settings → Sales Forecast
Predictions	Revenue, orders, growth rate per day
Stock Alerts	Products predicted to run out within 7 days
Data Source	Last 30 days of order history
Cache	30 minutes
API Key Required	No (historical data analysis)

Fraud Detection

Scores every order on 7 risk factors and flags suspicious orders for admin review. Accessible from Admin Panel sidebar.

Location	Admin Panel → System Settings → Fraud Alerts
Risk Factors (7)	New account + high value, multiple addresses, amount anomaly, unusual hours (2-5AM), guest + high value, rapid repeat orders, mismatched billing/shipping
Scoring	0-100 score → Low (<25), Medium (25-49), High (50+)
Scan Range	Last 72 hours of orders
API Key Required	No (rule-based scoring)

API Reference

All AI features are available via REST API for Flutter mobile apps.

Customer App (v1) — `/api/v1/ai/`

Method	Endpoint	Auth	Purpose
`POST`	`/ai/chatbot`	Optional	Shopping assistant chat
`GET`	`/ai/review-summary/{productId}`	No	AI review digest
`POST`	`/ai/smart-search`	No	Natural language search
`POST`	`/ai/visual-search`	No	Image-based product search
`GET`	`/ai/recommendations/fbt/{id}`	No	Frequently bought together
`GET`	`/ai/recommendations/similar/{id}`	No	Similar products
`GET`	`/ai/recommendations/trending`	No	Trending products
`GET`	`/ai/recommendations/personalized`	Optional	Personalized picks
`POST`	`/ai/delivery-eta`	No	Predict delivery time

Vendor App (v3) — `/api/v3/seller/ai/`

Method	Endpoint	Auth	Purpose
`GET`	`/ai/status`	Seller	Get AI feature toggles
`POST`	`/ai/generate-description`	Seller	Generate product description
`POST`	`/ai/suggest-category`	Seller	Auto-categorize
`POST`	`/ai/generate-tags`	Seller	Generate tags from image
`POST`	`/ai/suggest-pricing`	Seller	Competitive pricing
`POST`	`/ai/suggest-discount`	Seller	Discount recommendation

Store App (v4) — `/api/v4/ai/`

Method	Endpoint	Auth	Purpose
`GET`	`/ai/status`	No	Get AI feature toggles
`POST`	`/ai/generate-description`	Store	Generate product description
`POST`	`/ai/suggest-category`	Store	Auto-categorize
`POST`	`/ai/generate-tags`	Store	Generate tags from image
`POST`	`/ai/suggest-pricing`	Store	Competitive pricing
`POST`	`/ai/suggest-discount`	Store	Discount recommendation

AI Settings Configuration

Setting	Default	Description
`ai_features_enabled`	OFF	Master switch for all AI features
`ai_anthropic_api_key`	—	Claude API key from console.anthropic.com
`ai_removebg_api_key`	—	remove.bg API key (background removal only)
`ai_product_description`	OFF	AI product descriptions
`ai_auto_categorization`	OFF	Auto-categorization
`ai_auto_tagging`	OFF	Auto image tagging
`ai_review_summary`	OFF	Review summarization
`ai_background_removal`	OFF	Background removal
`ai_chatbot`	OFF	Shopping assistant chatbot
`ai_smart_search`	OFF	NLP smart search
`ai_recommendations`	ON*	Product recommendations (* works without API key)
`ai_visual_search`	OFF	Visual search
`ai_fraud_detection`	OFF	Fraud detection alerts

Cost Estimation

Feature	API Calls/Day (Est.)	Monthly Cost (Est.)
Product Descriptions	10-50	$2-10
Auto-Categorization	10-50	$1-5
Auto-Tagging (Vision)	10-50	$3-15
Review Summarization	5-20	$2-8
Chatbot	50-500	$10-100
Smart Search	50-500	$5-50
Visual Search (Vision)	10-50	$3-15
Discount Optimizer	5-20	$1-3
Recommendations	—	$0 (no API calls)
Delivery ETA	—	$0 (no API calls)
Sales Forecast	—	$0 (no API calls)
Fraud Detection	—	$0 (no API calls)
Total		$27-206/month

Background Removal uses remove.bg API: $0.20/image (first 50 free/month).