SuperAPI AI 工具集

klaviyo

营销与增长

查看项目

更新于 10-16 02:36

技能介绍

用途:通过已安装的 klaviyo CLI 读取和管理用户的 Klaviyo 邮件与短信营销活动、简报、流程、订阅者列表和受众分群。连接后请求可访问完整受支持目录;写入、发送和删除操作需要 Hatch 审批。

主要能力:设置将目录分为八类能力——读取、营销内容、活动投递、流程、受众与订阅、目录与优惠券、跟踪与集成、删除。编辑内容不授予发送活动或删除数据的权限;每次审批仍会预览具体操作与输入。活动创建及活动/消息编辑会显示提交的受众、发件人、主题和消息(若存在);活动发送/取消与流程状态/操作审批也会显示可用的 Klaviyo 元数据,查找失败则保留原始输入。受众 ID 与收件人估算在可用时显示,不推断受众名称或保证送达数量。

使用方式:运行 klaviyo list-tools 查看精简的已审核工具目录,这些名称及其 Hatch 权限在连接前即可用;运行 klaviyo list-tools --name <tool-name> 查看单个已审核工具的实时输入 schema,提供方输出 schema 有意省略以限制发现范围。不要猜测工具名称或参数 schema。若 klaviyo status 报告 auth_status: not_connected,运行 klaviyo authorize-url 并仅分享返回的 connect_url。Klaviyo 要求 Owner、Admin 或 Manager 角色。不要在聊天中构造 OAuth URL 或请求令牌。

常用命令:klaviyo call-tool --help;klaviyo status;klaviyo list-tools [--name <tool-name>];klaviyo call-tool --name <tool-name> --arguments-json '<JSON object>';klaviyo account-details;klaviyo list-campaigns --channel <email|sms|mobile-push> [--page-cursor <cursor>];klaviyo list-flows [--page-cursor <cursor>] [--page-size <1-100>];klaviyo list-metrics [--page-cursor <cursor>]。

适用场景:目录覆盖稳定的远程活动、流程、受众、订阅、模板、图片、目录、事件、指标、报告、优惠券、标签、webhook、表单、评论、推送令牌和资料删除工具;Beta 与仅本地工具被排除。Klaviyo 的 MCP 支持发送活动,Hatch 的显式允许列表控制此处可调用的工具。若 list-tools --name 报告某已审核工具不可用,先检查连接再断定不支持。不要编造 schema 或用直接 API 调用绕过 CLI。

限制与注意:发送活动前先回读受众、消息内容和计划;发送与取消共享活动投递权限,与内容编辑分离。成功请求会启动异步任务,需检查 get_campaign_send_job 和 get_campaign 后再报告结果。cancel_campaign_send 可在 Klaviyo 允许时取消或还原为草稿,需回读状态;取消无法撤回已送达邮件。创建的草稿不会发送。流程方面,create_flow 使用编码的流程定义,保留返回的 ID;update_flow 会更改流程状态及其所有操作,变更前后读取 get_flow、get_flow_action 和 get_flow_message;使流程或操作生效可能开始投递消息。受众方面,使用 get_profiles_for_list 枚举列表成员;列表成员身份不授予或撤销营销同意,同意变更需用订阅工具;添加列表成员、订阅资料或创建事件可能触发流程,变更前检查相关流程。批量变更、合并和删除需确认目标集与后果;资料删除是永久性的;保留返回的任务 ID 并在声称完成前使用匹配的任务状态读取;任何不确定的写入或删除结果后,先检查状态再重试。assign_template_to_campaign_message 返回新的、消息拥有的模板副本,其 ID 与源不同,不要因此重试,用 get_campaign 配合 include=campaign-messages 验证;保留返回的 Klaviyo UI 链接(若存在)。