English Français العربية

io.github.tmill313/shopbuddy

السجل الرسمي التجارة الإلكترونية

Safe Shopify theme changes for AI agents: staging, validation, visual review, approval, rollback.

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

التثبيت

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

Remote (streamable-http)
Claude Code 
claude mcp add --transport http shopbuddy 'https://getshopbuddy.vercel.app/api/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "shopbuddy": {
            "type": "http",
            "url": "https://getshopbuddy.vercel.app/api/mcp"
        }
    }
}
NPM package shopbuddy
Claude Code 
claude mcp add shopbuddy -e 'SHOPBUDDY_API_URL=<SHOPBUDDY_API_URL>' -e 'SHOPBUDDY_API_KEY=<your shopbuddy_api_key>' -- npx -y shopbuddy@0.3.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "shopbuddy": {
            "command": "npx",
            "args": [
                "-y",
                "shopbuddy@0.3.0",
                "mcp"
            ],
            "env": {
                "SHOPBUDDY_API_URL": "<SHOPBUDDY_API_URL>",
                "SHOPBUDDY_API_KEY": "<your shopbuddy_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • SHOPBUDDY_API_URL Platform URL
  • SHOPBUDDY_API_KEY سري API key from the platform's Install page

التوثيق

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

المحتويات
  1. Shop Buddy
  2. How it works
  3. What is in this repo
  4. Privacy and terms

Shop Buddy

Let your AI coding agent change your Shopify theme safely. Every edit lands on an unpublished staging theme. Shop Buddy validates it with Theme Check, screenshots before/after on mobile and desktop with a plain-language summary of what changed, and you approve with one tap. Rollback is one tap. The live theme is never edited directly.

Site and one-click install: **https://getshopbuddy.vercel.app/install**

# Claude Code (hosted MCP, signs in through your browser)
claude mcp add --transport http shopbuddy https://getshopbuddy.vercel.app/api/mcp

# Claude Code plugin (adds the skill too)
claude plugin marketplace add tmill313/shopbuddy-plugin
claude plugin install shopbuddy@shopbuddy-marketplace

# Codex
codex mcp add shopbuddy --url https://getshopbuddy.vercel.app/api/mcp

# Local CLI (no account needed for local mode)
npx shopbuddy

Claude (web/desktop) and ChatGPT: add a custom connector with https://getshopbuddy.vercel.app/api/mcp. The agent opens a browser tab; sign in or create an account there and click Allow. No keys.

How it works

  1. shopbuddy_start_change duplicates the live theme into a staging theme and pulls it into a server-side working copy.
  2. The agent reads, searches and writes files, runs Theme Check with shopbuddy_validate, then shopbuddy_push_preview uploads to staging and captures before/after screenshots, each visual change attributed to its section.
  3. shopbuddy_submit and shopbuddy_request_publish hand the store owner a one-tap approval link. Owners can opt a store into trusted publishing so low-risk changes publish on request, always logged and one tap from shopbuddy_rollback.

Agent-readable summary: https://getshopbuddy.vercel.app/llms.txt

What is in this repo

This is the public companion to the hosted service: the Claude Code plugin and marketplace manifests, the shopbuddy skill, the MCP client config, and the MCP Registry manifest (io.github.tmill313/shopbuddy). The platform itself is a hosted service; the CLI ships compiled on npm as shopbuddy.

Privacy and terms

https://getshopbuddy.vercel.app/privacy · https://getshopbuddy.vercel.app/terms

Shop Buddy is an independent service, not affiliated with or endorsed by Shopify.

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

ما هو io.github.tmill313/shopbuddy؟

Safe Shopify theme changes for AI agents: staging, validation, visual review, approval, rollback.

كيف أثبّت io.github.tmill313/shopbuddy؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http shopbuddy 'https://getshopbuddy.vercel.app/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.tmill313/shopbuddy إلى مفتاح API؟

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

هل io.github.tmill313/shopbuddy مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.tmill313/shopbuddy؟

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

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