How It Works

SellerBeam consists of two parts: a Chrome extension that renders the sidebar in your browser, and a lightweight local server that handles authenticated requests to Amazon's SP-API. Both run on your machine — no cloud server required.

Architecture Overview

Chrome Extension
React + TypeScript
Local Server
Node.js + Express
Amazon SP-API
Official API

Your SP-API credentials are stored in a local .env file and never transmitted beyond your own machine.

1

Set up your SP-API credentials

SellerBeam uses the Amazon Selling Partner API, which requires developer credentials linked to your Seller Central account.

  1. Log in to Seller Central and navigate to Apps & Services → Develop Apps.
  2. Create a new app and obtain your Client ID, Client Secret, and Refresh Token.
  3. Note your Seller ID from your Seller Central account settings.
  4. See our full SP-API credential setup guide →
2

Start the local server

The local server handles SP-API authentication and relays data to the Chrome extension. It runs entirely on your machine.

  1. Download the SellerBeam server package from the docs page.
  2. Create a .env file with your SP-API credentials (template included).
  3. Run npm install then npm start. The server starts on localhost:3001.
  4. Keep the terminal window open while sourcing.
3

Install the Chrome extension

The extension injects the SellerBeam sidebar into Amazon product pages automatically.

  1. Add SellerBeam from the Chrome Web Store.
  2. Pin the extension to your toolbar for quick access to settings.
  3. Make sure the local server is running, then open any Amazon product page.
4

Start sourcing

Open any Amazon product page. The SellerBeam sidebar appears automatically — no clicking, no copying ASINs.

Every time you navigate to a product page (amazon.com/dp/...), the sidebar loads with:

  • Your eligibility status (gated/ungated)
  • Whether Amazon is competing on the listing
  • Full profit breakdown for FBA
  • BSR, seller count, and category

Need a detailed setup guide?

Our docs page walks through every step with screenshots and troubleshooting tips.

Go to Documentation