mcpField
S
sequenzy-email-marketing

sequenzy-email-marketing

github.com/davepoon营销与增长3.7k45 次安装今天更新
代码仓库

关于 sequenzy-email-marketing

用于通过 Sequenzy CLI 或 MCP 工具执行邮件营销操作的 Skill，面向处理邮件营销工作流的 Agent。它强调核实已实现的能力、变更前先检查，并明确说明不支持的操作。

主要功能

  1. 01已支持 CLI 工作流指南
  2. 02订阅者、营销活动和序列操作
  3. 03邮件内容生成与发送
  4. 04身份验证与控制台网址处理
  5. 05核查尚未实现的操作

适用场景

  1. 01查看订阅者、名单、公司或营销活动统计
  2. 02创建并安排营销活动或序列
  3. 03生成邮件、序列或主题行
  4. 04确认某项操作是否已实现

MCP 相关

该 Skill 要求通过 Sequenzy 的 MCP 源码确认 MCP 任务可用工具，并说明模板、营销活动、订阅者及应用网址相关的 MCP 操作。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/davepoon/buildwithclaude --skill sequenzy-email-marketing

安装后在 Claude Code 中输入/sequenzy-email-marketing确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
command-reference.md
use-cases.md

详细介绍

Sequenzy 邮件营销

概述

当任务是操作 Sequenzy，而不是修改 Sequenzy 的源代码时，使用此技能。对于受支持的工作流，优先使用 sequenzy CLI；如果任务通过 MCP 工具执行，则将 packages/mcp/src/tools/index.ts 视为 MCP 的事实依据；如果请求的工作流未接入当前实现，请明确指出。

基本规则

  1. 将 packages/cli/src/index.tsx 视为实际已接入命令的事实依据。
  2. 将 packages/cli/src/commands/ 和 packages/cli/src/api.ts 视为 CLI 行为、载荷结构和 API 路由的事实依据。
  3. 将 packages/mcp/src/tools/index.ts 视为 MCP 工具名称、参数和预检验证的事实依据。
  4. 不要承诺支持仅出现在文档或 --help 文本中、但没有对应实现的命令或工具。
  5. 交互式身份验证优先使用 sequenzy login，自动化场景优先使用 SEQUENZY_API_KEY。
  6. 在工作流允许的情况下，优先检查后再修改。

受支持的工作流

执行任何较复杂的操作前，请阅读 references/use-cases.md。目前已实现的 CLI 流程包括：

  • 登录和登出
  • 使用 whoami 检查本地身份验证状态或会话
  • 使用 account 检查账户
  • 使用 companies list|get|create 检查或创建公司
  • 查看统计概览，或按活动/序列 ID 查看统计数据
  • 订阅者的 list、add、get 和 remove；list 默认会获取所有页面，并支持按标签、细分和列表筛选
  • 列表的 list、create、add-subscribers，以及用于通过电子邮件地址、JSON、CSV 或换行文件批量填充列表的 import 别名
  • 标签的 list
  • 细分的 list、create 和 count，包括 --match any、嵌套筛选条件根节点、自定义事件筛选条件和已保存细分组合筛选条件
  • 模板的 list、get、create、update 和 delete；list 支持按标签筛选，create/update 接受标签、原始 HTML 或 Sequenzy 区块 JSON
  • 活动的 list、get、create、update（包括标签和回复地址更新）、schedule 和 test；list 支持按标签筛选，create 接受标签以及原始 HTML、Sequenzy 区块 JSON 或提示词生成的内容，update 接受标签以及原始 HTML 或 Sequenzy 区块 JSON，schedule 会返回审核预览链接
  • MCP 模板和活动工具在列出、创建和更新时支持标签；MCP update_campaign 还支持 replyTo 和 replyProfileId，MCP schedule_campaign 可安排草稿或已安排的活动
  • MCP search_subscribers 支持通过 list、listId 或 listName 筛选列表；MCP add_subscribers_to_list 每次调用最多接受 500 个电子邮件地址
  • 序列的 list、get、create、update、enable、disable、delete 和 cancel-enrollments；包括显式折扣操作步骤、按订阅者 ID 或事件属性字段值取消，以及在 update 中插入分支条件（标签、列表、细分、事件、已点击链接和字段）；事件和已点击链接分支检查可使用 activityScope（this_sequence、previous_email、ever）
  • 使用 generate email、generate sequence 和 generate subjects 进行 AI 生成
  • 使用 CLI urls、MCP get_app_urls，以及活动、序列、模板和公司结果中的 appUrls/url 字段生成仪表板 URL
  • 网站的 list、add、check 和 guide
  • 使用 api-keys create 创建 API 密钥
  • 通过模板或原始 HTML 发送一封事务性电子邮件

不受支持或仅为占位的工作流

即使某个名词存在，缺少的子命令仍视为不受支持。例如：通过当前 CLI 处理程序无法立即发送活动、暂停/取消活动、删除列表或修改标签。批量填充列表可通过 sequenzy lists add-subscribers 及其 sequenzy lists import 别名完成，而非通过 subscribers add。

执行模式

  1. 先使用 sequenzy whoami 检查身份验证，或确认已设置 SEQUENZY_API_KEY。
  2. 选择与使用场景相符且范围最窄的命令。
  3. 执行变更前，先验证 ID、收件人邮箱、主题、模板或内容输入。
  4. 直接说明 CLI 的限制，不要编造变通方案。
  5. 如果 CLI 不支持该工作流，说明次优方案是使用 Sequenzy 控制面板还是直接调用 API。
  6. 创建、检查或安排营销活动、序列、模板或公司时，如果用户可能需要查看或编辑，请展示工具/CLI 输出中 url、previewUrl 或 appUrls 提供的控制面板 URL。如有需要，可使用 sequenzy urls 或 MCP get_app_urls 生成。
  7. 指出对实际操作有影响的实现注意事项，例如 whoami 使用缓存的本地身份验证状态；创建序列既支持 --goal，也支持显式步骤模式；显式折扣步骤必须先接入 Stripe 才能激活；生成的序列最多包含 10 封邮件；当前后端中 campaigns test 是一个存根式成功路径；条件邮件内容需要使用块 JSON，而不是原始 HTML。

控制面板 URL

如果设置了 SEQUENZY_APP_URL，请将其用作控制面板的基础 URL；否则默认使用 https://sequenzy.com。

优先使用 CLI/MCP 结果中返回的实际 URL：

  • 序列编辑器：/dashboard/company/{companyId}/sequences/{sequenceId}
  • 营销活动编辑器：/dashboard/company/{companyId}/campaign/{campaignId}
  • 营销活动预览/审核：/dashboard/company/{companyId}/campaign/{campaignId}?step=review
  • 模板/邮件编辑器：/dashboard/company/{companyId}/emails/{emailId}
  • 设置：/dashboard/company/{companyId}/settings
  • 设置选项卡：/dashboard/company/{companyId}/settings?tab={tab}

常用设置选项卡包括 domain、tracking、localization、integrations、events、tags、goals、sync-rules、api-keys、widgets 和 team。

参考资料

评论

支持 Markdown