[Integrations](https://spiral.ai/integrations) › [Cursor](https://spiral.ai/integrations/cursor) › [Russelco product categories](https://spiral.ai/integrations/cursor/russelco-product-categories)

# How to Use Russelco product categories in Cursor

Returns Russelco's catalog categories so you can browse departments and narrower product sections. Use it to define an assortment review before looking up individual products.

|  |  |
| --- | --- |
| Model | Russelco product categories |
| 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 categories in Cursor

- Use Russelco product categories to map the OTC sections and add a department navigation fixture to this project's buying worksheet.
- Use Russelco product categories to find the Dental section and populate this project's department selector with the returned categories.
- Use Russelco product categories to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Russelco product categories and tell me what changed since last week.
- Check Russelco product categories and summarize what you find in three bullet points.

## How to set up Russelco product categories in Cursor

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

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to Cursor on the console's Agents & MCP page, or add this to `.cursor/mcp.json` (one project) or `~/.cursor/mcp.json` (every project):

```json
{
  "mcpServers": {
    "spiral": { "url": "https://api.spiral.ai/mcp" }
  }
}
```

2. **Sign in**: Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.

### Use the Spiral skill

1. **Send Cursor 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 categories**: 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/list_categories",
    "input": {
      "parent_id": "<parent_id>"
    }
  }'
```

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

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

## Russelco product categories tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| parent_id |  | — | Public id of the category whose children to list; omit for the top-level departments. 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}$. |

## What can you do with Russelco product categories in Cursor?

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.

## Overview

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

## Russelco product categories in other agents

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

## More Cursor guides

- [RedFlagDeals hot deals](https://spiral.ai/integrations/cursor/redflagdeals-hot-deals)
- [Russelco product details](https://spiral.ai/integrations/cursor/russelco-product-details)
- [RedFlagDeals deal search](https://spiral.ai/integrations/cursor/redflagdeals-deal-search)
- [Russelco product search](https://spiral.ai/integrations/cursor/russelco-product-search)
- [RedFlagDeals deal details](https://spiral.ai/integrations/cursor/redflagdeals-deal-details)
- [Savings.com category coupons](https://spiral.ai/integrations/cursor/savings-com-category-coupons)

## Questions about Russelco product categories in Cursor

**Can Cursor use Russelco product categories?**

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

**How much does Russelco product categories cost in Cursor?**

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

**Do I need an Alexandria account to use Russelco product categories in Cursor?**

No. Spiral runs Russelco product categories 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 categories in Cursor?**

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

**Does Cursor wait while Russelco product categories runs?**

Russelco product categories runs in the background. Cursor 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.

