Athenian AI Repricing Agent
product details.
Athenian AI Repricing Agent finds external pricing signals, evaluates them with structured AI logic, and helps merchants decide when to adjust WooCommerce product prices. It helps teams monitor competitive context, protect margins, document pricing decisions, and feed smarter price updates into catalog workflows while keeping data, permissions, and automation aligned with the broader Athenian Platform…
Athenian AI Repricing Agent for WooCommerce is an evidence-driven pricing intelligence plugin that helps merchants evaluate whether product prices should be adjusted based on external market signals. It combines WooCommerce product context, mapped source URLs, Serper-powered search discovery, structured price extraction, offer normalization, cautious AI recommendations, persistent check history, and merchant-controlled price application.
Rather than acting as a blind automated repricer, AIRA is designed as a controlled decision-support layer. It gathers relevant pricing signals, filters noisy or misleading results, asks an AI pricing analyst workflow for a structured recommendation, and lets an authorized operator decide whether to apply the suggested price from the WooCommerce product editor.
For exact-match pricing workflows, products can be mapped to a specific external pricing source URL and optionally set to mapped-source-only mode. This allows teams to bypass broad search and AI ranking when a trusted competitor or reference source is already known.
Within the Athenian Platform, AI Repricing Agent fits as the pricing intelligence operator for WooCommerce catalog teams. It can use Athenian Secure API Key Manager for credentials, route recommendations through Athenian Platform Core AI when available, emit platform events, and preserve check evidence for future reporting, governance, and automation.
How Athenian AI Repricing Agent fits the Athenian Platform
Platform role: Athenian AI Repricing Agent is a focused capability in the AI, Automation & Intelligent Commerce and Storefront, Merchandising & Product Data layer. Its primary scope covers AI Pricing & Decisioning and Promotions & Pricing Programs while remaining composable with the other modules an implementation actually requires.
Connected scope: Athenian AI Repricing Agent is designed to work inside a WordPress and WooCommerce operating environment where storefront, customer, order, identity, payment, fulfillment, automation, and reporting context can remain connected across relevant modules instead of being trapped in isolated add-ons.
From module to operating platform: Athenian Brands organizes the ecosystem in four connected layers: Platform Kernel and Platform Core foundations; focused capability plugins; implementation and integration services; and operating brands such as PrintGhost.ai, Athenian Marketplace, Athenian Academy, and Athenian Unÿa that apply the same patterns to real business workflows.
Pricing Evidence Discovery
Collect External Pricing Signals Before Recommending a Product Price Change
Athenian AI Repricing Agent builds pricing checks from real WooCommerce
product context, searches external sources, extracts candidate offer prices,
normalizes evidence, and filters weak or noisy matches before asking AI
for a recommendation.
| Evidence Layer | Operational Value |
|---|---|
| Product Context | Builds pricing queries from product name, SKU, brand taxonomy, MPN, current price, regular price, sale price, currency, and permalink. |
| Search Discovery | Uses Serper-backed Google-style search to discover relevant external pricing pages for product-level comparison. |
| Price Extraction | Extracts candidate prices from Schema.org JSON-LD, itemprop metadata, Open Graph pricing, Shopify product JSON, and cautious fallback parsing. |
| Offer Filtering | Normalizes currency, deduplicates URLs, restricts low-confidence results, filters outliers, and avoids bundle or pack offers unless allowed. |
- Uses extraction methods such as
schema_jsonld,meta_itemprop_price,og_price_amount, andregex_dollar. - Supports Shopify-specific extraction through a product JSON adapter when available.
- Uses settings such as
search_max_urls,min_offer_confidence,offer_outlier_max_mult,offer_outlier_min_mult, andallow_bundle_offers. - Detects obvious bot-wall or captcha pages and avoids trusting bad extraction results.
Merchant-Controlled Repricing
Review Pricing Evidence and Apply Suggested Prices Only When Approved
AIRA gives WooCommerce operators a product-level repricing workspace with
mapped source fields, run-check actions, suggested price summaries, extracted
offer panels, AI reasoning, debug payloads, and gated apply controls.
Connect products to trusted external price-reference pages
Skip broad search and AI ranking for exact-source workflows
Store suggestions for review before authorized price updates
| Admin Surface | Operational Purpose |
|---|---|
| Product Pricing Fields | Adds source URL and mapped-source-only fields to WooCommerce product pricing settings. |
| AI Repricing Metabox | Runs checks and displays current price, suggested price, confidence, provider path, extracted offers, AI matches, search results, and debug JSON. |
| Product Row Action | Adds an AI Reprice Check action from the WooCommerce product list for quicker product-level checks. |
| Controlled Application | Applies a saved suggested price only through capability-gated and nonce-protected admin actions. |
- Stores mapped source fields in
_ath_aira_source_urland_ath_aira_source_only. - Stores last-check metadata such as
_ath_aira_last_check_id,_ath_aira_last_summary,_ath_aira_last_ai,_ath_aira_last_suggested_price, and_ath_aira_last_should_change. - Uses AJAX actions such as
ath_aira_check_productandath_aira_apply_suggested. - Requires
manage_woocommerceand nonce validation for check and apply workflows.
Pricing Intelligence
Use Structured AI Recommendations With Persistent Pricing Evidence
AIRA asks for conservative structured recommendations, stores repricing
checks and offer evidence in custom database tables, supports WP-CLI
operations, and can route credentials, AI calls, logs, and events through
Athenian Platform services when available.
| Intelligence Layer | How It Helps |
|---|---|
| Structured AI Contract | Requests should-change, suggested price, regular price, confidence, competitor summary, supporting matches, and reasoning as strict JSON. |
| Persistent Check History | Stores check records, AI JSON, signals, context, extracted offers, confidence values, source URLs, and related product IDs. |
| Platform AI Routing | Prefers Athenian Platform Core AI when enabled and falls back to direct OpenAI Responses API when platform routing is unavailable. |
| Ops & CLI Support | Provides WP-CLI commands for running checks and previewing search results outside the browser workflow. |
Evidence before automation:
AIRA is strongest as a disciplined repricing decision system. It helps teams
identify external signals, evaluate whether a price should change, preserve
supporting evidence, and apply updates deliberately instead of blindly
repricing products.
- Creates custom tables such as
ath_aira_checksandath_aira_offersfor persistent repricing history. - Uses options stored in
ath_aira_options, including AI model, platform AI preference, event emission, thresholds, timeout, Serper key, and apply behavior. - Supports WP-CLI commands such as
wp ath-aira check <product_id>andwp ath-aira search <product_id>. - Can retrieve credentials through Athenian Secure API Key Manager and emit platform actions such as
ath_aira/eventandathenian/repricing/event. - Builds toward bulk repricing queues, scheduled monitoring, visual template builders, margin guardrails, approval workflows, reporting dashboards, domain-specific adapters, and safe internal dashboard/API exposure.