English Français العربية

Shopfox Shopping

السجل الرسمي البحث والويب

US shopping research with real prices, sellers, and purchase links from Amazon, Best Buy, Walmart.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
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.>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "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.>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Shopfox Shopping
  2. ✨ What you can ask
  3. 🚀 Install
  4. 📖 What happens next
  5. 🔒 Your privacy
  6. ❓ Frequently asked
  7. 🛠️ For developers

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 sayYou 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-shopping

Then 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@shopfox

Claude 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:

SettingValue
URLhttps://mcp.shopfox.ai/mcp
TransportStreamable HTTP
AuthOAuth (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

PathPurpose
plugin.json, mcp.jsonPortable Agent Plugins manifest (OpenAI / Codex / ChatGPT), OAuth via dynamic client registration
.codex-plugin/plugin.jsonCompatibility manifest for older Codex builds
.agents/plugins/marketplace.jsonCodex marketplace catalog (install from this repo)
.claude-plugin/plugin.json, .mcp.jsonClaude Code plugin manifest; the API key is collected through userConfig
.claude-plugin/marketplace.jsonClaude Code marketplace catalog (install from this repo)
skills/shopping-advisor/SKILL.mdThe skill that tells the agent how to use the tools
agents/openai.yamlAgent dependency declaration

Authentication

  • OAuth 2.1 with PKCE and dynamic client registration. Discovery: https://mcp.shopfox.ai/.well-known/oauth-authorization-server and https://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

ToolWhen to use
generate_shopping_reportOne-shot full report (local agents, no timeout pressure)
start_shopping_reportAsync report + widget (hosts with short timeouts, e.g. ChatGPT)
research_shopping_optionsStructured 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-shopping

License: Apache-2.0

الأسئلة الشائعة

ما هو Shopfox Shopping؟

US shopping research with real prices, sellers, and purchase links from Amazon, Best Buy, Walmart.

كيف أثبّت Shopfox Shopping؟

يعمل كخادم بعيد. في 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.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Shopfox Shopping إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل Shopfox Shopping مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Shopfox Shopping؟

ينشره shopfox-ai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.