AgenticFuel for WooCommerce shows how AI shopping assistants see your catalog, helps you fix the product data they rely on, and measures how often their answers name your store. This guide covers installation, the first run, and the questions merchants ask most.
- WordPress 6.5 or later, WooCommerce 8.0 or later, and PHP 7.4 or later.
- An API key from at least one AI provider: OpenAI, Anthropic, Google, xAI, or Perplexity. The extension does not include a shared key; calls are made with your key and billed by the provider.
- Outbound HTTPS from your server to the AI providers you use and to the AgenticFuel taxonomy service (taxonomy-service.copycon.app).
- A writable uploads folder, used for the product feed file. Everything else works without it.
- Download the extension from your WooCommerce.com account (My Account → Downloads).
- In WordPress, go to Plugins → Add New Plugin → Upload Plugin, choose the downloaded zip file, and click Install Now.
- Click Activate. The extension creates its own database tables on activation.
- Open WooCommerce → AgenticFuel. The tabs at the top of every AgenticFuel page lead to Usage Log, Settings, Language, and Help.
- Add an API key. Go to AgenticFuel → Settings → API keys, paste a key for at least one provider, and save. The status next to the key shows whether the provider accepted it.
- Set a budget. In Settings → Monthly AI budget, enter the most you want to spend per month. Every AI call is checked against it before it is made. You can also cap each provider separately.
- Choose models. Pick a quality preset to apply the recommended model to every task, or choose a provider and model per task with My own keys and routing. The settings show the estimated cost per enriched product.
- Run the catalog scan. Open AI Actions → Catalog Scan and click Run Scan. The scan runs in the background; you can leave the page.
- Enrich products. Open AI Enrichment, start enrichment for the products that need it, then review each suggestion and apply it. Nothing is written to a product until you apply it.
- Turn on visibility tracking (optional). Open AI Visibility and click Enable AI Visibility to start the setup. Measurements ask AI assistants about your store, so this step makes sense once the store is live.
- Publish the product feed (optional). Open Export to LLM, click Turn on, and choose how often the store is checked for changes.
The product taxonomy used by enrichment downloads automatically a minute after activation. Its status is shown in
Settings → Product taxonomy. No account or token is needed.
- AI Actions — the hub that opens every module, with a status on each card.
- Catalog Scan — a store-wide score and the gaps found on each product.
- AI Enrichment — batch enrichment, suggestion review next to the current values, Apply, and rollback.
- AI Visibility — the six-part readiness score, share of model, tracked products, queries, knowledge graph, and AI bot access (robots.txt).
- Competitor Radar — competitors, queries, share of voice, trends, and decay alerts.
- Knowledge Base — organization profile, brands, store FAQ, product Q&A, policies, and llms.txt.
- Export to LLM — the product feed in the OpenAI product feed format, its schedule, and the products left out with the reason.
- UCP Readiness — what agent commerce protocols ask of a store.
- Usage Log — every AI call with its cost, broken down by operation, product, provider, and model, with CSV export.
- Settings and Language — API keys, budget, models, taxonomy, and the interface language for your user.
Update from
Plugins or
Dashboard → Updates like any extension from WooCommerce.com. Database changes run automatically on the first page load after the update. Your settings, scans, suggestions, and measurements are kept.
Deactivate the extension, then delete it from
Plugins. Deleting removes all AgenticFuel database tables and settings. Changes you applied to products stay in your products. The feed file in the
agenticfuel folder inside your uploads folder is left for you to remove.
Yes. The extension calls the provider directly with your key, the provider bills you, and the Usage Log shows every call with its price.
It depends on your catalog size and the models you choose. Settings shows the estimated cost per enriched product for each preset, and the monthly budget stops calls when it is reached.
No. Suggestions are stored separately and written to a product only when you apply them. Every applied change keeps a snapshot, so you can roll it back.
The catalog scan, enrichment, knowledge base, structured data, and feed work on a private or staging store. Visibility measurement and Competitor Radar ask AI assistants about your brand, so their results are meaningful only for a live store.
Once you turn the feed on, Export to LLM shows its address. The file name contains a random token that keeps the address private; share it only with the platform that reads it. While the feed is off, nothing is built or published.
English, German, Spanish, Italian, Portuguese, Ukrainian, and Russian. Each user picks a language on the Language tab; it does not change your store’s language.
The provider refused the key or the account has no balance. Check the key and the billing status in your provider account, then save the key again.
Background jobs run through Action Scheduler. Open
WooCommerce → Status → Scheduled Actions and search for
agfuel to see whether the jobs are pending or failed. On sites where WP-Cron is disabled, make sure a server cron job calls it.
Check that your server can reach taxonomy-service.copycon.app over HTTPS. While the taxonomy is empty, a failed sync retries automatically every 15 minutes, so it fills in once the connection works. If it stays empty, contact support.
The monthly budget or a provider cap was reached. Open
Usage Log to see this month’s spending, and raise the limit in Settings if needed.
Open a ticket from your WooCommerce.com account under
Support. Include your WordPress, WooCommerce, and PHP versions, the AgenticFuel version, and, for AI errors, the matching entry from the Usage Log.
