Spiral gives your agent every tool with one account. Browse the tools →

Perplexity · E-commerce

How to Use WooCommerce product search in Perplexity

Returns matching products from one store's catalog, including advertised prices and stock information. Use it to build a shortlist before inspecting individual products.

Prompts to try with WooCommerce product search in Perplexity

Copy an example into Perplexity, or ask in your own words.

Use WooCommerce product search to find HP EliteDesk mini PCs on itman.ae and compare the returned listings by advertised price and availability.

WooCommerce product searchPerplexity
Try asking
  • Use WooCommerce product search to find booking extensions on woocommerce.com and make a shortlist with names, published descriptions, and product links.

  • Use WooCommerce product search to look this up and give me the result as a table.

  • Pull the latest numbers from WooCommerce product search and tell me what changed since last week.

  • Check WooCommerce product search and summarize what you find in three bullet points.

How to set up WooCommerce product search in Perplexity

Pick the way that suits you. Each takes about two minutes.

Use the Perplexity connector

  1. Add a remote connector

    In Perplexity, open Plugins in the sidebar (or Customize › Connectors if you don't see Plugins yet). Choose Add custom › Add MCP connector, then Remote. Name it Spiral and paste this MCP server URL:

    https://api.spiral.ai/mcp
  2. Sign in to Spiral and approve

    Select the Spiral card on the Plugins page to start sign-in. Spiral opens: sign in, pick the organization and click Authorize. No API key.

Use the Spiral skill

  1. Send Perplexity this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run WooCommerce product search

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "alexandria",
        "model": "woocommerce-com/products/search_products",
        "input": {
          "store": "<store>"
        }
      }'

Then paste one of the prompts above: Perplexity finds WooCommerce product search on Spiral, shows the price and runs it.

WooCommerce product search providers and prices

Spiral runs WooCommerce product search through Alexandria. Open a card for today's price, with every fee included.

AlexandriaE-commerce
WooCommerce stores · Search products
woocommerce-com/products/search_products

Settings you can ask for

Ask Perplexity for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Page1 to 100001

1-based page; use next_page from the previous result.

Orderasc or desc

order

On saleon or off

Only products on sale.

Orderbydate, modified, id, title, slug, price, popularity, rating and 1 more

Sort key; the store's default (relevance for a query, else date) otherwise.

Featuredon or off

Only featured products.

Per page1 to 10020

per_page

Max pricea number from 0

Maximum price in major units of the store currency.

Min pricea number from 0

Minimum price in major units of the store currency (e.g. 19.99).

Every API field of WooCommerce stores · Search products is on its tool page: open its card above.

What can you do with WooCommerce product search in Perplexity?

Create a buying brief that connects a WooCommerce store's departments and product characteristics to specific listings. Explain the store's terminology and compare shortlisted products using its published catalog data.

Build a buying shortlist

Browse a store's departments, identify useful attribute labels, find matching products, and inspect the shortlisted items before recommending a purchase.

Design product comparison filters

Use the store's attribute vocabulary and matching product records to decide which characteristics belong in a comparison table. Inspect individual products to check how those characteristics are populated.

Audit category navigation

Map category parent relationships, inspect products assigned to each department, and identify confusing labels or misplaced items for a merchant's review.

Prepare a public catalog migration

Inventory published products, category relationships, and attribute vocabulary. Inspect representative product records to plan how public catalog content should map into the destination system.

Research a competitor's assortment

Compare departments, product characteristics, and matching listings in a public business catalog. Inspect selected products to explain differences in advertised features and availability.

Create a shopping support reference

Organize published product descriptions by department and attribute, then attach matching product links so support staff can answer catalog questions with specific examples.

Review product listing content

Find products in a department and inspect their descriptions, images, and category assignments. Prepare a merchant review list of listings with thin descriptions or confusing organization.

Report catalog organization changes

Compare successive observations of categories, attribute labels, and product records. Summarize renamed departments, new product characteristics, and changed assignments with example product links.

Questions about WooCommerce product search in Perplexity

Can Perplexity use WooCommerce product search?

Yes. Add Spiral to Perplexity as an MCP server, and Perplexity can find and run WooCommerce product search like any built-in tool.

How much does WooCommerce product search cost in Perplexity?

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Perplexity plan is separate.

Do I need an Alexandria account to use WooCommerce product search in Perplexity?

No. Spiral runs WooCommerce product search on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up WooCommerce product search in Perplexity?

About two minutes: add a remote connector, then sign in to Spiral and approve.

Does Perplexity wait while WooCommerce product search runs?

WooCommerce product search runs in the background. Perplexity starts the run, checks on it and gives you the json when it's ready.

Which stores does the data cover?

The data comes from individual WooCommerce storefronts through their public Store API. Each query describes the selected store's own catalog.

Does the catalog include unpublished products?

Only published products are accessible through the Store API. Draft, pending, and other unpublished products are excluded from product collections.

Why might a published product have an empty description?

Password-protected products remain visible, but their descriptions and short descriptions are blank until the correct password has been submitted. Their prices, images, and categories can still be available.

How many catalog records can WooCommerce return per page?

WooCommerce documents a maximum of 100 items per page for paginated Store API collections. Larger catalogs require multiple pages.

How are categories different from attributes?

Categories describe departments and include parent relationships and product counts. Attributes describe product characteristics, such as Color or Size, while terms represent values such as Large.

Get started

Start using WooCommerce product search in Perplexity

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Perplexity:

Set up Perplexity

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options