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

Instinct · E-commerce

How to Use WooCommerce product search in Instinct

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 Instinct

Copy an example into Instinct, 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.

WooCommerce product searchInstinct
Try asking
  • 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 Instinct

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

Use the Spiral skill

  1. Send Instinct 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 Spiral's MCP server

  1. Create an API key

    In the console, open API keys and create a key for Instinct. Copy it.

  2. Send Instinct this message

    Instinct reads Spiral's skill and asks for your API key.

    set up https://spiral.ai/SKILL.md
  3. Give Instinct the key

    When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

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: Instinct 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 Instinct 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 Instinct?

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.

Questions about WooCommerce product search in Instinct

Can Instinct use WooCommerce product search?

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

How much does WooCommerce product search cost in Instinct?

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

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

You need no Alexandria account. Instinct 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 Instinct?

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

Does Instinct wait while WooCommerce product search runs?

WooCommerce product search runs in the background. Instinct 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 Instinct

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

Paste this into Instinct:

Set up Instinct

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