[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [CouponFollow category coupons](https://spiral.ai/integrations/codex/couponfollow-category-coupons)

# How to Use CouponFollow category coupons in Codex

Fetch CouponFollow offers across stores in a shopping category. Use it to compare retailers for electronics, clothing, or another planned purchase before choosing a store.

|  |  |
| --- | --- |
| Model | CouponFollow category coupons |
| Available through | Alexandria |
| Category | E-commerce |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with CouponFollow category coupons in Codex

- Use CouponFollow category coupons for Tech & Electronics and build a view in my permitted-use project that groups returned offers by retailer.
- Use CouponFollow category coupons for Clothing & Accessories and add a description filter to my permitted-use project so I can find product-specific offers.
- Use CouponFollow category coupons to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from CouponFollow category coupons and tell me what changed since last week.
- Check CouponFollow category coupons and summarize what you find in three bullet points.

## How to set up CouponFollow category coupons in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
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.

```bash
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.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run CouponFollow category coupons**: One request; the result comes back by polling or a webhook.

```bash
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": "couponfollow-com/coupons/list_category_coupons",
    "input": {
      "category": "<category>"
    }
  }'
```

Then paste one of the prompts above: Codex finds CouponFollow category coupons on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## CouponFollow category coupons tools and prices

- [CouponFollow · List category coupons](https://spiral.ai/tools/alexandria/couponfollow-com/coupons/list_category_coupons) (Alexandria): $0.00873 per call.

## What can you do with CouponFollow category coupons in Codex?

Build a shopping comparison view that keeps CouponFollow discounts beside their product restrictions. With permission to reuse the data, a coding agent can fit the returned offers into your project's existing components.

### Choose a coupon to try

Shortlist offers for a planned purchase by comparing the advertised discount and applicable products before trying a code at checkout.

### Find another retailer

Compare promotions from retailers selling similar goods. Check named stores directly, browse a shopping category, or review relevant retailers appearing in trending offers.

### Check product exclusions

Separate offers covering a whole order from promotions limited to selected products, such as laptop bags or specific electronics.

### Check introductory offers

Review offer descriptions for new-customer and country restrictions before including a promotion in a personal shopping shortlist.

### Plan gift shopping

Find promotions at a gift recipient's preferred store, compare stores in a suitable category, or use trending offers for gift ideas.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Codex guides](https://spiral.ai/integrations/codex)

## CouponFollow category coupons in other agents

- [Amp](https://spiral.ai/integrations/amp/couponfollow-category-coupons)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/couponfollow-category-coupons)
- [Claude](https://spiral.ai/integrations/claude-desktop/couponfollow-category-coupons)
- [Claude Code](https://spiral.ai/integrations/claude-code/couponfollow-category-coupons)
- [Cline](https://spiral.ai/integrations/cline/couponfollow-category-coupons)
- [Cursor](https://spiral.ai/integrations/cursor/couponfollow-category-coupons)
- [Devin](https://spiral.ai/integrations/devin/couponfollow-category-coupons)
- [dots](https://spiral.ai/integrations/dots/couponfollow-category-coupons)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/couponfollow-category-coupons)
- [Gemini](https://spiral.ai/integrations/gemini/couponfollow-category-coupons)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/couponfollow-category-coupons)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/couponfollow-category-coupons)
- [goose](https://spiral.ai/integrations/goose/couponfollow-category-coupons)
- [Grok](https://spiral.ai/integrations/grok/couponfollow-category-coupons)
- [Grok Build](https://spiral.ai/integrations/grok-build/couponfollow-category-coupons)
- [Hermes](https://spiral.ai/integrations/hermes/couponfollow-category-coupons)
- [Instinct](https://spiral.ai/integrations/instinct/couponfollow-category-coupons)
- [Manus](https://spiral.ai/integrations/manus/couponfollow-category-coupons)
- [Muse](https://spiral.ai/integrations/muse/couponfollow-category-coupons)
- [Muse Code](https://spiral.ai/integrations/muse-code/couponfollow-category-coupons)
- [n8n](https://spiral.ai/integrations/n8n/couponfollow-category-coupons)
- [Notion](https://spiral.ai/integrations/notion/couponfollow-category-coupons)
- [OpenClaw](https://spiral.ai/integrations/openclaw/couponfollow-category-coupons)
- [opencode](https://spiral.ai/integrations/opencode/couponfollow-category-coupons)
- [Perplexity](https://spiral.ai/integrations/perplexity/couponfollow-category-coupons)
- [Raycast](https://spiral.ai/integrations/raycast/couponfollow-category-coupons)
- [VS Code](https://spiral.ai/integrations/vscode/couponfollow-category-coupons)
- [Windsurf](https://spiral.ai/integrations/windsurf/couponfollow-category-coupons)
- [Zapier](https://spiral.ai/integrations/zapier/couponfollow-category-coupons)

## More Codex guides

- [Coolblue Netherlands product search](https://spiral.ai/integrations/codex/coolblue-netherlands-product-search)
- [CouponFollow store coupons](https://spiral.ai/integrations/codex/couponfollow-store-coupons)
- [Coolblue Netherlands product details](https://spiral.ai/integrations/codex/coolblue-netherlands-product-details)
- [CouponFollow trending coupons](https://spiral.ai/integrations/codex/couponfollow-trending-coupons)
- [Christie's lot search](https://spiral.ai/integrations/codex/christie-s-lot-search)
- [Coupons.com store coupons](https://spiral.ai/integrations/codex/coupons-com-store-coupons)

## Questions about CouponFollow category coupons in Codex

**Can Codex use CouponFollow category coupons?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run CouponFollow category coupons like any built-in tool.

**How much does CouponFollow category coupons 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 CouponFollow category coupons in Codex?**

No. Spiral runs CouponFollow category coupons on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up CouponFollow category coupons in Codex?**

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

**Does Codex wait while CouponFollow category coupons runs?**

CouponFollow category coupons runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**What coupon information does CouponFollow provide?**

Store results can include codes, discounts, expiration dates, shopper verification counts, and last-success times. CouponFollow also publishes offers by shopping category and in homepage trending and staff-picked lists.

**How often does CouponFollow update its coupon rankings?**

CouponFollow says it adjusts coupon ordering on merchant pages multiple times a day. That describes ranking changes, rather than a fixed refresh schedule for every offer.

**What does CouponFollow's Verified label mean?**

Verified means CouponFollow's team has checked that the code works. It does not establish that every product qualifies for the discount.

**Why might a listed code fail for my purchase?**

CouponFollow says codes can restrict which products qualify. A product-specific promotion should not be treated as a discount on the retailer's entire catalog.

**Can CouponFollow offers have country or customer restrictions?**

Yes. Its software category includes a Lovable promotion limited to new Pro subscribers in the United States, so the merchant's name alone does not establish eligibility.

