[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Flipp local retailer flyers](https://spiral.ai/integrations/opencode/flipp-local-retailer-flyers)

# How to Use Flipp local retailer flyers in opencode

Find retailer flyers available for a shopping area. Use it to choose which ads to inspect before looking for individual products.

|  |  |
| --- | --- |
| Model | Flipp local retailer flyers |
| 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 Flipp local retailer flyers in opencode

- Use Flipp local retailer flyers for Toronto M5V 2T6 and show me which grocery retailers have ads available.
- Use Flipp local retailer flyers to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Flipp local retailer flyers and tell me what changed since last week.
- Check Flipp local retailer flyers and summarize what you find in three bullet points.
- Pull the newest data from Flipp local retailer flyers and give me the result as a table.

## How to set up Flipp local retailer flyers 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 Flipp local retailer flyers**: 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": "flipp-com/deals/list_flyers",
    "input": {
      "postal_code": "<postal_code>"
    }
  }'
```

Then paste one of the prompts above: opencode finds Flipp local retailer flyers on Spiral, shows the price and runs it.

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

## Flipp local retailer flyers tools and prices

- [Flipp weekly ads · List flyers](https://spiral.ai/tools/alexandria/flipp-com/deals/list_flyers) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 500 | 100 | Maximum flyers returned, in Flipp's priority order. |
| category |  | — | Flipp category to keep, case-insensitive (Groceries, Pharmacy, General Merchandise, Black Friday...). |
| merchant |  | — | Retailer name to keep, matched case- and punctuation-insensitively as a substring (cvs matches CVS Pharmacy). |

## What can you do with Flipp local retailer flyers in opencode?

Build a personal shopping view that turns Flipp's local ads into a retailer shortlist or product comparison. Use flyer discovery, product matches, or individual ad items to answer the shopping question your project handles.

### Plan a grocery trip

Find the grocery flyers for your shopping area, search for milk, eggs, and rice, then inspect the relevant ads for sale dates and product descriptions.

### Compare a household brand

Identify local retailer ads, search for Tide offers, and read the matching flyers to compare the advertised package descriptions and sale periods.

### Prepare for shopping in another city

Check which flyers appear at your destination, look for products you need, and inspect those ads before deciding where to shop.

### Choose a store for a seasonal purchase

Find local retailer flyers, search for an air fryer or holiday baking supplies, and review the relevant flyer items before making a shortlist.

### Build a personal weekly shopping brief

Start with available local flyers, search for your regular purchases, and inspect the ads to summarize offers with their sale periods.

### Check a product against its retailer's ad

Find a retailer's available flyers, search for a specific product, and read the corresponding ad items to review the description and flyer page.

## Overview

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

## Flipp local retailer flyers in other agents

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

## More opencode guides

- [Fanatics team directory](https://spiral.ai/integrations/opencode/fanatics-team-directory)
- [Flipp product deals search](https://spiral.ai/integrations/opencode/flipp-product-deals-search)
- [Fanatics team and league products](https://spiral.ai/integrations/opencode/fanatics-team-and-league-products)
- [Flipp retailer flyer items](https://spiral.ai/integrations/opencode/flipp-retailer-flyer-items)
- [Fanatics product search](https://spiral.ai/integrations/opencode/fanatics-product-search)
- [GitHub account search](https://spiral.ai/integrations/opencode/github-account-search)

## Questions about Flipp local retailer flyers in opencode

**Can opencode use Flipp local retailer flyers?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Flipp local retailer flyers like any built-in tool.

**How much does Flipp local retailer flyers 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 Flipp local retailer flyers in opencode?**

No. Spiral runs Flipp local retailer flyers on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Flipp local retailer flyers in opencode?**

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

**Does opencode wait while Flipp local retailer flyers runs?**

Flipp local retailer flyers runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**Which countries does Flipp cover?**

Flipp is available in Canada and the United States. Its local ads depend on the shopping ZIP or postal code.

**Does Flipp show every nearby store's weekly ad?**

Some retailers do not have a live ad every week. Flipp also acknowledges that its location matching is imperfect, so a missing ad does not establish that a store has no offers.

**Why do Flipp results change between locations?**

Flipp selects stores using the shopping ZIP or postal code. You can see a different selection of ads by searching the area where you plan to shop.

**Can Flipp show next week's offers?**

Flipp has previews of upcoming flyers, but they are not available for every store. Check the sale period before treating a preview as an offer you can use today.

**Are all displayed Flipp ads still current?**

Flipp acknowledges that expired ads can remain visible, even after refreshing the app. A displayed ad alone does not establish that its offers are still valid.

