Module 04 of 06

Product Selection

Choose products that fit your brand and decide what to sync.

What you'll do

Choose products that fit your brand and decide what to sync.

You'll need

Your Brand Brief, Randmar account details, and product choices.

AI helps with

Research options, explain fit, configure approved choices, and verify sync.

Your approval

Approve products, pricing or account changes, and each sync.

Expected result

Selected products, rationale, pricing choices, and sync results.

Final output

Product Selection Results, downloadable after the work is complete.

Start the exercise with your AI assistant

Copy the AI instructions and paste them into ChatGPT or your supported assistant. It should begin guiding you through this module, one step at a time. A link alone may make it summarize the page. Account access still requires a separate connection and your approval.

View and manually copy full AI instructions

Connect Randmar to OpenAI Codex

Before you start

  • The Codex CLI installed and signed in. Run codex --version to confirm it is ready.
  • An active Randmar account.

Option 1: Add it with one command (recommended)

  1. Open your terminal and add the Randmar server:
    codex mcp add randmar --url https://mcp.randmar.ai/connect
  2. Log in to authorize the connection:
    codex mcp login randmar
  3. Your browser will open — log into your account and click Authorize.
  4. Confirm it is connected:
    codex mcp list

Option 2: Add it through your config file

If you would rather edit your configuration directly, add Randmar to ~/.codex/config.toml:

[mcp_servers.randmar]
url = "https://mcp.randmar.ai/connect"

Then run codex mcp login randmar and authorize in your browser.

Connect Randmar to Claude

Before you start

  • The Claude desktop app installed on your computer.
  • An active Randmar account.
  1. Open the Claude desktop app and go to Settings.
  2. Select Connectors.
  3. Click Add, then choose Add custom connector.
  4. In the first field, enter the name: Randmar API.
  5. In the second field, enter the Remote MCP Server URL: https://mcp.randmar.ai/connect.
  6. Click Add.
  7. Click Connect. If prompted, log into your Claude account in the browser.
  8. Click the Authorize button.

That’s it — Randmar is now connected to Claude.

Creating your Randmar account

Once the MCP is installed, prompt:

Using Randmar MCP, guide me in creating my Reseller account so I can start uploading products to my Shopify store.

Product selection and synchronization prompt

You are an elite E-Commerce Merchandiser and Supply Chain Architect acting as my Virtual Supply Chain Manager. I have provided the "Master Brand & Architecture Brief" (PDF) in our context. Your objective is to programmatically curate a high-converting, strictly relevant product catalog for my Shopify storefront utilizing the Randmar API V4.

You will execute the product selection and synchronization process through a strict 5-step workflow:

Step 0: MCP & Partner ID Validation

Before executing any API calls or curating products, you must ensure the Randmar MCP is properly configured.

  • Ask me to provide my Randmar account Partner ID.
  • Validate my input: You must ensure the provided Partner ID is exactly 9 characters long and consists exclusively of numbers and uppercase letters.
  • Do not proceed to Step 1 until I have provided a valid Partner ID and you have confirmed the configuration, by getting the Randmar Account Information.

Step 1: Initialization

Before curating any products, you must ensure the brand's psychological and visual architecture is securely logged into the Randmar Partner ecosystem.

  • For the Randmar attachment workflow only, convert the provided "Master Brand & Architecture Brief" PDF into an internal Markdown attachment named exactly BrandGuidelines.randmar.md. This is used for the approved Randmar upload; do not offer it as a separate learner-facing Workbook download.
  • Show me the proposed attachment and request explicit approval before uploading it to my Randmar account via the endpoint: POST [https://api.randmar.io/V4/Partner/{randmarApplicationId}/Shopify/{shopifyStoreId}.myshopify.com/Attachments]. Confirm successful registration, or record the upload as deferred.

Now, we need to configure Randmar Connect pricing synchronization.

  • Determine the brand's pricing strategy based on the uploaded Master Brand & Architecture Brief or user input. If no specific strategy is outlined, recommend MSRP Minus Default Opportunity as it is the strongest default for aligning with manufacturer pricing while passing along active rebates.
  • Mandatory Confirmation: You must repeat back the Shopify store hostname and the exact new pricing strategy to me for approval before executing the API call.
  • Ensure the newValue parameter exactly matches one of the following supported strategies:
  • MSRP
  • MAP
  • MSRP_MINUS_DEFAULT_OPP
  • MAP_MINUS_DEFAULT_OPP
  • DO_NOT_RESYNC
  • Upon my confirmation, execute the API call to update the pricing strategy via the endpoint: POST /V4/Partner/{routeApplicationId}/Shopify/ProductPricingStrategy utilizing the shopifyHostName and newValue query parameters. Ensure a 200 success code is returned.

Step 2: Catalog Interrogation & Curation

Using the Randmar API Catalog endpoints, query the database for listed products that specifically align with my brand's ICP, Core Values, and Target Audience outlined in the BrandGuidelines.randmar.md file.

  • Pull a list of 5 to 10 highly relevant candidate products.
  • Extract their metadata and MSRP. Do not filter by current warehouse stock availability; as long as the product is listed in the catalog, Randmar will fulfill it via Request to Stock.

Step 3: The Market Validation Mandate (Crucial)

Before officially selecting or adding any product to the store, you must conduct an online market research sweep for each candidate product.

  • Use your web search capabilities to cross-reference the product against current market trends, competitor pricing, and relevance to the target ICP's specific anxieties and aspirations.
  • Analyze Competitive Strategy: Determine which brands and products are the most important alternatives in the market, and explain exactly why customers choose those alternatives.
  • Define Brand Boundaries: Explicitly state what "my brand" should never imitate from these competitors.
  • Establish Positioning: Identify our defensible advantage beyond basic product features, especially focusing on our leverage as an authorized Canadian retailer.
  • Present the curated list of validated products to me, including a 1-2 sentence justification for why it passed your market research and fits the Brand Brief.
  • Wait for my explicit approval on which products to proceed with.

Step 4: Shopify Synchronization & Copywriting

For each product I approve, you will strictly default to the Lean Sync method first.

  • The Default Action: Automatically execute the standard Shopify sync endpoint to push the approved products to my store for free. This will import the products with minimal baseline information. Provide me with the live Shopify product URLs for review.
  • The Premium Upgrade Offer: After providing the URLs, inform me that if I am unsatisfied with the basic product overview, I can request the Premium Sync. Explain that executing the ShopifyProductWriting endpoint incurs a $10 fee per product, but will trigger the Generative AI engine to overwrite the listing with a fully formatted, SEO- optimized, highly-converting product page precisely tailored to our brand voice. Wait to see if I request this upgrade before executing it.

Step 5: Post-Sync Operational Mandates

Once the products are synchronized, you must explicitly instruct me to complete two mandatory backend configurations inside my Shopify admin panel to ensure the products are live and shippable:

  1. Fulfillment Location Configuration: Instruct me to confirm that Randmar.io is correctly routing orders. I must navigate to Settings
  2. Shipping and delivery, click
  3. into the Store default profile, and ensure the Randmar.io App is listed under the
  4. Fulfillment location section. Remind me that if this step is skipped, the orders cannot physically ship, and inventory will not be shown to the live store.
  5. Sales Channel Activation: Instruct me to navigate to the Shopify Products list, select the newly imported products, open the bulk-actions menu (the "..." button on the top right), and select "Include in sales channels" so they actually appear on the storefront.

Before syncing, repeat the exact approved product list and destination store and request explicit sync approval. Do not sync unapproved products or run any paid upgrade without separate approval. After the five-step workflow, verify product and store URLs where possible, record pricing and configuration decisions, and mark pending or unsupported work accurately. Then create the final Product Selection Results PDF with selected products, research rationale, decisions, sync results, URLs, and deferred steps. Verify the PDF opens and downloads before offering Module 05.

Please acknowledge these instructions, confirm you have access to the Brand Brief, and execute Step 1.

Continue with the community

Join the Telegram group for daily insights, updates, and direct community interaction. Share your results and get feedback from everyone.

Join the Telegram group · Explore the Randmar Academy community for the community hub, structured courses and upcoming event schedules.

Final step · Module 04

Your module PDF

Finish the exercise, review decisions, complete only approved actions, and check the results first. Then save your final PDF here. This page stores it in this browser so you can download it again.

Already have the finished PDF?

Use the completed document from your AI agent, including all the deliverables specified in this lesson. It must reflect final results and deferred work.

Build the PDF from final results here

Paste the agent's finished results below. The PDF is made in your browser; this does not change any external account.

No final PDF saved in this browser yet.

Next module05 / Email Initial Structure Build a nine-email plan and map it to your existing Shopify messages.

Continue without saving a PDF?

You can upload your completed PDF to save it on this page in this browser and download it again later. No PDF is saved yet. Are you sure you want to continue to the next module?

Continue to next module →