[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [RedFlagDeals deal search](https://spiral.ai/integrations/opencode/redflagdeals-deal-search)

# How to Use RedFlagDeals deal search in opencode

Returns deal search results with retailer, savings, votes, and reply counts. Use it to gather relevant product or store threads before reading their full discussions.

|  |  |
| --- | --- |
| Model | RedFlagDeals deal search |
| 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 RedFlagDeals deal search in opencode

- Use RedFlagDeals deal search to retrieve results and keep threads mentioning Sony WH-1000XM5. Create a comparison fixture from the returned retailer, savings, votes, and links.
- Use RedFlagDeals deal search to retrieve results across the available forums and keep Costco threads. Add a report comparing their savings, votes, and reply counts.
- Use RedFlagDeals deal search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from RedFlagDeals deal search and tell me what changed since last week.
- Check RedFlagDeals deal search and summarize what you find in three bullet points.

## How to set up RedFlagDeals deal search in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 RedFlagDeals deal search**: 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": "redflagdeals-com/deals/search_deals",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: opencode finds RedFlagDeals deal search on Spiral, shows the price and runs it.

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

## RedFlagDeals deal search tools and prices

- [RedFlagDeals · Search deals](https://spiral.ai/tools/alexandria/redflagdeals-com/deals/search_deals) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 1000 | 1 | 1-based page. |
| forum | hot_deals, freebies, coupons, contests, request_a_deal, shopping_discussion, expired_hot_deals, all | hot_deals | Forum to search, or all. |
| per_page | 6 to 40 | 20 | Items per page (the API accepts 6 to 40). |

## What can you do with RedFlagDeals deal search in opencode?

Build a Canadian deal review screen that compares retailer offers and links each result to its RedFlagDeals discussion. Use forum metadata for the shortlist and thread text for the conditions shown beside each offer.

### Prepare an office equipment shortlist

Browse offers, collect threads mentioning Dell monitors or Logitech keyboards, and read the discussions for purchase conditions before proposing an equipment shortlist.

### Compare retailer promotions

Gather Costco, Walmart, and Best Buy Canada threads, compare their reported savings and community votes, and inspect the original offers before writing a comparison.

### Draft a Canadian shopping digest

Select relevant deal threads, summarize each offer, and include the discussion link and any conditions stated in the original post.

### Review promotion eligibility

Identify YMMV offers in listings or search results, then read the thread for stated geographic, inventory, or eligibility restrictions.

### Research shopper objections

Collect public product and retailer discussions, use reply counts to choose threads for review, and summarize recurring objections from the replies.

### Compare community reactions

Compare votes and discussion volume across competing headphone or laptop offers, then read selected threads to explain the response to each promotion.

## Overview

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

## RedFlagDeals deal search in other agents

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

## More opencode guides

- [RedFlagDeals deal details](https://spiral.ai/integrations/opencode/redflagdeals-deal-details)
- [RedFlagDeals hot deals](https://spiral.ai/integrations/opencode/redflagdeals-hot-deals)
- [Reclame Aqui complaint search](https://spiral.ai/integrations/opencode/reclame-aqui-complaint-search)
- [Russelco product categories](https://spiral.ai/integrations/opencode/russelco-product-categories)
- [Reclame Aqui complaint details](https://spiral.ai/integrations/opencode/reclame-aqui-complaint-details)
- [Russelco product details](https://spiral.ai/integrations/opencode/russelco-product-details)

## Questions about RedFlagDeals deal search in opencode

**Can opencode use RedFlagDeals deal search?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run RedFlagDeals deal search like any built-in tool.

**How much does RedFlagDeals deal search cost in opencode?**

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

**Do I need an Alexandria account to use RedFlagDeals deal search in opencode?**

No. Spiral runs RedFlagDeals deal 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 RedFlagDeals deal search in opencode?**

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

**Does opencode wait while RedFlagDeals deal search runs?**

RedFlagDeals deal search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**Which country does RedFlagDeals cover?**

RedFlagDeals focuses on Canadian community deal discussions. Coverage includes Hot Deals, Coupons, Freebies, and Contests.

**Where does the data come from?**

The underlying source is RedFlagDeals' own forum JSON API at forums.redflagdeals.com/api.

**How much data can one page contain?**

The documented range is 6 to 40 items per page. A page is a portion of the results, so it should not be described as the complete forum or discussion.

**Does the data include community discussion?**

Listings include reply counts, while individual thread retrieval includes the original post and replies. Use the thread text when you need the conditions behind an offer.

**Can I tell when a thread response was observed?**

The documented thread response includes an observation timestamp. It also includes a total post count and a next-page pointer, which help distinguish the retrieved page from the whole discussion.

