How to Use WooCommerce product search in dots
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 dots
Copy an example into dots, or ask in your own words.
Each weekday, use WooCommerce product search for HP EliteDesk mini PCs on itman.ae and report newly observed listings and changes in advertised availability.
Each Friday, use WooCommerce product search for booking extensions on woocommerce.com and summarize changes in the returned products and descriptions since last week.
Every Monday at 9am: 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 dots
Pick the way that suits you. Each takes about two minutes.
Use the Spiral skill
- Send dots this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use Spiral's MCP server
- Create an API key
In the console, open API keys and create a key for your dot. Copy it.
- Send your dot this message
Your dot reads Spiral's skill and asks for your API key.
set up https://spiral.ai/SKILL.md
- Give your dot the key
When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- 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: dots 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.
Settings you can ask for
Ask dots for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Page | 1 to 10000 | 1 | 1-based page; use next_page from the previous result. |
| Order | asc or desc | order | |
| On sale | on or off | Only products on sale. | |
| Orderby | date, modified, id, title, slug, price, popularity, rating and 1 more | Sort key; the store's default (relevance for a query, else date) otherwise. | |
| Featured | on or off | Only featured products. | |
| Per page | 1 to 100 | 20 | per_page |
| Max price | a number from 0 | Maximum price in major units of the store currency. | |
| Min price | a 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 dots?
Get a recurring report of changes in a WooCommerce store's published catalog organization and product listings. Compare each run with previous observations to identify changed departments, attribute labels, descriptions, and availability.
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.
More on WooCommerce product search and dots
Overview
WooCommerce product search in other agents
Questions about WooCommerce product search in dots
Can dots use WooCommerce product search?
Yes. Add Spiral to dots as an MCP server, and dots can find and run WooCommerce product search like any built-in tool.
How much does WooCommerce product search cost in dots?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your dots plan is separate.
Do I need an Alexandria account to use WooCommerce product search in dots?
You need no Alexandria account. dots uses one Spiral API key for every tool, and Spiral runs WooCommerce product search on its own Alexandria account.
How long does it take to set up WooCommerce product search in dots?
About two minutes: create an API key, then send your dot this message, then give your dot the key.
Does dots wait while WooCommerce product search runs?
WooCommerce product search runs in the background. dots 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.
Start using WooCommerce product search in dots
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into dots:
set up https://spiral.ai/SKILL.md


