agentic-commerce-query-shopping-agents

Purpose

The signature skill of the agentic-commerce-skills library. Sends a single shopping query to 5 AI shopping agents in parallel (ChatGPT, Gemini, Claude, Mistral, DeepSeek) and returns each agent's ranked product recommendations.

This is what makes AI catalog visibility measurable. Without cross-agent ground truth, "AI visibility" is a vibe; with it, it is a metric you can A/B test fixes against (see agentic-commerce-visibility-report).

Together with the Agentic Commerce Benchmarks dataset, this skill lets you measure where your products rank vs. competitors across the 6 most important AI shopping agents.

Prerequisites

API keys for the agents you want to query (each is optional; missing keys = that agent skipped):

• ANTHROPIC_API_KEY — for Claude
• OPENAI_API_KEY — for ChatGPT
• GEMINI_API_KEY — for Gemini (free tier available, https://aistudio.google.com)
• MISTRAL_API_KEY — for Mistral Le Chat
• DEEPSEEK_API_KEY — for DeepSeek

Parameters

Parameter	Type	Required	Default	Description
query	string	yes	—	Shopping query in natural language. Examples: "best winter jacket under $200 for hiking", "sustainable bamboo socks for sensitive skin"
agents	array	no	all-configured	Subset of agents to query: claude, chatgpt, gemini, mistral, deepseek. Skip with missing API keys.
vertical	string	no	—	Hint to the agents about category: apparel, beauty, home, electronics, fitness, food, pets, baby, outdoor, gifts
price_ceiling	float	no	—	Max price in USD (passed to agents in system prompt)
format	string	no	human	Output format: human or json
timeout_seconds	integer	no	60	Per-agent timeout

Workflow Steps

1. Build the shared shopping prompt:

   You are a shopping recommendation assistant. Given the query below, provide a numbered list of 5-10 specific product recommendations.
   
   For each: brand + product name, approximate price, why you recommend it (1-2 sentences), and where to buy it (merchant/website).
   
   Format each recommendation as:
   1. **Brand ProductName** - $XX.XX
      Reason for recommendation.
      Available at: https://merchant.com/product-link
   
   Query: {query}
   {vertical and price ceiling hints if provided}