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

Codex · E-commerce

How to Use DealNews store search in Codex

Returns matching retailers from DealNews's store directory. Use it to identify the right store before looking for that retailer's deals or coupons.

Prompts to try with DealNews store search in Codex

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

Use DealNews store search to find Best Buy and REI, then add the returned retailer matches to this project's store selector.

DealNews store searchCodex
Try asking
  • Use DealNews store search to look this up and give me the result as a table. Save the result in ./assets.

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

  • Check DealNews store search and summarize what you find in three bullet points.

  • Pull the newest data from DealNews store search and give me the result as a table.

How to set up DealNews store search in Codex

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

Use Spiral's MCP server

  1. Add the hosted server
    codex mcp add spiral --url https://api.spiral.ai/mcp
  2. Sign in

    Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.

    codex mcp login spiral

Use the Spiral skill

  1. Send Codex 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 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 DealNews store 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": "dealnews-com/deals/find_stores",
        "input": {
          "query": "<query>"
        }
      }'

Then paste one of the prompts above: Codex finds DealNews store search on Spiral, shows the price and runs it.

DealNews store search providers and prices

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

AlexandriaE-commerce
DealNews · Find stores
dealnews-com/deals/find_stores

Settings you can ask for

Ask Codex for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Limit1 to 5010

limit

Every API field of DealNews · Find stores is on its tool page: open its card above.

What can you do with DealNews store search in Codex?

Build a shopping shortlist that connects DealNews retailer names with offers and coupon details. A coding agent can add retailer matching, product discovery, and individual offer inspection to your project's shopping workflow.

Compare offers at preferred retailers

Resolve Amazon, Best Buy, and Walmart in the store directory, compare their listed deals and coupons, and inspect the offer conditions before choosing where to shop.

Plan holiday gift purchases

Use popular offers for gift ideas, search for specific LEGO sets, and identify the retailers carrying relevant promotions. Compare store deals and coupons, then inspect the selected offers for codes and expiration dates.

Prepare an office equipment shortlist

Find monitor and keyboard offers through keyword searches and recent listings. Match preferred retailers, review their deals and coupons, and read the selected offers before preparing an equipment purchase recommendation.

Compare household restocking options

Search for dishwasher tablets and paper towels, resolve Target and Walmart, and compare their listed offers and coupons. Read the selected deal pages to distinguish a product discount from a broader promotion.

Maintain a preferred-store watchlist

Resolve REI, Lowe's, and Best Buy to their DealNews listings. Revisit their deal and coupon listings to spot newly returned promotions relevant to planned purchases.

Shop for a weekend project

Browse recent tool offers and search for a DeWalt drill, then match the retailers selling relevant promotions. Compare retailer deals and coupons and inspect the final candidates for published offer requirements.

Questions about DealNews store search in Codex

Can Codex use DealNews store search?

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run DealNews store search like any built-in tool.

How much does DealNews store search cost in Codex?

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

Do I need an Alexandria account to use DealNews store search in Codex?

No. Spiral runs DealNews store 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 DealNews store search in Codex?

About two minutes: add the hosted server, then sign in.

Does Codex wait while DealNews store search runs?

DealNews store search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

Does DealNews cover every product sold by a retailer?

DealNews provides selected offers and coupon listings rather than a retailer's full product inventory. The documented store lookup covers roughly 10,000 stores; that directory size does not promise an active offer for every store.

How fresh are DealNews listings and popularity rankings?

DealNews says its writers work around the clock, seven days a week. Its popularity measure is recalculated every 15 minutes based on reader interest.

Are published deals verified?

DealNews says its in-house team manually vets every deal. Offers can still expire within hours of publication, so a published listing does not guarantee the offer remains available.

How far back can I browse expired deals?

DealNews's FAQ describes a three-month browsing window on its website. That statement applies to website browsing and does not establish a history guarantee for these endpoints.

Which market does DealNews cover?

DealNews describes its app's coverage as more than 6,000 online stores in the United States. These listings should not be treated as a worldwide retailer catalog.

Get started

Start using DealNews store search in Codex

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

Paste this into Codex:

Set up Codex

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