Shopfox Shopping
US shopping research with real prices, sellers, and purchase links from Amazon, Best Buy, Walmart.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http shopfox-shopping 'https://mcp.shopfox.ai/mcp' --header 'Authorization: <Optional. '\''Bearer sk_shopfox_...'\'' personal key from https://www.shopfox.ai/user-info?createApiKey=1. Leave empty to sign in with OAuth instead.>'{
"mcpServers": {
"shopfox-shopping": {
"type": "http",
"url": "https://mcp.shopfox.ai/mcp",
"headers": {
"Authorization": "<Optional. 'Bearer sk_shopfox_...' personal key from https://www.shopfox.ai/user-info?createApiKey=1. Leave empty to sign in with OAuth instead.>"
}
}
}
}Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
Shopfox Shopping
Ask your AI to shop for you — get real prices, real stores, real links.
Shopfox turns any AI assistant into a shopping expert. Ask in plain English, and it researches live offers across Amazon, Best Buy, Walmart, and Target — then delivers a complete report: 3–5 top picks with current prices, ratings, pros & cons, and direct purchase links. No more guessing, no more tab-hopping.
✨ What you can ask
| You say | You get |
|---|---|
| "Find noise-cancelling headphones under $200" | Top 5 picks, prices, links |
| "Birthday gift for a photographer, budget $200" | Thoughtful picks for their use case |
| "55-inch TV for a bright living room, under $800" | Recommendations matched to your room |
| "Compare gaming laptops around $1000, $1500, $2000" | Side-by-side picks at each budget |
| "I prefer Apple accessories, now find me earbuds under $180" | Recommendations that remember you |
🚀 Install
Codex
codex plugin marketplace add https://github.com/shopfox-ai/shopfox-shopping-mcp-plugin.git
codex plugin add shopfox-shopping@shopfox-shoppingThen type @shopfox in Codex. The first time you use it, Codex opens a Shopfox
sign-in page in your browser (OAuth) — no keys to copy.
Claude Code
claude plugin marketplace add shopfox-ai/shopfox-shopping-mcp-plugin
claude plugin install shopfox-shopping@shopfoxClaude Code asks for your Shopfox API key when it enables the plugin. Get one in one click at https://www.shopfox.ai/user-info?createApiKey=1 (sign in or sign up, the key is created automatically and shown once).
Any other MCP client (Cursor, Windsurf, ChatGPT, …)
Add a remote MCP server:
| Setting | Value |
|---|---|
| URL | https://mcp.shopfox.ai/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth (automatic), or Authorization: Bearer sk_shopfox_… with a key from the link above |
Then ask your first question:
"Find me noise-cancelling headphones under $200"
📖 What happens next
Your AI will return a complete shopping report — don't settle for less:
- 3–5 specific products, each with:
- Real current price and the store that has it
- A direct purchase link
- Why it's worth it (and what to watch out for)
- A clear recommendation for your budget and use case
A full report takes a few minutes to research. The full report is the answer. If your AI tries to summarize it into one pick or just hands you a link, ask it to show you the whole report.
🔒 Your privacy
- Your sign-in or key is stored on your device and only sent to shopfox.ai
- Searches are processed server-side and not stored long-term
- Your preferences are private to your account
- Privacy policy · Terms of service
❓ Frequently asked
Is it free? Yes — sign up in one click, no card required.
What can it shop for? Anything sold on major US retailers (Amazon, Best Buy, Walmart, Target): electronics, home goods, gifts, and more.
Does it buy things for me? No — it researches and compares, you buy. We give you the best price and the link; checkout happens on the retailer's site.
Can it remember my taste? Yes — tell it your preferences once and it carries them across conversations.
Need help? support@shopfox.ai · GitHub Issues
🛠️ For developers
The plugin is a remote MCP server (Streamable HTTP) at https://mcp.shopfox.ai/mcp.
Layout of this repository
| Path | Purpose |
|---|---|
plugin.json, mcp.json | Portable Agent Plugins manifest (OpenAI / Codex / ChatGPT), OAuth via dynamic client registration |
.codex-plugin/plugin.json | Compatibility manifest for older Codex builds |
.agents/plugins/marketplace.json | Codex marketplace catalog (install from this repo) |
.claude-plugin/plugin.json, .mcp.json | Claude Code plugin manifest; the API key is collected through userConfig |
.claude-plugin/marketplace.json | Claude Code marketplace catalog (install from this repo) |
skills/shopping-advisor/SKILL.md | The skill that tells the agent how to use the tools |
agents/openai.yaml | Agent dependency declaration |
Authentication
- OAuth 2.1 with PKCE and dynamic client registration. Discovery:
https://mcp.shopfox.ai/.well-known/oauth-authorization-serverandhttps://mcp.shopfox.ai/.well-known/oauth-protected-resource. Scope:mcp:shopping. - Or a personal API key as a bearer token:
Authorization: Bearer sk_shopfox_…, created at https://www.shopfox.ai/user-info?createApiKey=1 (or Settings → Agent API in the Shopfox web app).
Tools
| Tool | When to use |
|---|---|
generate_shopping_report | One-shot full report (local agents, no timeout pressure) |
start_shopping_report | Async report + widget (hosts with short timeouts, e.g. ChatGPT) |
research_shopping_options | Structured options list, supports follow-up questions |
Rate limits: 100 requests/day per key, 3 concurrent requests per user.
Validate locally
claude plugin validate --strict .
codex plugin marketplace add "$PWD" && codex plugin add shopfox-shopping@shopfox-shoppingLicense: Apache-2.0
Questions fréquentes
Qu'est-ce que Shopfox Shopping ?
US shopping research with real prices, sellers, and purchase links from Amazon, Best Buy, Walmart.
Comment installer Shopfox Shopping ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http shopfox-shopping 'https://mcp.shopfox.ai/mcp' --header 'Authorization: <Optional. '\''Bearer sk_shopfox_...'\'' personal key from https://www.shopfox.ai/user-info?createApiKey=1. Leave empty to sign in with OAuth instead.>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Shopfox Shopping ?
Oui. Il attend Authorization, à renseigner dans sa configuration.
Shopfox Shopping est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient Shopfox Shopping ?
Il est publié par shopfox-ai. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.