convez.ai
PluginAutomaçãoIntermediário
angeo-dev

AI Description Updater para Magento 2

angeo-dev/module-ai-description-updater

Descrições de produto em massa com IA — Groq grátis, 4 provedores, multi-loja

Ver no GitHub
InicialPluginScore · de 0 a 100

Módulo Magento 2 que gera e atualiza automaticamente descrições de produtos usando IA (OpenAI, Claude, Gemini ou Groq). Suporta execução via CLI, cron, painel admin, múltiplas lojas e integração com Google Sheets. Alternativa gratuita e open-source a extensões comerciais de $99-299/ano.

Instalação

$npx convez-ai angeo-dev/module-ai-description-updater

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
1
Acompanhando
0
Saúde
37%
Último commit
há 2 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Gerar descrições de produtos em bulk para lojas Magento 2
  • Atualizar conteúdo em múltiplas store views e idiomas simultaneamente
  • Automatizar com cron jobs ou CLI sem intervenção manual
  • Importar SKUs do Google Sheets e exportar descrições geradas
  • Usar IA gratuita (Groq) sem precisar de cartão de crédito

Veredito

Plugin robusto e bem-documentado que resolve um problema real em e-commerce Magento 2. Destaca-se pela suporte a Groq (gratuito), multi-loja nativa e integração Google Sheets. Excelente custo-benefício para quem já usa Magento.

README

A tradução para o português deste README ainda está na fila.

angeo/module-ai-description-updater

Packagist Version Packagist Downloads PHP Magento License: MIT

Automatically generate and update Magento 2 product descriptions across all store views using AI — via CLI, cron, or Admin Panel.

angeo/module-ai-description-updater is an open-source Magento 2 module for bulk AI-powered product description generation across multiple store views and languages. Supports OpenAI, Anthropic Claude, Google Gemini, and Groq (free, no credit card required). Results can be exported to Google Sheets automatically.


Table of contents


Why this module vs alternatives

FeatureThis moduleCommercial alternatives
CLI + Cron automation✓Rarely
Multi-store (all store views)✓Rarely
Groq — free tier, no card✓Nowhere
Google Sheets as SKU source✓Nowhere
Google Sheets export✓Nowhere
Dry-run mode✓Rarely
4 AI providers✓Usually 1
MIT license✓Rarely
PriceFree$99–$299/year

Supported AI providers

ProviderModelsCostNotes
OpenAIgpt-4.1, gpt-4.1-mini, gpt-4.1-nano, gpt-4oPaidBest quality/cost: gpt-4.1-mini
Anthropic Claudeclaude-sonnet-4-6, claude-opus-4-6, claude-haiku-4-5PaidExtended thinking supported
Google Geminigemini-2.5-flash-preview, gemini-2.0-flash, gemini-2.0-flash-liteFree tier + paidFree tier has daily limits
Groqllama-3.3-70b-versatile, llama-3.1-8b-instant, mixtral-8x7bFree14,400 req/day, no credit card

Requirements

  • PHP 8.2+
  • Magento 2.4.x / Adobe Commerce / Mage-OS
  • ext-curl, ext-openssl

Installation

composer require angeo/module-ai-description-updater
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Quick start — Groq (free, 5 minutes)

The fastest way to get started — Groq is free with no credit card required.

Step 1 — Get a free API key

Go to console.groq.com, create an account, go to API Keys → Create API key. The key starts with gsk_.

Step 2 — Configure Magento

Go to Stores → Configuration → Angeo AEO → AI Description Updater:

  1. General → Enable Module → Yes
  2. General → Dry Run Mode → Yes (safe for first test)
  3. AI Provider → AI Provider → Groq (Free — Llama / Mixtral)
  4. Groq Settings → Groq API Key → paste your gsk_... key
  5. Groq Settings → Model → Llama 3.3 70B Versatile (recommended)
  6. Attributes → Generate Description → Yes
  7. Click Save Config

Step 3 — Test with dry-run

bin/magento angeo:ai-description:run --dry-run

Check var/log/angeo_ai_description_updater.log to preview what would be generated.

Step 4 — Run on a single product first

Disable Dry Run in admin, then:

bin/magento angeo:ai-description:run --sku=YOUR-TEST-SKU

Verify the result in the product edit page. If it looks good, run the full batch:

bin/magento angeo:ai-description:run

Full configuration reference

Path: Stores → Configuration → Angeo AEO → AI Description Updater


General

FieldDefaultDescription
Enable ModuleNoMaster on/off switch
Dry Run ModeYesGenerate but do not save to Magento. Always test with this enabled first.
Enable Detailed LoggingYesWrites to var/log/angeo_ai_description_updater.log
Batch Size50Max products processed per run or cron execution

AI Provider

FieldDefaultDescription
AI ProviderOpenAISelect one of: OpenAI (ChatGPT), Anthropic (Claude), Google (Gemini), Groq (Free)

Only the selected provider's settings section is used. Switch providers at any time.


OpenAI settings

Used when AI Provider is set to OpenAI.

FieldDefaultDescription
OpenAI API Key—Starts with sk-. Stored encrypted.
GPT Modelgpt-4.1gpt-4.1-mini is the best quality/cost balance.
Temperature0.70.0 = deterministic, 2.0 = very creative. 0.7 recommended for product copy.
Max Tokens800Maximum length of generated response.
Request Timeout (s)30HTTP timeout. Increase if you get timeout errors.

Claude settings

Used when AI Provider is set to Anthropic Claude.

FieldDefaultDescription
Claude API Key—Starts with sk-ant-. Stored encrypted.
Claude Modelclaude-sonnet-4-6claude-haiku-4-5 is fastest and cheapest. claude-opus-4-6 is highest quality.
Max Output Tokens1024Maximum response length.
Request Timeout (s)60Extended thinking may need more — increase to 120 if needed.
Enable Extended ThinkingNoLets Claude reason before writing. Higher quality, more tokens. Claude 4.x only.
Thinking Token Budget2048Minimum 1024. Internal reasoning tokens — billed as output tokens.

Gemini settings

Used when AI Provider is set to Google Gemini.

FieldDefaultDescription
Gemini API Key—Stored encrypted.
Gemini Modelgemini-2.5-flash-preview-05-20gemini-2.0-flash is fast with a free tier.
Temperature0.70.0–2.0.
Max Output Tokens1024Gemini 2.x supports up to 8192.
Request Timeout (s)30

Note: If you get limit: 0 errors, create a new Google Cloud project and generate a fresh API key.


Groq settings

Used when AI Provider is set to Groq.

FieldDefaultDescription
Groq API Key—Starts with gsk_. Stored encrypted. No credit card required.
Modelllama-3.3-70b-versatilellama-3.3-70b-versatile gives the best quality. llama-3.1-8b-instant is fastest.
Temperature0.7
Max Output Tokens1024
Request Timeout (s)30

Free tier: 30 requests/minute, 14,400 requests/day.


Prompt

FieldDefaultDescription
System Role"You are a professional product copywriter..."The AI model's persona and instructions.
Prompt Template(see config)Supports: {{product_name}}, {{product_sku}}, {{store_name}}
LanguageenTarget language. Set per store view for multi-language stores.
Include SEO KeywordsYesAppends SEO keyword optimisation instruction to the prompt.

Example prompt template:

Write a professional and SEO-friendly product description for "{{product_name}}"
(SKU: {{product_sku}}) for our {{store_name}} online store.
Include key benefits, features, and use cases.
Format using HTML paragraphs. Keep it between 150 and 250 words.

Attributes

FieldDefaultDescription
Generate DescriptionYesUpdates the main description attribute (HTML)
Generate Short DescriptionYesUpdates short_description
Short Description Max Length150Character limit for short description
Generate Meta TitleNoUpdates meta_title
Generate Meta KeywordsNoUpdates meta_keyword
Generate Meta DescriptionNoUpdates meta_description

Tip: Enable meta attributes only after validating description quality. Test with --dry-run first.


Google Sheets — SKU source

Use a Google Spreadsheet as the source of SKUs to process instead of all active products.

FieldDefaultDescription
EnableNoRead SKU list from a Google Spreadsheet
Spreadsheet ID—From the URL: /spreadsheets/d/[SPREADSHEET_ID]/edit
Sheet GID0Tab ID from URL ?gid=.... Default 0 = first tab.
SKU Column Index0Zero-based: 0 = column A, 1 = column B, etc.

No Service Account required — the spreadsheet must be set to "Anyone with the link can view".

See Google Sheets SKU source setup for step-by-step instructions.


Google Sheets — export

Write generated descriptions back to a Google Spreadsheet after each run.

FieldDefaultDescription
EnableNoExport results to Google Sheets
Service Account JSON—Full JSON key from Google Cloud Console. Stored encrypted.
Spreadsheet ID—Target spreadsheet. Must be shared with the Service Account client_email.
Sheet Tab NameSheet1Tab to write to.
Clear Sheet Before WriteNoYes = overwrite all rows. No = append new rows.

See Google Sheets export setup for step-by-step instructions.


Export / CSV

FieldDefaultDescription
Save CSV ReportYesSave results to var/angeo/ai_description_updater/
CSV Filename Patternai_descriptions_{{date}}.csvSupports {{date}} placeholder

Cron

FieldDefaultDescription
Enable CronNoEnable automatic scheduled runs
Schedule0 2 * * *Standard cron expression. Default: daily at 2:00 AM.

CLI usage

# Run for all active store views
bin/magento angeo:ai-description:run

# Single SKU across all stores
bin/magento angeo:ai-description:run --sku=MY-SKU-001

# Single store view only
bin/magento angeo:ai-description:run --store=2

# Dry-run — generate but do not save
bin/magento angeo:ai-description:run --dry-run

# Combine options
bin/magento angeo:ai-description:run --sku=MY-SKU --store=2 --dry-run
OptionDescription
--sku=VALUEProcess a single SKU only. Bypasses batch size limit.
--store=VALUEProcess a single Magento store ID. Default: all active stores.
--dry-runGenerate but do not save. Overrides config setting.

Multi-store behaviour

When run without --store, the module processes every active non-admin store view sequentially.

For each store view:

  • Product is loaded in that store's scope
  • {{store_name}} in the prompt is replaced with the store view name
  • Generated content is saved in that store's scope — not the global default scope
# List your store IDs
bin/magento store:list

# Run for a specific store only
bin/magento angeo:ai-description:run --store=3

Setup guides

OpenAI API key

  1. Go to platform.openai.com → sign in or create account
  2. Click your profile → API keys → Create new secret key
  3. Copy the key — shown only once (starts with sk-)
  4. In Magento: Stores → Configuration → Angeo AEO → AI Description Updater → OpenAI Settings → API Key

Add a payment method at platform.openai.com/account/billing for production use.


Anthropic Claude API key

  1. Go to console.anthropic.com → create account
  2. API Keys → Create Key
  3. Copy the key (starts with sk-ant-)
  4. In Magento: ... → Claude Settings → API Key

Google Gemini API key

  1. Go to aistudio.google.com/app/apikey
  2. Click Create API key in new project
  3. Copy the key
  4. In Magento: ... → Gemini Settings → API Key

If you get limit: 0 errors: create a new Google Cloud project and generate a new key there.


Groq API key (free)

  1. Go to console.groq.com → create account — no credit card required
  2. API Keys → Create API key
  3. Copy the key (starts with gsk_)
  4. In Magento: ... → Groq Settings → API Key

Free tier: 30 requests/minute, 14,400 requests/day.


Google Sheets — SKU source setup

Step 1 — Create the spreadsheet

Create a new spreadsheet at sheets.google.com. Add SKUs in column A, one per row:

SKU
MY-SKU-001
MY-SKU-002
MY-SKU-003

Step 2 — Make it publicly readable

Share → Change to anyone with the link → Viewer → Done

Step 3 — Get the Spreadsheet ID

Copy the ID from the URL:

https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms/edit
                                       ↑ this is the Spreadsheet ID

Step 4 — Configure in Magento

  • Enable → Yes
  • Spreadsheet ID → paste ID
  • Sheet GID → 0 (first tab) or ?gid= value from URL for other tabs
  • SKU Column Index → 0 for column A

Google Sheets — export setup (Service Account)

Step 1 — Create a Google Cloud project

Go to console.cloud.google.com:

  1. Click the project dropdown (top left) → New Project
  2. Name it (e.g. angeo-sheets) → Create

Step 2 — Enable Google Sheets API

Left menu → APIs & Services → Library → search Google Sheets API → Enable

Step 3 — Create a Service Account

Left menu → IAM & Admin → Service Accounts → Create Service Account:

  1. Choose Application data when asked what data you will access
  2. Service account name: angeo-ai-updater
  3. Click Create and Continue → skip optional role → Done

Step 4 — Generate a JSON key

Click the service account → Keys tab → Add Key → Create new key → JSON → Create

A JSON file downloads automatically. It looks like this:

{
  "type": "service_account",
  "project_id": "angeo-sheets",
  "client_email": "angeo-ai-updater@angeo-sheets.iam.gserviceaccount.com",
  "private_key": "-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----\n",
  "token_uri": "https://oauth2.googleapis.com/token"
}

Copy the client_email value — you need it in the next step.

Step 5 — Share the spreadsheet with the Service Account

  1. Create a new spreadsheet at sheets.google.com
  2. Click Share
  3. Paste the client_email from the JSON (e.g. angeo-ai-updater@angeo-sheets.iam.gserviceaccount.com)
  4. Set role to Editor
  5. Click Send

Step 6 — Configure in Magento

Go to Stores → Configuration → Angeo AEO → AI Description Updater → Google Sheets Export:

  1. Enable → Yes
  2. Service Account JSON → paste the entire contents of the downloaded JSON file
  3. Spreadsheet ID → copy from the spreadsheet URL
  4. Sheet Tab Name → Sheet1 (or your tab name)
  5. Clear Sheet Before Write → Yes to overwrite, No to append
  6. Save Config

Verify:

bin/magento angeo:ai-description:run --sku=ONE-SKU --dry-run

Dry-run does not export. Disable dry-run and run again — a row should appear in the spreadsheet.


Log file

# Watch in real time
tail -f var/log/angeo_ai_description_updater.log

# Last 50 lines
tail -50 var/log/angeo_ai_description_updater.log

Log entries include: run start/complete, per-SKU status (updated / dry_run / error), AI API errors, Google Sheets export result.


Related modules

ModulePurpose
angeo/module-aeo-audit8-signal CLI audit — checks ChatGPT, Gemini and Perplexity visibility
angeo/module-llms-txtAuto-generates llms.txt and llms.jsonl from Magento catalogue
angeo/module-rich-dataInjects Product, Organization, FAQPage JSON-LD schema
angeo/module-openai-product-feedChatGPT Shopping product feed generator
angeo/module-aeo-brand-visibilityLive brand visibility audit across ChatGPT, Gemini, Perplexity

License

MIT — free to use, modify, and distribute.


Author

Ievgenii Gryshkun · angeo.dev · info@angeo.dev

Ver o original no GitHub

Bom para

Relacionados