GoodBarber Public Mcp

GoodBarber 技能

44 个由 AI 驱动的技能，可通过任何兼容 MCP 的客户端管理 GoodBarber 应用，涵盖电商、社区、会员和 CMS。

已列入 Smithery。

这些技能连接到 GoodBarber MCP 服务，为 AI 助手提供结构化工作流，用于管理产品、订单、客户、促销、订阅、内容、分析等，一切都可通过对话界面完成。

---

什么是技能？

技能是指令文件（.md），用于教会 AI 助手如何通过 MCP（模型上下文协议）使用 GoodBarber 应用的 API 执行特定任务。无需逐个手动调用 API 工具，技能会统筹完整工作流——从检索数据到生成格式化报告——只需一条自然语言请求即可完成。

例如，询问 “告诉我本月最畅销的商品” 会触发 shop-best-sellers 技能，该技能会自动获取订单和商品目录、计算排名，并返回格式化报告。

---

快速开始

选项 A — 安装为 Claude Code 插件

此仓库是一个 Claude Code 插件：它将 GoodBarber MCP 服务（.mcp.json）和 44 个技能打包在一起。

git clone https://github.com/goodbarber/goodbarber-skills.git
claude --plugin-dir ./goodbarber-skills

该插件列入社区市场后，也可以在任意会话中安装：

/plugin marketplace add anthropics/claude-plugins-community
/plugin install goodbarber@claude-community

首次调用 GoodBarber 工具时，Claude Code 会打开授权页面：粘贴你的 Public API key 并确认。详情请参阅 SETUP.md。

选项 B — 手动设置（任意 MCP 客户端）

1. 连接 GoodBarber MCP

你需要在客户端中将 GoodBarber MCP 服务添加为自定义连接器。该服务通过 Streamable HTTP 实现 MCP 2026-07-28 协议（早期握手时代的客户端仍可连接）。/mcp/sse 路径名称是历史遗留名称，仅为向后兼容而保留。

MCP 服务 URL：

设置	URL
单个应用	https://mcp.goodbarber.dev/mcp/sse
多个应用	https://mcp.goodbarber.dev/<app_id>/mcp/sse

如果你管理多个应用，请将 <app_id> 替换为你的 GoodBarber 应用 ID。

**身份验证：**GoodBarber MCP 服务使用基于浏览器的 OAuth 流程。

当 MCP 客户端连接到 MCP 端点时，可能会打开 mcp.goodbarber.dev 上的授权页面。在该页面上，系统会要求你粘贴 GoodBarber Public API key 并确认授权。请在应用的 GoodBarber 后台 Public API / MCP server 页面生成 Public API key。

重要：

• 请勿在浏览器中手动打开 /authorize URL。
• 请从 MCP 客户端开始，连接到 MCP 端点。
• 客户端会自动生成完整的授权请求参数（redirect_uri、client_id、state、code_challenge 等）。

如果你不带这些参数手动打开授权页面，身份验证将失败。

Claude Desktop（Cowork）：

1. 打开 Settings > Connectors
2. 点击 Add custom connector
3. 输入上方的 MCP 服务 URL
4. 连接器会打开 GoodBarber 授权页面 — 在那里粘贴你的 Public API key 并确认

Claude Code（CLI）：

# Single app
claude mcp add goodbarber --transport http https://mcp.goodbarber.dev/mcp/sse

# Multiple apps
claude mcp add goodbarber --transport http https://mcp.goodbarber.dev/<app_id>/mcp/sse

然后启动 Claude Code 会话 — 首次调用 GoodBarber 工具时，CLI 会在浏览器中打开 GoodBarber 授权页面。在那里粘贴你的 Public API key 并确认，以完成 OAuth 流程。

Cursor / VS Code / Windsurf：

将以下内容添加到 MCP 配置文件（.cursor/mcp.json、.vscode/mcp.json 等）：

{
  "mcpServers": {
    "goodbarber": {
      "url": "https://mcp.goodbarber.dev/mcp/sse"
    }
  }
}

客户端首次连接时，会在浏览器中触发 OAuth 流程 — 在 GoodBarber 授权页面上粘贴你的 Public API key 并确认。

Cline：

在 Cline 中打开 MCP Servers，选择 "Remote server"，传输方式选择 Streamable HTTP，URL 填写 https://mcp.goodbarber.dev/mcp/sse，或将以下内容添加到 cline_mcp_settings.json：

{
  "mcpServers": {
    "goodbarber": {
      "type": "streamableHttp",
      "url": "https://mcp.goodbarber.dev/mcp/sse",
      "disabled": false,
      "autoApprove": []
    }
  }
}

首次连接时，Cline 会在浏览器中打开 GoodBarber 授权页面 — 在那里粘贴你的 Public API token 并确认。配置中无需 API key，也无需环境变量。Agent 也可以参考 llms-install.md。

其他任何兼容 MCP 的客户端：

将客户端指向上方的 MCP 端点（Streamable HTTP）。GoodBarber MCP 服务遵循标准 MCP 协议，可与任何兼容的客户端配合使用。

2. 安装 skills

克隆此仓库，并仅复制适用于你的应用类型的 skills：

git clone https://github.com/goodbarber/goodbarber-skills.git

**注意：**以下示例使用 Claude 的本地 skills 目录（~/.claude/skills/）。如果你使用其他客户端，请将 skill 文件夹复制到该客户端指定的目录。

电商应用：

cp -r goodbarber-skills/skills/ecommerce/* ~/.claude/skills/

社区应用：

cp -r goodbarber-skills/skills/community/* ~/.claude/skills/

会员应用：

cp -r goodbarber-skills/skills/membership/* ~/.claude/skills/

CMS / 内容（任何包含内容版块的应用）：

cp -r goodbarber-skills/skills/cms/* ~/.claude/skills/

**提示：**CMS skills 可跨应用类型使用 — 请将其与任何包含内容版块（文章、日程、地图、图库、视频、音频）的应用类型一同安装。

**提示：**如果你的 GoodBarber 应用组合了多种类型（例如，电商 + 会员），请安装两个目录中的 skills。

**注意：**skill 目录名称带有所属类别前缀（shop-、community-、membership-、cms-），且彼此唯一，因此来自多个类别的 skills 可以放在同一目标目录中，不会发生冲突。

3. 验证

向你的 AI 助手提问：“你有哪些 skills？” — 它应该会列出已安装的 GoodBarber skills。

选项 C — 在 Grok Build 中安装

同一软件包也是 Grok Build 插件：.grok-plugin/plugin.json 列出了 44 个技能，.mcp.json 声明了 GoodBarber MCP 服务。

grok plugin install goodbarber/goodbarber-skills --trust

该插件在 xAI 插件市场上架后，可改为按名称安装（grok plugin install goodbarber --trust），也可以在 /marketplace 中选择它。

首次调用 GoodBarber 工具时，Grok 会在浏览器中打开授权页面：粘贴你的 Public API key 并验证。使用 /mcps 检查连接，使用 /skills 查看 44 个技能。详情请见 SETUP.md。

---

按应用类型划分的技能

电商（18 个技能）

目录与产品

技能	描述
shop-best-sellers	按指定时段的销量和收入对产品进行排名
shop-catalog-audit	检测不完整的产品信息（缺少图片、描述或变体）
shop-low-performers	找出销量为零或极低的产品
shop-orphan-products	查找未分配到任何集合的产品
shop-product-launch	引导创建完整产品，包含变体、图片和 SEO
shop-stock-check	审核库存水平——标记缺货和低库存商品
shop-reorder-planner	根据销售速度生成可直接提供给供应商的补货队列

订单与客户

技能	描述
shop-order-followup	待处理订单清单（待处理、待发货、待送达）
shop-customer-insights	将客户划分为 VIP、忠实客户、沉睡客户和一次性客户
shop-rfm-segmentation	根据最近消费时间、消费频率和消费金额对客户进行细分
shop-prospect-nurture	为潜在客户确定优先级并建议转化措施

促销

技能	描述
shop-promo-campaign	在一个工作流中创建促销代码并发送公告推送
shop-promo-performance-review	分析促销影响：活动开始前、进行中和结束后

分析与沟通

技能	描述
shop-traffic-report	应用级分析：页面浏览量、启动次数、会话数、平台
shop-kpi-monitor	基于阈值的每日/每周 KPI 健康状况提醒
shop-weekly-digest	自动生成每周业务回顾
shop-push-broadcast	撰写、预览、安排并向所有客户发送推送通知
shop-push-targeted	撰写、预览、安排并向特定客户或潜在客户发送推送

---

社区（5 个技能）

技能	描述
community-traffic-report	应用分析：按平台统计页面浏览量、启动次数和会话数
community-push-broadcast	向所有人或特定社区群组发送推送
community-push-targeted	向特定社区用户发送推送
community-device-landscape	平台分布、热门设备、操作系统版本
community-weekly-digest	每周社区活动回顾

---

会员（10 个技能）

订阅

技能	描述
membership-subscription-audit	活跃与已过期订阅、流失率、高风险订阅者、挽回机会
membership-expiration-calendar	即将到期的订阅时间线
membership-longest-subscribers	找出最忠实的长期订阅者
membership-internal-subscription-grant	创建、更新或撤销内部订阅

用户与分析

技能	描述
membership-prospect-followup	为会员转化优先跟进潜在用户
membership-traffic-report	应用分析：按平台统计页面浏览量、启动次数和会话数
membership-push-broadcast	向所有符合条件的用户发送推送通知
membership-push-targeted	向特定用户或订阅状态受众发送推送通知
membership-device-landscape	平台分布、热门设备和操作系统版本
membership-weekly-digest	每周会员业务回顾

---

CMS / 内容（11 个技能）

用于管理编辑内容的技能——文章、日程活动、地图兴趣点、照片图库、视频和音频。适用于任何包含 CMS 内容版块的 GoodBarber 应用。

创作与发布

技能	描述
cms-article-publish	引导创建完整文章：正文段落、分类、slug、排期和付费墙
cms-event-publish	创建日程活动，设置开始和结束日期时间、地点及正文内容
cms-place-publish	创建地图兴趣点（地址 + 坐标）并添加描述
cms-gallery-builder	批量上传图片到照片图库并设置标题和状态
cms-article-restructure	重新排序、清理并修正现有文章的正文段落

质量与治理

技能	描述
cms-content-audit	检查所有类型中不完整的内容（无封面、正文为空、缺少日期或坐标）
cms-draft-review	找出过时草稿和未完成内容，并推荐后续步骤
cms-paywall-audit	IAP 应用：检查高级内容是否提供合理的免费预览（accessTier、maxFreeParagraphs）
cms-stale-content-refresh	将陈旧文章排序，筛选出适合更新、重新推广或下架的内容

规划与回顾

技能	描述
cms-editorial-calendar	前瞻视图：已排期发布内容、即将举行的活动和即将过期的内容
cms-weekly-digest	按内容类型汇总本周已发布内容和下周排期

注意： weekly-digest、traffic-report、push-broadcast 和 push-targeted 这些名称会在不同应用类型中重复出现。CMS 技能的 frontmatter 中使用 cms- 前缀（例如 cms-weekly-digest）作为命名空间，以避免冲突——如果要从多个目录安装技能，请将它们放在单独的文件夹中。

---

使用示例

"Show me my best sellers this month"
→ best-sellers

"Any products running low on stock?"
→ stock-check

"Create a 20% promo code for summer and notify everyone"
→ promo-campaign

"How's my churn rate looking?"
→ subscription-audit

"Send a push to the Paris group: meetup Friday at 7pm"
→ push-broadcast (community)

"Send a push to Marie and Alex: your item is back in stock"
→ push-targeted (eCommerce)

"Notify expired subscribers about the renewal offer tomorrow at 9am"
→ push-targeted (membership)

"Give me my weekly digest"
→ weekly-digest

"Write and publish an article about our new opening hours"
→ article-publish (cms)

"What content is scheduled to go live next week?"
→ editorial-calendar (cms)

"Audit my content for missing covers and empty posts"
→ content-audit (cms)

---

设计原则

所有技能都遵循以下规则：

• 考虑分页 — 大型数据集会在服务端筛选，而不是盲目分页
• 模糊匹配 — 按名称提及产品或系列；技能会自动解析
• 工作流串联 — 每项技能都会推荐 2–3 个可接着运行的相关技能
• 未经确认不执行破坏性操作 — 所有修改都必须经过用户明确确认
• 结构化输出 — 每项技能都会返回格式化报告，而非一句话

---

兼容性

这些技能适用于任何兼容 MCP 的 AI 客户端，包括：

• Claude Desktop (Cowork)
• Claude Code (CLI)
• Cursor
• VS Code (Copilot, Claude, Cline 等)
• Windsurf
• Codex CLI
• Gemini CLI
• Grok Build (CLI)
• 任何支持 Model Context Protocol 的客户端

---

仓库结构

goodbarber-skills/
├── .claude-plugin/plugin.json
├── .grok-plugin/plugin.json   # Grok Build manifest (lists the 44 skills)
├── .mcp.json
├── README.md
├── SETUP.md
├── server.json        # manifest published to the official MCP registry (dev.goodbarber/goodbarber-public-mcp)
└── skills/
    ├── ecommerce/
    │   ├── shop-best-sellers/SKILL.md
    │   ├── shop-catalog-audit/SKILL.md
    │   ├── shop-customer-insights/SKILL.md
    │   ├── shop-kpi-monitor/SKILL.md
    │   ├── shop-low-performers/SKILL.md
    │   ├── shop-order-followup/SKILL.md
    │   ├── shop-orphan-products/SKILL.md
    │   ├── shop-product-launch/SKILL.md
    │   ├── shop-promo-campaign/SKILL.md
    │   ├── shop-promo-performance-review/SKILL.md
    │   ├── shop-prospect-nurture/SKILL.md
    │   ├── shop-push-broadcast/SKILL.md
    │   ├── shop-push-targeted/SKILL.md
    │   ├── shop-reorder-planner/SKILL.md
    │   ├── shop-rfm-segmentation/SKILL.md
    │   ├── shop-stock-check/SKILL.md
    │   ├── shop-traffic-report/SKILL.md
    │   └── shop-weekly-digest/SKILL.md
    ├── community/
    │   ├── community-device-landscape/SKILL.md
    │   ├── community-push-broadcast/SKILL.md
    │   ├── community-push-targeted/SKILL.md
    │   ├── community-traffic-report/SKILL.md
    │   └── community-weekly-digest/SKILL.md
    ├── membership/
    │   ├── membership-device-landscape/SKILL.md
    │   ├── membership-expiration-calendar/SKILL.md
    │   ├── membership-internal-subscription-grant/SKILL.md
    │   ├── membership-longest-subscribers/SKILL.md
    │   ├── membership-prospect-followup/SKILL.md
    │   ├── membership-push-broadcast/SKILL.md
    │   ├── membership-push-targeted/SKILL.md
    │   ├── membership-subscription-audit/SKILL.md
    │   ├── membership-traffic-report/SKILL.md
    │   └── membership-weekly-digest/SKILL.md
    └── cms/
        ├── cms-article-publish/SKILL.md
        ├── cms-article-restructure/SKILL.md
        ├── cms-content-audit/SKILL.md
        ├── cms-draft-review/SKILL.md
        ├── cms-editorial-calendar/SKILL.md
        ├── cms-event-publish/SKILL.md
        ├── cms-gallery-builder/SKILL.md
        ├── cms-paywall-audit/SKILL.md
        ├── cms-place-publish/SKILL.md
        ├── cms-stale-content-refresh/SKILL.md
        └── cms-weekly-digest/SKILL.md

---

使用 skills CLI 安装

skills CLI 可通过一条命令将这些技能安装到任何受支持的 Agent（Claude Code、Cursor、Codex、GitHub Copilot、Windsurf、Gemini CLI、Antigravity、Cline 等）中：

npx skills add goodbarber/goodbarber-skills

从列表中选择所需技能，或使用 --all 安装全部 44 项技能。这些技能会调用 GoodBarber MCP 服务，因此请先连接该服务（参见上文“安装 MCP 服务”）。

贡献

想要添加技能？在 skills/<app-type>/ 中创建一个包含 SKILL.md 文件的文件夹。请遵循现有格式：YAML frontmatter（name、description、compatibility）+ Markdown 指令，其中包含工具工作流、输入/输出约定和防护措施。

许可证

The Unlicense — 属于公有领域，不受限制。