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

Gemini CLI · E-commerce

How to Use Alternate NL product search in Gemini CLI

Returns matching products from Alternate’s Dutch storefront with stock indicators and ratings. Use it to find candidates before checking an exact item’s specifications.

Prompts to try with Alternate NL product search in Gemini CLI

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

Use Alternate NL product search to find Samsung 990 PRO listings and add their names, stock indicators, and links to the purchasing report in this project.

Alternate NL product searchGemini CLI
Try asking
  • Use Alternate NL product search to find Kingston NV3 listings and create a review table of returned names, availability, and ratings.

  • Use Alternate NL product search to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from Alternate NL product search and tell me what changed since last week.

  • Check Alternate NL product search and summarize what you find in three bullet points.

How to set up Alternate NL product search in Gemini CLI

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

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI 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 Alternate NL product search

    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": "alternate-nl/products/search",
        "input": {
          "query": "<query>"
        }
      }'

Then paste one of the prompts above: Gemini CLI finds Alternate NL product search on Spiral, shows the price and runs it.

Alternate NL product search providers and prices

Spiral runs Alternate NL product search through Alexandria. Open a card for today's price, with every fee included.

AlexandriaE-commerce
Alternate NL · Search
alternate-nl/products/search

Settings you can ask for

Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Page1 to 1001

Result page, 24 products per page; pass the previous next_page.

Every API field of Alternate NL · Search is on its tool page: open its card above.

What can you do with Alternate NL product search in Gemini CLI?

Build a hardware shortlist that connects Alternate.nl listings to your project’s purchasing requirements. Use product matches to find candidates and exact listing details to compare specifications and identifiers.

Prepare an SSD purchasing shortlist

Find Samsung and Kingston SSD listings, then inspect the exact items’ capacity, interface, identifiers, and availability before choosing candidates.

Find alternatives to an unavailable component

Locate other products in the same category, then compare their listed specifications and delivery text against the original requirement.

Check an internal hardware catalog

Find relevant Alternate listings and compare their product details with existing catalog records, using manufacturer part numbers and EANs to check exact matches.

Monitor a procurement watchlist

Repeat searches for required hardware and check selected product listings for changes in stock status or delivery text.

Compare storage configurations

Find Samsung 990 PRO listings and inspect each selected capacity’s specifications. Build a comparison using the exact products rather than assuming all capacities have identical specifications.

Build a retailer availability report

Find products for a named brand or model and inspect selected listings. Separate stock indicators from delivery wording so buyers can see which items need closer review.

Questions about Alternate NL product search in Gemini CLI

Can Gemini CLI use Alternate NL product search?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Alternate NL product search like any built-in tool.

How much does Alternate NL product search cost in Gemini CLI?

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

Do I need an Alexandria account to use Alternate NL product search in Gemini CLI?

No. Spiral runs Alternate NL 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 Alternate NL product search in Gemini CLI?

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

Does Gemini CLI wait while Alternate NL product search runs?

Alternate NL product search runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

Does this cover every Alternate country store?

The data comes from Alternate.nl, the Dutch storefront. Alternate says its stores operate independently, so inventory and assortment can differ across stores.

How fresh are Alternate’s stock indicators?

Alternate says its website refreshes stock indications several times per hour. That is the storefront’s update schedule, rather than a guarantee of the endpoint’s refresh timing.

What does delivery within one to three working days mean?

Alternate uses that status for products stocked in its European warehouse. It distinguishes that stock from products already available in its main warehouse.

Are the listed specifications guaranteed to be correct?

Alternate explicitly qualifies its website information, including product specifications, as subject to reservations. Its published specifications are retailer listing data, rather than independently verified measurements.

Does the data include shopping carts or checkout?

The documented coverage is the public Dutch storefront. Cart and checkout operations are explicitly excluded.

Get started

Start using Alternate NL product search in Gemini CLI

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

Paste this into Gemini CLI:

Set up Gemini CLI

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