Spiral gives your agent every tool with one account. Browse the tools →

Windsurf · E-commerce

How to Use eBay listing options in Windsurf

Returns prices and availability for individual choices within an eBay listing. Use it when the size, color, or configuration you need matters more than the listing's headline offer.

Prompts to try with eBay listing options in Windsurf

Copy an example into Windsurf, or ask in your own words.

Use eBay listing options for https://www.ebay.com/itm/221835756563 and build a table of the returned size and color choices, prices, and availability.

eBay listing optionsWindsurf
Try asking
  • Use eBay listing options for https://www.ebay.com/itm/182570328469 and show availability for black shirts in medium and large in our merchandise planner.

  • Use eBay listing options to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from eBay listing options and tell me what changed since last week.

  • Check eBay listing options and summarize what you find in three bullet points.

How to set up eBay listing options in Windsurf

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

Use Spiral's MCP server

  1. Add the server

    Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:

    {
      "mcpServers": {
        "spiral": {
          "url": "https://api.spiral.ai/mcp"
        }
      }
    }
  2. Sign in

    Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf 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.

    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 options

    One request; the result comes back by polling or a webhook.

    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_variations",
        "input": {
          "url": "<url>"
        }
      }'

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

eBay listing options providers and prices

Spiral runs eBay listing options through Alexandria. Open a card for today's price, with every fee included.

AlexandriaE-commerce
eBay listings · Item variations
ebay-com/listings/item_variations

What can you do with eBay listing options in Windsurf?

Build an eBay purchasing view around the product questions your project needs to answer. Use listing checks, shipping comparisons, product-choice availability, or suggested search wording to populate the relevant screen.

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.

Check availability for specific choices

Inspect individual size, color, or configuration choices in selected listings. Identify which requested combinations are available without assuming that every choice matches the headline offer.

Questions about eBay listing options in Windsurf

Can Windsurf use eBay listing options?

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

How much does eBay listing options cost in Windsurf?

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

Do I need an Alexandria account to use eBay listing options in Windsurf?

No. Spiral runs eBay listing options 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 options in Windsurf?

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

Does Windsurf wait while eBay listing options runs?

eBay listing options runs in the background. Windsurf 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.

Get started

Start using eBay listing options in Windsurf

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Windsurf:

Set up Windsurf

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options