How to Use Action product search in Hermes
Find Action products and their listed prices in a selected market. Use it to discover candidates across the assortment before checking an exact article with Action product details.
Prompts to try with Action product search in Hermes
Copy an example into Hermes, or ask in your own words.
Each week, use Action product search for the Netherlands and tell me which returned lighting articles were absent from my previous personal shortlist.
Every Monday at 9am: use Action product search to look this up and give me the result as a table.
Pull the latest numbers from Action product search and tell me what changed since last week.
Check Action product search and summarize what you find in three bullet points.
Pull the newest data from Action product search and give me the result as a table.
How to set up Action product search in Hermes
Pick the way that suits you. Each takes about two minutes.
Use the Spiral skill
- Send Hermes 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
- Add the server and sign in
Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.
hermes mcp add spiral \ --url https://api.spiral.ai/mcp \ --auth oauth \ --connect-timeout 300
- Check it
In a chat that was already open, run /reload-mcp.
hermes mcp list hermes mcp test spiral
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 Action 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": "action-com/products/search", "input": { "query": "<query>" } }'
Then paste one of the prompts above: Hermes finds Action product search on Spiral, shows the price and runs it.
Action product search providers and prices
Spiral runs Action product search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Hermes for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Page | 1 to 50 | 1 | 1-based page; pass the previous |
| Country | nl-nl, nl-be, fr-be, de-de, de-at, de-ch, fr-ch, it-ch and 11 more | nl-nl | Action market as the storefront's locale path prefix (language-country): nl-nl, nl-be, fr-be, de-de, de-at, de-ch, fr-ch, it-ch, fr-fr, fr-lu, it-it, es-es, pt-pt, pl-pl, cs-cz, sk-sk, sl-si, hr-hr, ro-ro. Defaults to nl-nl (Netherlands). |
Every API field of Action · Search is on its tool page: open its card above.
What can you do with Action product search in Hermes?
Produce a personal Wednesday shopping brief from Action’s Dutch storefront. Compare returned articles with your earlier checks to highlight changes in the published assortment and promotions.
Plan a weekly shopping trip
Browse the assortment and current promotions, then inspect shortlisted articles before making a personal shopping list. Keep advertised offers separate from confirmed store availability.
Choose supplies for a craft project
Find candidate craft supplies, check whether any appear in weekly offers, and inspect the published dimensions and materials before choosing what fits the project.
Compare lighting for a room
Browse lighting products and weekly promotions, then compare published wattage, brightness, and fitting information for the shortlisted articles.
Prepare a seasonal decoration list
Review seasonal products and current promotions, then check sizes and materials against the space being decorated. Note when one article covers several colors or designs.
Compare household purchase candidates
Collect household items from the assortment and weekly offers, then compare exact article descriptions and published specifications in a personal buying shortlist.
Check an exact product before buying
Inspect the specifications and available EANs of a known Action article. Use product search to find other candidates if its published details do not meet your requirements.
More on Action product search and Hermes
Overview
Action product search in other agents
Questions about Action product search in Hermes
Can Hermes use Action product search?
Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run Action product search like any built-in tool.
How much does Action product search cost in Hermes?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Hermes plan is separate.
Do I need an Alexandria account to use Action product search in Hermes?
No. Spiral runs Action 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 Action product search in Hermes?
About two minutes: add the server and sign in, then check it.
Does Hermes wait while Action product search runs?
Action product search runs in the background. Hermes starts the run, checks on it and gives you the json when it's ready.
Where does the Action data come from?
The endpoints read Action’s public storefront pages. They cover published product information and promotions rather than private inventory records.
Does the website include everything sold in Action stores?
No. Action’s Dutch FAQ says a product missing from its website may still be available in one or more stores, so an empty result does not establish that Action no longer sells it.
How quickly does Action’s assortment change?
Action’s Dutch storefront says it adds 150 products each week. That is an assortment update schedule; it does not establish how quickly an endpoint reflects every website change.
When should I check for new Dutch weekly promotions?
Action announces Dutch weekly promotions on Wednesdays. A Wednesday check is a useful starting point for a weekly shopping shortlist.
Does a published offer guarantee availability?
No. Action’s Dutch leaflet explicitly limits offers to available supplies, so a promotion can still be advertised after an item sells out locally.
Start using Action product search in Hermes
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Hermes:
set up https://spiral.ai/SKILL.md


