[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Trader Joe's product search](https://spiral.ai/integrations/opencode/trader-joe-s-product-search)

# How to Use Trader Joe's product search in opencode

Returns matching Trader Joe's product listings for a selected store, including names, pack sizes, categories, and product identifiers. Use it to find candidates before requesting detailed ingredients and nutrition.

|  |  |
| --- | --- |
| Model | Trader Joe's product 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 Trader Joe's product search in opencode

- Use Trader Joe's product search for cream cheese at store 701 and create a comparison table in this project showing product names and pack sizes.
- Use Trader Joe's product search for dumplings at store 701 and adapt this project's search-results component to the returned names, categories, and product identifiers.
- Use Trader Joe's product search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Trader Joe's product search and tell me what changed since last week.
- Check Trader Joe's product search and summarize what you find in three bullet points.

## How to set up Trader Joe's product 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 Trader Joe's product 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": "traderjoes-com/products/search",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: opencode finds Trader Joe's product search on Spiral, shows the price and runs it.

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

## Trader Joe's product search tools and prices

- [Trader Joe's · Search](https://spiral.ai/tools/alexandria/traderjoes-com/products/search) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 200 | 1 | page |
| page_size | 1 to 50 | 24 | page_size |
| store_code |  | 701 | Trader Joe's store code from stores. Pattern: ^[0-9]{1,5}$. |

## What can you do with Trader Joe's product search in opencode?

Build a personal grocery planner that connects nearby Trader Joe's locations with product choices and nutrition comparisons. Your coding agent can use returned store and product records to implement search results, detail views, and shopping lists.

### Plan a week of dinners

Choose a nearby store, find products for planned meals, and inspect ingredients and serving sizes before making a personal shopping list.

### Build a brunch shopping list

Find a convenient location, search for bagels and spreads, and compare the listed ingredients and servings of shortlisted products.

### Research seasonal groceries

Select a store near a travel destination, search for pumpkin or maple products, and inspect promising listings. Seasonal announcements may include items still coming soon.

### Find a replacement ingredient

Locate a nearby store, search for an alternative pasta or spread, and compare its ingredients and pack size with the product a recipe calls for.

### Compare snack nutrition

Search for several snack options and compare calories, sodium, and protein alongside each product's stated serving size.

## Overview

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

## Trader Joe's product search in other agents

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

## More opencode guides

- [Trader Joe's product details](https://spiral.ai/integrations/opencode/trader-joe-s-product-details)
- [Trader Joe's store finder](https://spiral.ai/integrations/opencode/trader-joe-s-store-finder)
- [TikTok creator showcase products](https://spiral.ai/integrations/opencode/tiktok-creator-showcase-products)
- [Tweakers product details](https://spiral.ai/integrations/opencode/tweakers-product-details)
- [TikTok Shop store products](https://spiral.ai/integrations/opencode/tiktok-shop-store-products)
- [Tweakers product search](https://spiral.ai/integrations/opencode/tweakers-product-search)

## Questions about Trader Joe's product search in opencode

**Can opencode use Trader Joe's product search?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Trader Joe's product search like any built-in tool.

**How much does Trader Joe's product 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 Trader Joe's product search in opencode?**

No. Spiral runs Trader Joe's product 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 Trader Joe's product search in opencode?**

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

**Does opencode wait while Trader Joe's product search runs?**

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

**Does Trader Joe's online catalog include everything in its stores?**

No. Trader Joe's explicitly says its website does not represent every product, so an unsuccessful search does not establish that an item is unavailable in stores.

**Does a published product page confirm current product details?**

Trader Joe's warns that an item's details may have changed since posting. Use the listing for research without treating its publication as confirmation of the product currently on the shelf.

**Are seasonal products available as soon as Trader Joe's announces them?**

Not necessarily. Trader Joe's fall 2026 announcement explicitly included both products already in stores and products coming soon.

**Do all Trader Joe's stores have the same hours?**

Trader Joe's gives 8 a.m. to 9 p.m. daily as its general schedule but says there are exceptions. Its FAQ directs shoppers to the individual store listing for hours.

**Can I republish Trader Joe's descriptions and images?**

Trader Joe's terms restrict website material to personal, informational, and shopping purposes. They require express written consent to reproduce or redistribute material.

