shopping-advisor

Generates product research reports with prices and purchase links via the Shopfox MCP server.

12|Updated Aug 13, 2026
One-click install
npx skills add https://github.com/shopfox-ai/shopfox-shopping-mcp-plugin --skill shopping-advisor-shopfox-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shopping-advisor
Source: https://github.com/shopfox-ai/shopfox-shopping-mcp-plugin/tree/main/skills/shopping-advisor
Command: npx skills add https://github.com/shopfox-ai/shopfox-shopping-mcp-plugin --skill shopping-advisor-shopfox-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Comparing products across US retailers requires manual searching, price checking, and tab-hopping. This Skill delegates that research to the Shopfox shopping agent and returns a complete purchase report with real prices, ratings, pros and cons, and direct purchase links. ## Core Features & Use Cases - One-Shot Shopping Reports: Call generate_shopping_report to get 3-5 concrete product picks with current prices, store names, links, and pros/cons in a single request. - Structured Research with Clarification: Use research_shopping_options to set budgets, must-have requirements, and exclusions, with a needsClarification flow for vague requests. - Async Reports for Short-Timeout Hosts: Use start_shopping_report on hosts like ChatGPT that time out around 60 seconds, then poll the status URL until the report is done. - Use Case: Ask "Find noise-cancelling headphones under $200" and receive a full markdown report comparing top picks across Amazon, Best Buy, Walmart, and Target. ## Quick Start Ask the assistant to find noise-cancelling headphones under $200 using the Shopfox shopping report tool.

Frequently Asked Questions about shopping-advisor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get a product comparison report with real prices?▼

Call generate_shopping_report with a query describing what you want, such as a product type and budget. The Shopfox agent returns a markdown report with 3-5 products, current prices, store names, purchase links, and pros and cons.

How do I set up the Shopfox API key for the MCP server?▼

Open https://shopfox.ai/user-info?createApiKey=1 in a browser, sign in, and copy the generated key shown once. Configure the shopfox MCP server entry with Authorization: Bearer <key>, keeping the key out of chat transcripts.

Which Shopfox tool should I use for shopping research?▼

Use generate_shopping_report for a complete one-shot report, research_shopping_options when you need structured data and clarification questions, and start_shopping_report only on hosts with short request timeouts like ChatGPT.

Does the shopping report work on ChatGPT with request timeouts?▼

Yes, use start_shopping_report which returns immediately with a jobId and statusUrl. Poll the statusUrl every 3 seconds until status is done, then output the full markdown report directly in the reply.

What retailers and regions does the shopping agent support?▼

The agent covers US shoppers only, searching major US retailers including Amazon, Best Buy, Walmart, and Target. All prices and budgets are in USD, and Chinese domestic platforms are explicitly out of scope.

Why did my shopping report come back with no products?▼

An empty report means the agent found no verifiable offers matching the query. State this plainly to the user rather than inventing prices, sellers, links, or ratings, and consider broadening the query or budget.