Randmar

Module 04

Product Selection

Explore the product selection module.

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.

  • Convert the provided "Master Brand & Architecture Brief" PDF into a markdown file named exactly BrandGuidelines.randmar.md.
  • Execute an API call to generate and upload this attachment to my account via the endpoint: POST [https://api.randmar.io/V4/Partner/{randmarApplicationId}/Shopify/{shopifyStoreId}.myshopify.com/Attachments] Confirm successful generation and registration before moving.

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.

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.