WP Manifestindependent plugin directory
manifest / ecommerce / ed-ai-image-search-products

ED AI Image Search Products

Поиск товаров WooCommerce по загружаемому пользователем изображению

by Ed Shpigel · github.com/edshpigel/ed-ai-image-search-products · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/edshpigel/ed-ai-image-search-products/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/edshpigel/ed-ai-image-search-products ↗

ED AI Image Search Products

Поиск товаров WooCommerce по загружаемому пользователем изображению (через Groq API).

Как это работает (архитектура)

  1. Индексирование товаров
  • Для товара хранится “визуальное описание” в мета-поле: \EdAiImageSearchProducts\Plugin::PRODUCT_META_KEY_DESC
  • Описание можно сгенерировать из featured image товара через Groq прямо в админке.
  1. Поиск по изображению пользователя
  • Пользователь загружает изображение в форме (шорткод).
  • Плагин отправляет изображение в Groq и получает JSON с description + keywords.
  • Плагин локально получает кандидатов через WP_Query (по тексту/ключевым словам).
  • Затем Groq ранжирует только небольшое число кандидатов (например 20) и возвращает top-N (до 10).

Почему так лучше, чем “слать справочник всех товаров в Groq каждый раз”:

  • Это масштабируется (не упирается в токены).
  • Быстрее/дешевле.
  • Не раскрывает весь каталог в каждом запросе.

Установка

  1. Скопируйте папку плагина в wp-content/plugins/ed-ai-image-search-products/
  2. Активируйте плагин в WordPress.
  3. Откройте Settings → AI Image Search
  • включите Enable
  • вставьте Groq API key
  • при необходимости измените Groq model

Генерация описания товара

Откройте товар (Product) в админке → метабокс AI Image Search Description → нажмите:

  • Generate from product image (Groq)

Сгенерированный текст сохранится в мета-поле и будет использоваться для поиска.

Вывод формы на сайте

Добавьте шорткод в страницу/пост:

[ed_ai_image_search_products]

REST endpoints

  • POST /wp-json/ed-ai-image-search-products/v1/search
    • multipart/form-data поле image (JPG/PNG/WEBP, до 4MB)
  • POST /wp-json/ed-ai-image-search-products/v1/generate-product-desc
    • JSON { "product_id": 123 } (только админ/редактор с правами)

Идеи для улучшения (опционально)

  • Embeddings / векторный поиск: вместо keyword/WP_Query хранить векторы (например в отдельной таблице или внешнем vector DB) и искать по cosine similarity.
  • Гибридный поиск: сперва embeddings → топ-50, затем LLM ранжирование top-20.
  • Автогенерация по cron: при добавлении новых товаров ставить в очередь генерацию описаний.