[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [IronPlanet equipment preview](https://spiral.ai/integrations/instinct/ironplanet-equipment-preview)

# How to Use IronPlanet equipment preview in Instinct

Returns a machine's public preview, including features, meter reading, serial number, and photo information when available. Use it to examine a shortlisted item beyond its listing summary.

|  |  |
| --- | --- |
| Model | IronPlanet equipment preview |
| Available through | Alexandria |
| Category | E-commerce |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with IronPlanet equipment preview in Instinct

- Each weekday, use IronPlanet equipment preview for item 14994469 and report changes in its returned features, meter reading, or photo information.
- Every Monday at 9am: use IronPlanet equipment preview to look this up and give me the result as a table.
- Pull the latest numbers from IronPlanet equipment preview and tell me what changed since last week.
- Check IronPlanet equipment preview and summarize what you find in three bullet points.
- Pull the newest data from IronPlanet equipment preview and give me the result as a table.

## How to set up IronPlanet equipment preview in Instinct

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

### Use the Spiral skill

1. **Send Instinct 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 Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### 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 IronPlanet equipment preview**: 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": "ironplanet-com/equipment-auctions/get_equipment_preview",
    "input": {
      "url": "<url>"
    }
  }'
```

Then paste one of the prompts above: Instinct finds IronPlanet equipment preview on Spiral, shows the price and runs it.

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

## IronPlanet equipment preview tools and prices

- [IronPlanet · Get equipment preview](https://spiral.ai/tools/alexandria/ironplanet-com/equipment-auctions/get_equipment_preview) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | Alternatively a pasted item URL: https://www.ironplanet.com/for-sale/{slug}/{equipId}, /jsp/s/item/{equipId} or /jsp/equip/bidPage.jsp?equipId=... |
| equip_id |  | — | Item id from a listing (`equip_id`), digits only. Pattern: ^[0-9]{1,12}$. |

## What can you do with IronPlanet equipment preview in Instinct?

Prepare a recurring equipment purchase briefing from IronPlanet listings, scheduled auctions, and public previews. Where scheduled automated access is authorized, the agent can highlight newly returned candidates and changes relevant to a buyer's shortlist.

### Prepare an excavator purchase shortlist

Resolve excavator terminology through search suggestions, compare equipment listings, identify upcoming sales, review their lots, and examine the features and meter readings of selected machines.

### Plan a farm equipment replacement

Find the site's tractor categories, compare listed John Deere equipment, identify relevant scheduled auctions, review available lots, and check public previews for features and serial numbers.

### Review truck fleet purchase candidates

Identify truck category terminology, browse Freightliner listings, choose upcoming sales, inspect their inventories, and compare selected vehicles using available meter readings and photo information.

### Find equipment for a warehouse expansion

Resolve forklift categories, browse Toyota equipment, review upcoming auction opportunities and their lots, then examine public previews for the features needed by the warehouse.

### Compare documentation before reviewing a machine

Start with equipment listings or one auction's lots, then compare selected previews by available serial number, meter reading, features, and photo count. Use the comparison to decide which machines deserve closer review.

### Prepare a buyer's auction agenda

Identify upcoming sales, review their lots, and select the equipment worth discussing before each auction. Keep sale selection separate from the review of individual machines.

## Overview

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

## IronPlanet equipment preview in other agents

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

## More Instinct guides

- [IronPlanet equipment listings](https://spiral.ai/integrations/instinct/ironplanet-equipment-listings)
- [IronPlanet equipment search suggestions](https://spiral.ai/integrations/instinct/ironplanet-equipment-search-suggestions)
- [IronPlanet auction lots](https://spiral.ai/integrations/instinct/ironplanet-auction-lots)
- [IronPlanet upcoming auctions](https://spiral.ai/integrations/instinct/ironplanet-upcoming-auctions)
- [IKEA product search](https://spiral.ai/integrations/instinct/ikea-product-search)
- [JLCPCB component categories](https://spiral.ai/integrations/instinct/jlcpcb-component-categories)

## Questions about IronPlanet equipment preview in Instinct

**Can Instinct use IronPlanet equipment preview?**

Yes. Add Spiral to Instinct as an MCP server, and Instinct can find and run IronPlanet equipment preview like any built-in tool.

**How much does IronPlanet equipment preview cost in Instinct?**

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

**Do I need an Alexandria account to use IronPlanet equipment preview in Instinct?**

You need no Alexandria account. Instinct uses one Spiral API key for every tool, and Spiral runs IronPlanet equipment preview on its own Alexandria account.

**How long does it take to set up IronPlanet equipment preview in Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while IronPlanet equipment preview runs?**

IronPlanet equipment preview runs in the background. Instinct starts the run, checks on it and gives you the json when it's ready.

**Does IronPlanet only list equipment in scheduled auctions?**

No. IronPlanet also offers Marketplace-E, a 24/7 marketplace where equipment can be bought every day. An upcoming auction list therefore serves a narrower purpose than browsing equipment for sale.

**How often does IronPlanet hold auctions?**

IronPlanet describes its online and onsite auctions as weekly. That describes the sale schedule, not a guaranteed refresh interval for every listing or preview.

**How current is an IronPlanet condition report?**

The report describes visible condition on the inspection date. Retrieving equipment information later does not make that inspection a new assessment of the machine.

**Are the displayed hours or miles verified lifetime usage?**

No. IronPlanet explicitly does not guarantee actual equipment hours or miles. A displayed meter reading should not be described as verified lifetime usage.

**Do public IronPlanet pages permit unrestricted automated collection?**

No. IronPlanet's site terms prohibit robots, scrapers, data mining tools, and other automated collection methods. Public visibility alone does not establish permission for an automated workflow.

