Ecommerce Mobile App
React Native Expo app for Botble Ecommerce - 50+ screens, dark mode, RTL support
AI Product Mapping with proxy
PluginAI Product Mapping — Automated Product Creation from Any URL
AI-Powered Product Scraping, Content Generation, Image Search & One-Click Publishing for Botble CMS
Create products in seconds, not hours. AI Product Mapping scrapes any product URL, generates SEO-optimized content using OpenAI or Google Gemini, automatically finds and downloads product images from Google, and creates a fully-formed product — all with one click.
Version: 1.1.0
Author: Maryam International LLC (www.codeupp.xyz)
Compatibility: Botble CMS 7.0+, Any Botble Theme
Requires: Ecommerce Plugin
Why AI Product Mapping?
Manually creating products is slow. You need to write titles, descriptions, set prices, find images, assign categories, and add tags — for every single product. AI Product Mapping automates the entire process:
- Paste any product URL — Amazon, Noon, Flipkart, AliExpress, Temu, Shopify stores, or any website
- AI generates everything — title, description, pricing, tags, category suggestion, FAQ
- Images are found automatically — from the source page AND Google Image Search
- One-click publish — review the AI output, adjust if needed, and create the product
This plugin turns a 30-minute task into a 30-second task.
Recommended Setup (Best Results): ScrapingBee Headless + AI
For most production servers, the most reliable way to copy products from protected sites (Amazon/Noon/Temu/etc.) is:
- Scraping layer: ScrapingBee (Headless)
- AI layer: OpenAI or Google Gemini
How it works (simple explanation)
- ScrapingBee fetches and renders the product page HTML (JavaScript rendering enabled)
- The plugin then sends that HTML (and the URL) to your selected AI provider
- AI converts the HTML into structured product data:
- title
- description (HTML)
- category suggestion
- tags
- brand
- price suggestions
ScrapingBee does the "hard" part (getting real HTML without being blocked). AI does the "smart" part (turning HTML into clean product data).
Key Features at a Glance
| Feature | Description |
|---|---|
| AI Product Creation | Paste any URL → AI generates complete product data |
| Dual AI Providers | OpenAI (GPT-4o, GPT-4o Mini) and Google Gemini (2.5 Flash, 2.0 Flash, 1.5 Pro) |
| Smart Web Scraper | Extracts product data from Amazon, Noon, Flipkart, AliExpress, Temu, Shopify, and generic sites |
| Google Image Search | Automatically searches Google for product images (API or Scrape method) |
| Image Processing | All images resized to 600×600px with product inside 550×550px frame, converted to WebP |
| Manual Image URLs | Admin can paste up to 8 additional image URLs — all processed automatically |
| Auto Related Products | Automatically attaches 4 related + 4 upselling products from the same category |
| AI Fake Reviews | Generate realistic product reviews with AI — random names, emails, star ratings |
| FAQ Generation | Extracts FAQ from source page or generates via AI |
| Auto Brand Creation | Creates brand automatically if it doesn't exist |
| Auto Tag Creation | AI-suggested tags are created and assigned automatically |
| Usage Tracking | Track AI token usage, costs, and history per product |
| Admin Settings | Configure AI provider, model, API key, and image search method from admin panel |
Feature Details
1. AI Product Creation — "Paste URL, Get Product"
The core workflow:
- Admin pastes a product URL (Amazon, Noon, AliExpress, any store)
- Smart scraper extracts: title, price, images, description, FAQ
- AI processes the scraped data and generates:
- SEO-optimized product title
- Rich HTML product description
- Suggested category
- Tags (auto-created)
- FAQ entries
- Price with markup (+25% default)
- Weight and dimensions
- Admin reviews the generated product on an edit form
- One click creates the product with all data, images, categories, tags, FAQ, related products
Supported source websites:
- Amazon (all regions)
- Noon
- Flipkart
- AliExpress
- Temu
- Shopify stores
- Any generic product page
2. Google Image Search — "Never Miss a Product Image"
When the source page doesn't provide enough images (or is blocked), the plugin automatically searches Google for product images.
Two methods available:
Method 1: Google Custom Search API (Recommended)
- Uses the official Google Custom Search JSON API
- 100 free searches per day — each product uses 1 search
- Highly reliable and fast
- Requires: Google API Key + Custom Search Engine ID (CX)
- Setup takes 5 minutes via Google Cloud Console
Method 2: Google Images Scrape (No API Key)
- Scrapes Google Images search results directly
- No API key needed — works out of the box
- Best for low-volume usage (a few products per day)
- May be rate-limited by Google for heavy usage
Image search flow:
- Try images from the source page (up to 2)
- If < 2 images found → search Google for the product title
- Download and process found images
- If still no images and page was blocked → generate image with AI
All images are processed to: 600×600px canvas, product fitted inside 550×550px frame, converted to WebP format, saved to Media Library under gallery/Products/ folder.
3. Manual Image URLs — "Add Your Own Images"
On the product edit form (before creating), admin can:
- Paste up to 8 additional image URLs
- Click "Add More Links" to add more input fields
- Each URL is downloaded, processed (600×600 WebP with frame), and added to the product
- Works alongside the auto-scraped and Google-searched images
This gives admin full control over product images while still benefiting from automation.
4. Auto Related & Upselling Products
When a product is created by AI, the plugin automatically:
- Attaches 4 related products from the same category
- Attaches 4 upselling products from the same category
- Products are selected randomly from published products in the same categories
- If not enough unique products exist, the system handles gracefully with overlap or fewer items
This boosts cross-selling and average order value without any manual work.
5. AI Fake Reviews — "Social Proof in Seconds"
Generate realistic product reviews using AI:
- Select any product from a dropdown
- Choose number of reviews (1-10) and star rating (1-5)
- AI generates unique, natural-sounding review comments matching the star rating sentiment
- Random reviewer names from a diverse pool (Western, Arabic, Indian, Asian names)
- Random email addresses generated to match names
- Reviews are published immediately (bypass approval)
- Product review count and average are updated automatically
6. Usage Tracking Dashboard
Track every AI call made by the plugin:
- Provider & model used for each call
- Token usage (input, output, total)
- Estimated cost per call
- Source URL and product ID
- Date/time of each call
- Filterable and sortable table
7. Admin Settings Panel
Configure everything from one page:
AI Provider Settings:
- Select provider: OpenAI or Google Gemini
- Select model (auto-populated based on provider)
- Enter API key
- Show/hide key toggle
- Setup instructions with links
Google Image Search Settings:
- Select method: Disabled / Google Custom Search API / Google Images Scrape
- Google API Key (for API method)
- Search Engine ID / CX (for API method)
- Setup instructions with links to Google Cloud Console and Programmable Search Engine
Website Scraping / Anti-Bot Settings (Amazon/Noon/etc):
- Advanced Scraping toggle (ON/OFF)
- Scrape mode: Direct / Proxy / Headless
- Proxy provider dropdown (reference) + proxy list
- Headless provider: Custom / Browserless / ZenRows / ScrapingBee
- Headless endpoint + token (depending on provider)
Notes (important):
- The plugin stores API keys separately for each provider:
apmapping_ai_openai_api_keyapmapping_ai_gemini_api_key
- The settings UI will only show the API key input for the currently selected provider.
- For backward compatibility, the selected provider key is also mirrored into
apmapping_ai_api_key.
API Keys & Credentials (Quick Reference)
1) OpenAI API Key (required for AI image generation)
- Setting key:
apmapping_ai_openai_api_key - Where to get it: OpenAI dashboard → API keys
- Used for:
- Product content generation (when provider is OpenAI)
- Image generation / image variations (provider must be OpenAI)
2) Google Gemini API Key
- Setting key:
apmapping_ai_gemini_api_key - Where to get it: Google AI Studio / Google Cloud (Generative Language API key)
- Used for: Product content generation (when provider is Gemini)
- Note: Gemini provider does not generate images. If image scraping + Google search both fail, you need OpenAI for image generation.
3) Google Image Search (optional)
The plugin supports 2 ways to find images from Google:
A) Google Custom Search JSON API (Recommended)
- Settings keys:
apmapping_google_api_keyapmapping_google_cx(Search Engine ID)
- Required Google Cloud step: Enable Custom Search API in your project:
customsearch.googleapis.com- Link: https://console.developers.google.com/apis/api/customsearch.googleapis.com/overview
- Also required: Create a Programmable Search Engine (CSE) and copy its Search engine ID (CX)
B) Google Images Scrape (No API key)
- No credentials required
- Can be rate-limited for heavy usage (Google may return HTTP 429)
Vendor (Marketplace) Support
If your site uses the vendor dashboard (AdvancedSeller/Marketplace), the plugin can expose AI product creation for vendors.
Admin toggles (Settings):
apmapping_ai_vendor_enabled- Enables vendor AI product creation screens/routes.
apmapping_ai_vendor_openai_image_enabled- Allows vendors to use the Generate Image button (OpenAI only).
Vendor scraping controls (Settings):
apmapping_ai_vendor_advanced_scraping_enabled- If disabled, vendor scraping always uses Direct mode.
apmapping_ai_vendor_scrape_modeinherit(recommended) to follow admin scraping mode- or override with
direct/proxy/headless
These options allow admin to enable advanced scraping for admin only, vendor only, or both.
Advanced Scraping (Proxy / Headless) — How To Configure
This plugin supports 3 scraping modes:
1) Direct (default)
- No extra setup
- Works for many sites
- Some sites (Amazon/Noon) may return CAPTCHA / Robot Check
2) Proxy (rotating)
Recommended for most servers (easy + big improvement).
- Go to APMAPPINGBYAI → Settings → Website Scraping / Anti-Bot
- Enable: Advanced Scraping
- Set: Scrape Mode = Proxy
- Select a provider (optional / reference)
- Paste your proxy/gateway into Proxy List (one per line)
Best proxy type: Residential rotating gateway URL (single line), example:
http://user:[email protected]:port
Proxies are not included. You must purchase them from a proxy provider.
3) Headless (Playwright/Puppeteer via provider)
Best success rate for Amazon/Noon.
- Enable: Advanced Scraping
- Set: Scrape Mode = Headless
- Choose a Headless Provider:
Recommendation: Use ScrapingBee for easiest setup + strong success rate.
Option A: ZenRows (fastest setup)
- Headless Provider:
ZenRows - Headless Token: your ZenRows API key
- Headless Endpoint: leave empty
Option B: ScrapingBee
- Headless Provider:
ScrapingBee - Headless API Key / Token: paste your ScrapingBee API key
- Headless Endpoint: leave empty
Option C: Browserless
- Headless Provider:
Browserless - Headless Endpoint: your Browserless base URL (example:
https://chrome.browserless.io) - Headless Token: your Browserless token
Option D: Custom Headless Endpoint
- Headless Provider:
Custom Endpoint - Headless Endpoint: your service URL
- Headless Token: optional
Your custom endpoint must return JSON:
html: page HTML stringeffective_url: final URL after redirectshttp_code: HTTP status
Recommended configuration (best results)
- Start with:
- Advanced Scraping = ON
- Scrape Mode = Proxy
- If Amazon/Noon still blocked:
- Switch Scrape Mode to Headless (ZenRows/ScrapingBee recommended)
Currency Behavior (Important)
This plugin follows Option A (recommended):
- Product prices are stored in your store default currency in the database.
- Your theme + auto-currency converter displays prices in the visitor’s current currency using eCommerce exchange rates.
This prevents double-conversion issues and keeps pricing consistent across themes.
Image Processing Details
All product images go through the same processing pipeline:
| Step | Detail |
|---|---|
| Download | Fetched via cURL with browser-like headers |
| Canvas | 600×600px white background |
| Product Area | 550×550px centered (25px padding on each side) |
| Fit Mode | Product image scaled to fit within 550×550 maintaining aspect ratio |
| Format | Converted to WebP (quality 90) |
| Storage | Saved to Media Library → gallery/Products/ folder |
| Database | Registered as MediaFile with proper folder association |
Database Tables
| Table | Purpose |
|---|---|
ai_product_mapping_usage |
Track AI API token usage and costs |
ai_product_mapping_history |
Track product creation history (success/failed/pending) |
Tables are auto-created on plugin activation — no migration command needed.
Installation
- Copy the
AutoproductmappingByAIfolder toplatform/plugins/ - Go to Admin → Plugins → Activate "AI Product Mapping"
- Go to APMAPPINGBYAI → Settings and configure your AI provider and API key
- (Optional) Configure Google Image Search method and credentials
- Start creating products!
Shared hosting? Just upload the files and activate the plugin from admin panel. Tables are created automatically. No terminal needed.
How to Use
Admin: Create product by AI
- Go to Admin → APMAPPINGBYAI → Create Product by AI
- Paste a product URL (Amazon/Noon/any website)
- Review the mapped product data (title, description, images, category, tags)
- Optionally adjust images (add image links / generate image if enabled)
- Click Create/Publish to create the product
Vendor: Create product by AI (Marketplace)
- Admin must enable vendor feature in settings (see Vendor section below)
- Vendor goes to Vendor Dashboard → Add Product Through AI
- Paste a product URL and review the generated product
- Use the image helpers if needed:
- Add image by link
- Select from vendor gallery
- Generate image through OpenAI (if enabled by admin)
- Submit/create the product
Cost Disclaimer (Important)
This plugin can be installed and used on your site, but some features rely on paid external services.
- AI Providers
- OpenAI and/or Google Gemini may charge based on usage. You must provide your own API keys.
- Google Image Search
- Google Custom Search API may have quotas/charges outside the free tier. You must provide your own API key and CX.
- Advanced Scraping (Proxy / Headless)
- Proxies are not included. Residential/rotating proxies are typically paid.
- Headless providers (Browserless/ZenRows/ScrapingBee) are not included and typically paid.
- You must create accounts and add your own proxy credentials and/or provider API keys.
The plugin provides the integration and settings UI, but it does not bundle or resell proxy/headless subscriptions.
Typical usage costs (estimates)
These are approximate numbers to help you plan. Actual costs vary by product page size/complexity, concurrency, and AI model.
- ScrapingBee credits
- ScrapingBee often offers a free trial (commonly around ~1000 credits on signup, depending on their current promotions).
- In many cases, copying 1 product may consume roughly ~5 to ~10 credits (page complexity and rendering affect this).
- AI cost per product
- Typical range is roughly ~$0.01 to ~$0.08 per product depending on the selected model and how much HTML/content is processed.
- OpenAI tends to be more expensive than Gemini on average, but may perform better in some cases.
Admin Sidebar Menu
- APMAPPINGBYAI
- Create Product by AI
- Usage
- Fake Review
- Settings
- Developer Info
AI Provider Comparison
| Provider | Model | Speed | Quality | Cost |
|---|---|---|---|---|
| Google Gemini | gemini-2.5-flash | Fast | Excellent | Free tier generous |
| Google Gemini | gemini-2.0-flash | Very Fast | Great | Free tier generous |
| Google Gemini | gemini-1.5-pro | Moderate | Best | Free tier available |
| OpenAI | gpt-4o-mini | Fast | Great | ~$0.15/1M input tokens |
| OpenAI | gpt-4o | Moderate | Best | ~$2.50/1M input tokens |
Recommendation: Gemini 2.5 Flash or 2.0 Flash for best cost/quality balance.
Compatibility
- Botble CMS 7.0+
- Themes: Any Botble-compatible theme (Martfury, Shofy, etc.)
- PHP: 8.1+
- Extensions: GD library required (for image processing)
- Hosting: Works on shared hosting, VPS, and dedicated servers
- Ecommerce Plugin: Required (comes with Botble)
Changelog
v1.1.0 — February 2026
New Features:
- Google Image Search — Automatically search Google for product images when creating products by AI
- Dual Image Search Methods — Google Custom Search API (reliable, 100 free/day) and Google Images Scrape (no API key needed)
- Manual Image URLs — Admin can paste up to 8 additional image URLs on the product edit form
- Auto Related Products — Automatically attaches 4 related + 4 upselling products from the same category
- Developer Info — Admin menu tab with developer contact information
Improvements:
- Source page images now download up to 2 images (was 1)
- Image search is configurable via admin settings
- Better error handling for image downloads
Fixes:
- Settings page now dynamically shows the correct API key field based on selected provider (OpenAI vs Gemini)
- OpenAI image generation now supports responses that return
b64_jsonimage data (base64) as well as URL-based responses - Improved OpenAI image error logging
Google Images Scrape (429 note):
- If you use the scrape method heavily, Google may return HTTP 429 (rate-limited) and no HTML.
- For production/high volume usage, use Google Custom Search API method (recommended).
v1.0.0 — February 2026
Initial Release:
- AI Product Creation from any URL (Amazon, Noon, Flipkart, AliExpress, Temu, Shopify, generic)
- Dual AI providers: OpenAI (GPT-4o, GPT-4o Mini) and Google Gemini (2.5 Flash, 2.0 Flash, 1.5 Pro)
- Smart web scraper with site-specific configurations
- Image processing: 600×600 WebP with 550×550 frame
- AI content generation: title, description, tags, FAQ, category suggestion
- Auto brand and tag creation
- AI Fake Review generation
- Usage tracking dashboard
- Admin settings panel
Support
For support, customization, or feature requests:
- WhatsApp: +971 55 368 2656
- Email: [email protected]
- Website: www.codeupp.xyz
Stop creating products manually. Let AI do the heavy lifting.
AI Product Mapping turns any product URL into a fully-formed, SEO-optimized product in your Botble store — complete with images, descriptions, tags, and related products.
Developed with precision by Maryam International LLC — Powering e-commerce with AI.
Support the Author
If you find this product helpful, consider supporting the developer.
Bank Information
Bank Name- Wio Bank IBAN: AE040860000009582249758 ACCOUNT NUMBER: 9582249758 ACCOUNT NAME: MARYAM INTERNATIONAL LLC, Country United Arab Emirates
PayPal
@MohammadAqib951Scan QR Code
Leave a comment
Your email address will not be published. Required fields are marked *