How to Use WooCommerce product search in Gemini CLI
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 Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
Use WooCommerce product search to find HP EliteDesk mini PCs on itman.ae and populate this project's comparison table with the returned names, advertised prices, currency, and availability.
Use WooCommerce product search to find booking extensions on woocommerce.com and draft product cards in this project's existing format with returned descriptions and product links.
Use WooCommerce product search to look this up and give me the result as a table. Save the result in ./assets.
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 Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI 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 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: Gemini CLI 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 Gemini CLI 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 Gemini CLI?
Build a WooCommerce catalog browser with product records, category navigation, and attribute labels from a real store. Use the returned catalog structure to populate the project's browsing and comparison components.
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 Gemini CLI
Overview
WooCommerce product search in other agents
Questions about WooCommerce product search in Gemini CLI
Can Gemini CLI use WooCommerce product search?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run WooCommerce product search like any built-in tool.
How much does WooCommerce product search cost in Gemini CLI?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.
Do I need an Alexandria account to use WooCommerce product search in Gemini CLI?
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 Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while WooCommerce product search runs?
WooCommerce product search runs in the background. Gemini CLI 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 Gemini CLI
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini CLI:
set up https://spiral.ai/SKILL.md


