AI Product Mapping with proxy For Martfury, Shofy, Nest

AI Product Mapping — Automated Product Creation from Any URLAI-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)

1. ScrapingBee fetches and renders the product page HTML (JavaScript rendering enabled)
2. The plugin then sends that HTML (and the URL) to your selected AI provider
3. 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

FeatureDescription

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 Details1. AI Product Creation — "Paste URL, Get Product"

The core workflow:

1. Admin pastes a product URL (Amazon, Noon, AliExpress, any store)
2. Smart scraper extracts: title, price, images, description, FAQ
3. 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
4. Admin reviews the generated product on an edit form
5. 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:

1. Try images from the source page (up to 2)
2. If < 2 images found → search Google for the product title
3. Download and process found images
4. 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_key
  • apmapping_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_key
  • apmapping_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_mode
  • inherit (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).

1. Go to APMAPPINGBYAI → Settings → Website Scraping / Anti-Bot
2. Enable: Advanced Scraping
3. Set: Scrape Mode = Proxy
4. Select a provider (optional / reference)
5. Paste your proxy/gateway into Proxy List (one per line)

Best proxy type: Residential rotating gateway URL (single line), example:

http://user:pass@gateway.provider.com: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.

1. Enable: Advanced Scraping
2. Set: Scrape Mode = Headless
3. 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 string
• effective_url: final URL after redirects
• http_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:

StepDetail

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

TablePurpose

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

1. Copy the AutoproductmappingByAI folder to platform/plugins/
2. Go to Admin → Plugins → Activate "AI Product Mapping"
3. Go to APMAPPINGBYAI → Settings and configure your AI provider and API key
4. (Optional) Configure Google Image Search method and credentials
5. 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 UseAdmin: Create product by AI

1. Go to Admin → APMAPPINGBYAI → Create Product by AI
2. Paste a product URL (Amazon/Noon/any website)
3. Review the mapped product data (title, description, images, category, tags)
4. Optionally adjust images (add image links / generate image if enabled)
5. Click Create/Publish to create the product

Vendor: Create product by AI (Marketplace)

1. Admin must enable vendor feature in settings (see Vendor section below)
2. Vendor goes to Vendor Dashboard → Add Product Through AI
3. Paste a product URL and review the generated product
4. Use the image helpers if needed:
   • Add image by link
   • Select from vendor gallery
   • Generate image through OpenAI (if enabled by admin)
5. 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

ProviderModelSpeedQualityCost

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)

Changelogv1.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_json image 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: maryaminternationalllc@gmail.com
• 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.