[Integrations](https://spiral.ai/integrations) › [Hermes](https://spiral.ai/integrations/hermes) › [eBay listing details](https://spiral.ai/integrations/hermes/ebay-listing-details)

# How to Use eBay listing details in Hermes

Returns current item data for one eBay listing. Use it to inspect a known offer before checking its shipping terms or individual size and color choices.

|  |  |
| --- | --- |
| Model | eBay listing details |
| 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 eBay listing details in Hermes

- Every weekday, use eBay listing details for https://www.ebay.com/itm/167814076520 and report changes in the returned offer information since the previous check.
- Every Monday at 9am: use eBay listing details to look this up and give me the result as a table.
- Pull the latest numbers from eBay listing details and tell me what changed since last week.
- Check eBay listing details and summarize what you find in three bullet points.
- Pull the newest data from eBay listing details and give me the result as a table.

## How to set up eBay listing details in Hermes

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

### Use the Spiral skill

1. **Send Hermes 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. **Add the server and sign in**: Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

```bash
hermes mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --auth oauth \
  --connect-timeout 300
```

2. **Check it**: In a chat that was already open, run `/reload-mcp`.

```bash
hermes mcp list
hermes mcp test spiral
```

### 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 eBay listing details**: 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": "ebay-com/listings/item",
    "input": {
      "url": "<url>"
    }
  }'
```

Then paste one of the prompts above: Hermes finds eBay listing details on Spiral, shows the price and runs it.

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

## eBay listing details tools and prices

- [eBay listings · Item](https://spiral.ai/tools/alexandria/ebay-com/listings/item) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | An /itm/{id} listing URL on any ebay.* storefront; the numeric id is used |
| item_id |  | — | eBay item number (9-15 digits), e.g. "398411135079" Pattern: ^[0-9]{9,15}$. |

## What can you do with eBay listing details in Hermes?

Receive a recurring brief about selected eBay offers or product search wording. Scheduled checks can surface changes in listing information, delivery terms, product-choice availability, or suggested phrases.

### Prepare a purchasing shortlist

Review supplied eBay listing links for a product purchase. Combine item checks, delivery terms, and availability for the required configuration, then use suggested search wording to identify gaps for further research.

### Build a product comparison dashboard

Turn a saved shortlist into comparable offers with separate views for listing information, shipping terms, and individual product choices. Add eBay's suggested phrases to help users refine their next search.

### Research an apparel assortment

Inspect selected public listings for Gildan shirts or similar merchandise. Compare available sizes and colors, delivery and return terms, and the search wording eBay proposes for the product.

### Find suitable replacement components

Check a supplied shortlist of replacement-component listings for the required configuration and delivery terms. Use suggested product phrases to prepare more precise follow-up searches when the shortlist lacks a suitable choice.

### Review repeat purchases

Revisit previously selected business-supply listings before ordering again. Check the current offer, required product choice, and shipping and return terms for changes that affect the purchase.

### Compare delivery and return terms

Compare supplied offers for the same product using their listing information, shipping services, estimated delivery, and return policies. Keep the destination context visible when assessing delivery estimates.

## Overview

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

## eBay listing details in other agents

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

## More Hermes guides

- [bol.com product search](https://spiral.ai/integrations/hermes/bol-com-product-search)
- [eBay listing options](https://spiral.ai/integrations/hermes/ebay-listing-options)
- [bol.com product details](https://spiral.ai/integrations/hermes/bol-com-product-details)
- [eBay listing shipping](https://spiral.ai/integrations/hermes/ebay-listing-shipping)
- [bid.cars vehicle makes and models](https://spiral.ai/integrations/hermes/bid-cars-vehicle-makes-and-models)
- [eBay search suggestions](https://spiral.ai/integrations/hermes/ebay-search-suggestions)

## Questions about eBay listing details in Hermes

**Can Hermes use eBay listing details?**

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run eBay listing details like any built-in tool.

**How much does eBay listing details cost in Hermes?**

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

**Do I need an Alexandria account to use eBay listing details in Hermes?**

No. Spiral runs eBay listing details on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up eBay listing details in Hermes?**

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

**Does Hermes wait while eBay listing details runs?**

eBay listing details runs in the background. Hermes starts the run, checks on it and gives you the json when it's ready.

**Does eBay verify every claim in a listing?**

eBay does not guarantee listing accuracy. Its listing policy requires the selected condition to agree with the title, description, and item specifics, so conflicting condition claims deserve a closer check.

**Can eBay listing information change after I check it?**

Yes. For most listings, sellers can edit titles and change photos at any time, so an earlier listing summary can differ from the offer you see later.

**Can public eBay data show exact stock counts?**

Not consistently. eBay lets sellers choose whether buyers can see the exact quantity remaining, so public availability is not always an exact inventory count.

**How many size, color, or configuration choices can one listing contain?**

eBay permits up to 250 choices in one listing. Each choice can have a different quantity and price, so the listing's headline offer may not represent the selection you want.

**Is the delivery date shown on a listing final?**

The estimate can become more precise after you confirm your shipping method and address at checkout. eBay also calculates estimates dynamically using handling time, carrier performance, and the delivery locations.

