[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [Russelco product search](https://spiral.ai/integrations/muse-code/russelco-product-search)

# How to Use Russelco product search in Muse Code

Returns matching Russelco listings for comparing product descriptions, package sizes, and available stock. Use it to build a brand or department shortlist before inspecting an exact product.

|  |  |
| --- | --- |
| Model | Russelco 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 Russelco product search in Muse Code

- Use Russelco product search to find Advil listings and create a comparison table in this project that keeps tablet count and product form separate.
- Use Russelco product search to find Abreva listings and generate a catalog matching report that preserves alternate UPC wording and package sizes.
- Use Russelco product search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Russelco product search and tell me what changed since last week.
- Check Russelco product search and summarize what you find in three bullet points.

## How to set up Russelco product search in Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse Code 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 Russelco 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": "russelcoinc-com/products/search_products",
    "input": {
      "page": 1
    }
  }'
```

Then paste one of the prompts above: Muse Code finds Russelco product search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## Russelco product search tools and prices

- [Russelco Inc · Search products](https://spiral.ai/tools/alexandria/russelcoinc-com/products/search_products) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 1000 | 1 | 1-based page of 42 products; pass the returned next_cursor to continue. |
| sort | description, price_asc, price_desc | description | Sort order; the site's own values. |
| query |  |  | Free-text search (product description or brand, e.g. `advil`). Empty or omitted lists the catalogue. |
| category_id |  | — | Category public id (uuid) as returned by list_categories (`id`) or seen in the site's `/products?category=` links. Includes the category's descendants. Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$. |
| wholesale_prices |  | — | Return wholesale unit prices instead of retail ones, as the public 'Wholesale Prices' toggle on the site does (no login involved). |
| special_offers_only |  | — | Only products in the site's 'On Sale' view (`/products?special=true`); their `price_override` carries the sale price. |

## What can you do with Russelco product search in Muse Code?

Build a buying worksheet that separates Russelco's consumer package sizes from shipping case packs. Use its department structure and exact product records to organize catalog matches for review.

### Plan a department assortment

Map Russelco's OTC sections, find the products in each section, and inspect shortlisted listings for package size and case pack. Turn the results into a department buying list.

### Review brand coverage

Locate the relevant catalog sections, collect Advil listings, and check exact records to separate tablet counts and product forms. Show buyers which distinct packs appear in Russelco's assortment.

### Prepare a replenishment review

Scope a review by department, collect its listings, and inspect selected products for stock and case pack. Keep cases and individual units separate in the proposed buying quantities.

### Review dated merchandise by department

Organize a buying review around Russelco's categories, find listings with expiration dates in their descriptions, and inspect the exact products. Give buyers a shortlist that preserves each listed date and package size.

### Resolve duplicate-looking listings

Find similar Abreva listings and compare their exact product records. Separate alternate UPCs, travel packs, pumps, creams, and twin packs before matching them to a store catalog.

### Compare package alternatives

Build an Advil shortlist and inspect the related products attached to an exact listing. Present different tablet counts as buying alternatives, with the package descriptions intact.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Muse Code guides](https://spiral.ai/integrations/muse-code)

## Russelco product search in other agents

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

## More Muse Code guides

- [Russelco product details](https://spiral.ai/integrations/muse-code/russelco-product-details)
- [Savings.com category coupons](https://spiral.ai/integrations/muse-code/savings-com-category-coupons)
- [Russelco product categories](https://spiral.ai/integrations/muse-code/russelco-product-categories)
- [Savings.com hot coupons](https://spiral.ai/integrations/muse-code/savings-com-hot-coupons)
- [RedFlagDeals hot deals](https://spiral.ai/integrations/muse-code/redflagdeals-hot-deals)
- [Savings.com store coupons](https://spiral.ai/integrations/muse-code/savings-com-store-coupons)

## Questions about Russelco product search in Muse Code

**Can Muse Code use Russelco product search?**

Yes. Add Spiral to Muse Code as an MCP server, and Muse Code can find and run Russelco product search like any built-in tool.

**How much does Russelco product search cost in Muse Code?**

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

**Do I need an Alexandria account to use Russelco product search in Muse Code?**

No. Spiral runs Russelco 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 Russelco product search in Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while Russelco product search runs?**

Russelco product search runs in the background. Muse Code starts the run, checks on it and gives you the json when it's ready.

**What kinds of products does Russelco cover?**

Russelco lists eight main departments: Baby, Bath, Dental, Household, Makeup, OTC, Personal Care, and Snacks.

**How detailed are the product categories?**

The OTC department breaks into sections such as Allergy, Cold Medications, and Digestive Care. Use those narrower sections to scope a buying review.

**Does stock mean cases or individual products?**

Russelco distinguishes cases from individual units, labeled eaches. Product details also give the case pack: the Abreva cream listing specifies 24 units per case.

**Can the data identify products with an expiration date?**

Some descriptions include an expiration month and year. For example, the sale catalog lists Banana Boat sunscreen with an Exp. 12/26 suffix.

**Are similar names enough to identify the same item?**

Russelco lists an Abreva cold sore pump with an explicit Alt UPC 1640 label. Compare the exact UPC, size, and description before merging similar-looking listings.

