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

Hermes · E-commerce

How to Use Woot offer search in Hermes

Find Woot offers by product or brand keyword with condition, availability, Amazon ratings, and end times. Use it when you know what you want, such as Sony headphones or Dyson vacuums.

Prompts to try with Woot offer search in Hermes

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

Each day, use Woot offer search to check for available Sony headphones and tell me which matches were absent from the previous check, under the applicable collection permissions.

Woot offer searchHermes
Try asking
  • Each morning, use Woot offer search to find Dyson vacuum offers and highlight those ending before tomorrow's check, under the applicable collection permissions.

  • Every Monday at 9am: use Woot offer search to look this up and give me the result as a table.

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

  • Check Woot offer search and summarize what you find in three bullet points.

How to set up Woot offer search in Hermes

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

Use the Spiral skill

  1. Send Hermes 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. 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
  2. Check it

    In a chat that was already open, run /reload-mcp.

    hermes mcp list
    hermes mcp test spiral

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 Woot offer 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": "woot-com/deals/search_offers",
        "input": {
          "query": "<query>"
        }
      }'

Then paste one of the prompts above: Hermes finds Woot offer search on Spiral, shows the price and runs it.

Woot offer search providers and prices

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

AlexandriaE-commerce
Woot · Search offers
woot-com/deals/search_offers

Settings you can ask for

Ask Hermes for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Page1 to 1001

Page number, 24 offers per page.

Sortbest_selling, newest, discount, price_low_to_high, or price_high_to_lowbest_selling

sort

Categoryall, electronics, computers, home, sport, tools, grocery, shirt and 1 more

Limit to one Woot category; default all.

In stock onlyon or off

Drop sold-out offers (default true).

Every API field of Woot · Search offers is on its tool page: open its card above.

What can you do with Woot offer search in Hermes?

Prepare a recurring personal Woot brief covering featured offers and wanted brands, subject to the applicable collection permissions. Compare returned condition, availability, and end times to highlight changes between checks.

Prepare a personal daily shopping brief

Review Woot's featured deals, browse categories, and search for wanted brands. Inspect promising offers before adding them to a personal shortlist.

Compare headphone options

Look for Sony headphones in featured deals, category results, or keyword matches. Compare condition and Amazon ratings, then inspect product choices and specifications.

Plan a household replacement purchase

Find vacuum offers through today's highlights, browsing, or a Dyson search. Check condition, availability, and the detailed listing before replacing an appliance.

Build a holiday gift shortlist

Collect gift ideas from Woot's featured deals, category offers, and brand searches. Inspect each candidate's product choices and shipping information.

Prioritize offers nearing their end

Compare the reported end times of offers found through daily highlights, browsing, or search. Inspect the selected listing's availability before deciding.

Check specifications before choosing a laptop

Find Lenovo laptop candidates through browsing or search, then inspect their specifications and condition to decide which matches your requirements.

Questions about Woot offer search in Hermes

Can Hermes use Woot offer search?

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run Woot offer search like any built-in tool.

How much does Woot offer 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 Woot offer search in Hermes?

No. Spiral runs Woot offer 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 Woot offer search in Hermes?

About two minutes: add the server and sign in, then check it.

Does Hermes wait while Woot offer search runs?

Woot offer search runs in the background. Hermes starts the run, checks on it and gives you the json when it's ready.

Does the daily selection include every Woot offer?

The daily selection covers today's featured deal on each Woot site. Keyword searches and category browsing provide separate ways to explore offers.

How long does a featured daily deal remain available?

Woot says the featured daily deal lasts until midnight Central time or until it sells out, whichever happens first.

Where do the product ratings come from?

The documented offer data identifies the ratings as Amazon ratings. They should be labeled as Amazon ratings when comparing Woot offers.

Are Woot offers available for international delivery?

Woot's shipping announcement says categories outside Shirt.Woot ship only to the 48 contiguous US states. Shirt.Woot apparel is the stated exception for international shipping.

Do public Woot listings come with unrestricted reuse rights?

Woot's standard license excludes commercial use and resale of its content, along with data mining, robots, and similar extraction tools. Public visibility does not establish permission to republish a catalog or operate a monitoring service.

Get started

Start using Woot offer search in Hermes

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

Paste this into Hermes:

Set up Hermes

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