Shopbuddy

io.github.tmill313由 GitHub 帳號 tmill313 發布v0.3.1更新於 Oct 24, 2026

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

已驗證Streamable HTTP可網頁執行開發者工具商業與電商

概覽

AI 產生的概覽

Shop Buddy 讓 AI 代理安全修改 Shopify 主題：變更先進入暫存主題，經驗證與截圖比對後由店主一鍵核准。

可以做什麼
  • 開始變更：將線上主題複製為暫存主題，並拉取到伺服器端工作副本
  • 讀取、搜尋與寫入主題檔案，並以 Theme Check 驗證
  • 推送預覽到暫存主題，擷取行動裝置與桌機的變更前後截圖並附上白話說明
  • 提交變更並申請發布，向店主送出一個一鍵核准連結
  • 一鍵回復已發布的變更
適用情境
適合想讓 AI 編碼代理修改 Shopify 主題、又不直接動到線上商店，且需要驗證、視覺審查與發布前核准的情況。
執行需求
可使用託管的遠端端點（以瀏覽器登入並按下允許，無需金鑰），或以 npx 執行本機 CLI（需 Node.js，本機模式不需帳號）。已宣告 API 金鑰變數 SHOPBUDDY_API_KEY 與平台網址變數 SHOPBUDDY_API_URL；託管服務需要 OAuth 驗證。需要一個 Shopify 商店。
安裝前請注意
代理會寫入主題檔案並可上傳到暫存主題；發布需店主核准，但商店可開啟信任發布，讓低風險變更依請求直接發布。雖可回復，變更仍會進入商店。主題內容與截圖會交由第三方託管服務處理，請先查看其隱私權政策與條款。此服務為獨立產品，與 Shopify 無隸屬關係。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Shopbuddy，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.tmill313%2Fshopbuddy/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "shopbuddy": {
      "type": "http",
      "url": "https://getshopbuddy.vercel.app/api/mcp"
    }
  }
}

README

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

[Add to Cursor] [Add to VS Code] [npm]

bash
# 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-pluginclaude plugin install shopbuddy@shopbuddy-marketplace
# Codexcodex 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.

來源：README.md，提交 5207bab

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v0.3.1最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分