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

Gemini CLI · E-commerce

How to Use Amazon creator storefront in Gemini CLI

Fetch a creator’s Amazon storefront profile, Idea List summaries, curations, trending picks, and videos with linked ASINs. Use it to review a creator’s product themes or find videos featuring a particular product.

Prompts to try with Amazon creator storefront in Gemini CLI

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

Use Amazon creator storefront for https://www.amazon.com/shop/sydneydelrey and add an Idea List table to this project with titles, item counts, and source links.

Amazon creator storefrontGemini CLI
Try asking
  • Use Amazon creator storefront for https://www.amazon.com/shop/sydneydelrey and create a searchable video index in this project using returned IDs, titles, thumbnails, and attached ASINs.

  • Use Amazon creator storefront for https://www.amazon.com/shop/sydneydelrey and add a report matching returned videos to ASIN B0B1ZJZRPB.

  • Use Amazon creator storefront for https://www.amazon.com/shop/sydneydelrey and save list URLs, titles, and item counts as a baseline for this project’s storefront comparison feature.

  • Use Amazon creator storefront for https://www.amazon.com/shop/sydneydelrey and build separate project views for Idea List item counts and curation post counts.

How to set up Amazon creator storefront 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 Amazon creator storefront

    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": "scrapecreators",
        "model": "scrapecreators/amazon-shop",
        "input": {
          "url": "https://www.amazon.com/shop/sydneydelrey"
        }
      }'

Then paste one of the prompts above: Gemini CLI finds Amazon creator storefront on Spiral, shows the price and runs it.

Amazon creator storefront providers and prices

Spiral runs Amazon creator storefront through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsE-commerce
Amazon Shop · Amazon Shop page
scrapecreators/amazon-shop

What can you do with Amazon creator storefront in Gemini CLI?

Build a storefront review table that connects Amazon creator categories with product-linked videos. A coding agent can turn list summaries and video ASINs into searchable project data.

Review a creator’s merchandising themes

Compare Idea List and curation titles to identify the product categories a public creator emphasizes before preparing a partnership brief.

Find videos attached to a product

Match a supplied ASIN against the ASINs attached to returned videos, then produce a review list with video titles and IDs.

Prepare a seasonal content brief

Identify holiday, travel, fitness, or seasonal themes in storefront lists and curations. Include the source links so an editor can inspect each collection.

Monitor storefront category changes

Compare successive collections of Idea List URLs, titles, and item counts to flag renamed categories and changes in assortment size.

Build an internal video reference index

Organize returned video IDs, titles, thumbnails, and attached ASINs into a searchable reference for reviewing creator product coverage.

Audit collection organization

Review list titles, list item counts, curation titles, and curation post counts to find overlapping themes or unusually broad collections worth checking.

Questions about Amazon creator storefront in Gemini CLI

Can Gemini CLI use Amazon creator storefront?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Amazon creator storefront like any built-in tool.

How much does Amazon creator storefront cost in Gemini CLI?

Up to $0.0013 per run. 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 a ScrapeCreators account to use Amazon creator storefront in Gemini CLI?

No. Spiral runs Amazon creator storefront on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

How long does it take to set up Amazon creator storefront in Gemini CLI?

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

Does Gemini CLI wait while Amazon creator storefront runs?

Amazon creator storefront runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

What storefront information does Amazon creator storefront return?

The documented response includes the creator’s storefront profile, social links, Idea Lists, curations, trending picks, and videos. Videos include attached ASINs, while lists include titles, item counts, images, and links.

Does an Idea List summary include every product in the list?

The documented example provides a list title, item count, image, and URL. It does not show a complete product inventory inside each list summary.

Can one response contain the entire storefront?

The source supports pagination, and a page can contain lists, videos, or both. Check for additional pages before calling a storefront review complete.

Does a storefront show content awaiting approval?

Amazon separates pending submissions from published content. Its published category identifies content that is live on the storefront, and shoppers discover approved videos there.

Can storefront categories change after I collect them?

Yes. Amazon lets creators rename or delete Idea Lists and says renamed lists update in the public view, so list titles and category availability can change.

Get started

Start using Amazon creator storefront 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