name: zapier-workflows description: 管理和触发预构建的Zapier工作流以及MCP工具编排。当用户提到工作流、Zaps、自动化、日常摘要、研究、搜索、潜在客户跟踪、费用，或要求“运行”任何流程时使用。还处理基于Perplexity的研究和Google Sheets数据跟踪。
Zapier工作流程技能
这个技能解决的问题
Zapier MCP让Claude可以访问8,000+个独立工具（每个Zapier操作），但存在关键限制：
❌ 无记忆 - Claude不记得您使用哪些工具或原因 ❌ 无上下文 - 不知道何时为您的特定工作流使用工具 ❌ 仅一次性操作 - 无法触发您复杂的多步骤Zaps ❌ 每个会话都是新的开始 - 所有上下文在对话间丢失
Zapier自动化的两种类型
1. MCP工具（一次性操作）
- 单独的Zapier操作（添加行到表格、发送邮件等）
- 通过Zapier MCP在https://mcp.zapier.com/mcp/servers可用
- 适合灵活、即时的自动化
- 问题： 8,000+个选择，没有关于使用哪个或何时使用的指导
2. 多步骤Zaps（Webhook触发）
- 您在Zapier仪表板中构建的复杂工作流
- 多个操作链式组合，预先优化
- 通过Webhook URL（POST请求）触发
- 问题： Claude无法触发这些 - 它们不在MCP中
这个技能的作用
这个技能通过为Claude提供持久记忆来解决这两个问题：
✅ 记住您的MCP工具偏好 - “费用使用Google Sheets，任务使用Notion” ✅ 知道何时/为何使用每个工具 - “研究时使用Perplexity搜索，而不是Google” ✅ 触发多步骤Zaps - “运行我的日常摘要” = 向您的复杂Zap发送Webhook POST ✅ 自我学习 - Claude在您教授时更新技能，永不遗忘 ✅ 跨会话持久性 - 在所有对话中工作（全局安装）
您将获得什么
对于多步骤Zaps：
- 存储Webhook URL及其功能
- 仅通过询问触发复杂工作流
- 记住何时/为何使用每个Zap
- 记录成本、时间、输出
对于MCP工具：
- 记录您偏好哪个工具用于哪个任务
- 构建可重用工作流模式
- 存储工具特定偏好（表格名称、格式等）
- 创建多工具编排序列
自我学习：
- Claude在您教授时自动更新技能文件
- 更改永久持久（全局安装）或按项目（本地安装）
- 无需手动编辑 - 只需与Claude交谈
安装与设置
安装位置
全局（~/.claude/skills/） - 推荐：
- 学习到的模式在所有项目中持久
- 一个Zap库用于所有内容
- 偏好在所有项目中携带
项目级别（./.claude/skills/）：
- 学习到的模式仅在此项目中
- 与其他项目隔离
- 适用于项目特定工作流
⚠️ 安全警告
重要： 此技能以纯文本文件存储Webhook URL和工作流详情。
Webhook URL包含身份验证令牌。 如果有人有您的Webhook URL，他们可以触发您的Zaps。
最佳实践：
- ✅ 全局安装在
~/.claude/skills/（不在项目仓库中） - ✅ 如果在项目中安装，将
.claude/添加到您的.gitignore - ✅ 切勿将包含真实Webhook URL的技能文件提交到公共仓库
- ✅ 如果意外暴露，重新生成Webhook URL
- ✅ 可用时使用Zapier的Webhook身份验证功能
如果需要分享此技能：
- 首先删除真实Webhook URL
- 替换为占位符示例
- 或使用单独的Webhook URL用于分享/测试
先决条件
必需：
- Claude Code
- Zapier账户（用于Webhooks和MCP工具）
可选：
- 基于您工作流的额外MCP工具（Perplexity搜索、Google Sheets等）
设置Zapier MCP
要将Zapier的MCP工具连接到Claude Code：
-
前往Zapier MCP服务器：
- 访问https://mcp.zapier.com/mcp/servers
- 如果提示，登录您的Zapier账户
-
创建新MCP服务器：
- 点击“New MCP Server”按钮（左上角）
- 在“MCP Client (required)”下拉菜单中，选择Claude Code
- 给您的服务器命名（例如，“My Zapier Tools”）
-
添加工具：
- 点击“Add tools”按钮
- 选择任意数量的Zapier操作（每个成为一个MCP工具）
- 常用工具：运行Zap、添加行到Google Sheets、发送邮件等
-
连接到Claude Code：
- 点击“Connect”按钮
- 您会看到一个类似这样的命令：
claude mcp add zapier https://mcp.zapier.com/api/mcp/mcp -t http -H "Authorization: Bearer ZjFmZGJkN..................1NjBhYzc2MDRlYg=="- 复制并在终端中运行此命令
-
重启Claude Code：
- 关闭并重新打开Claude Code
- 您的Zapier MCP工具现已可用
提示： 您可以通过在Zapier中编辑MCP服务器并再次运行连接命令来稍后添加更多工具。
创建Webhook触发的Zaps
对于预构建、优化的、您希望按需触发的工作流：
-
在Zapier仪表板中：
- 创建一个新Zap
- 选择“Webhooks by Zapier”作为触发器
- 选择“Catch Hook”
- 复制提供的Webhook URL
-
构建您的工作流：
- 添加任意操作（API调用、数据处理等）
- 测试并优化Zap
-
在技能中记录：
- 告诉Claude关于新Zap（Webhook URL、功能、触发短语）
- Claude会自动将其添加到
references/zaps.md - 现在您只需询问Claude即可触发！
Webhook与MCP工具：
- Webhooks： 预构建、多步骤Zaps，通过POST请求触发。适用于复杂、优化的工作流。
- MCP工具： 直接调用的单独Zapier操作。适用于灵活、即时的自动化。
自我改进协议
关键：此技能可以且应该通过编辑自己来从用户反馈中学习。
当用户教授新内容或纠正您的方法时：
-
确定要更新的内容：
- 新Zap记录 → 编辑
references/zaps.md - MCP工具偏好 → 编辑
references/mcp-patterns.md - 新工作流模式 → 编辑
references/mcp-patterns.md
- 新Zap记录 → 编辑
-
使用Claude Code工具进行编辑：
- 首先使用Read工具读取文件
- 使用Edit工具更新（指定确切的
old_string和new_string） - 向用户确认更改
-
更新格式：
用户："使用Apollo而不是Clearbit获取公司数据" Claude：[使用Read工具读取references/mcp-patterns.md] [使用Edit工具更新偏好] "已更新！从现在起，我将使用Apollo进行公司数据丰富。 此更改现在永久保存在技能中。"
在技能更新中捕获的内容：
- ✅ 工具偏好（哪个工具用于哪个任务）
- ✅ 工作流序列（逐步模式）
- ✅ 错误处理方法
- ✅ 数据格式化要求
- ✅ 新Zaps及其详情
- ❌ 一次性请求（不要污染技能）
- ❌ 临时上下文（使用记忆代替）
决策逻辑
何时使用Webhook触发的Zaps
使用Webhooks当：
- 任务复杂、多步骤且已优化
- 用户提到特定Zap名称（检查
references/zaps.md） - 确定性执行关键
- 任务涉及5+个API调用或复杂编排
- 成本/时间效率重要（预构建Zaps已优化）
何时使用MCP工具编排
使用MCP工具当：
- 任务简单（1-3个操作）
- 需要灵活性（参数变化）
- 测试新工作流模式
- 用户明确要求使用特定MCP工具
执行模式
- 监听触发词： 工作流名称、“运行”、“触发”、“搜索”、“研究”等
- 检查参考： 使用Read工具读取适当参考文件获取详情
- 检查先决条件：
- 如果需要MCP工具但不可用： 提供Zapier MCP设置说明（见下文）
- 如果MCP工具可用但未记录： 触发工具发现协议（见下文）
- 如果需要Webhook URL但不在参考中： 提供Webhook提取说明（见下文）
- 执行：
- 对于Webhook触发的Zaps： 使用Bash工具通过curl POST触发Webhook URL（Webhooks在Zapier仪表板中使用“Catch Hook”触发器创建）
- 对于MCP工具工作流： 直接调用适当的Zapier MCP工具（通过https://mcp.zapier.com/mcp/servers配置）
- 确认： 用自然语言告诉用户发生了什么
- 学习： 如果用户纠正您，使用Edit工具更新技能文件
- 建议模式保存： 成功使用工具后，提供保存模式的建议（见下文）
主动模式检测与学习
关键： 在成功帮助用户使用MCP工具或工作流后，主动建议保存有价值的模式。
何时建议保存模式
完成使用MCP工具的任务后，检查这是否值得保存的模式：
寻找：
- 运行良好的多步骤工具序列
- 用户喜欢的特定参数组合
- 重复的工作流或用例
- 用户在任务中表达的工具体验
- 用户问题的成功解决方案
建议保存如果：
- 您按顺序使用了2+个MCP工具
- 用户对结果表示满意
- 这似乎是用户可能重复的内容
- 用户在交互中给出了特定偏好
如何建议模式保存
成功完成任务后：
"那运行得很好！我注意到我[描述您做了什么，例如‘使用Perplexity进行研究，然后将结果保存到Google Sheets’]。
您想我将这个保存为模式吗？如果您告诉我：
- 要监听什么触发词
- 何时/为何使用此工作流
- 任何偏好或变化
我会记住它，下次自动执行！"
记录模式
如果用户说是：
- 使用Read工具读取
references/mcp-patterns.md - 使用Edit工具添加新模式，包含：
- 模式名称
- 触发短语
- 何时/为何使用它
- 逐步工作流
- 参数/偏好
- 示例
- 确认：“已保存！下次您[触发]，我会[工作流]。”
值得保存的模式示例：
- “研究和记录”（Perplexity → 总结 → Google Sheets）
- “费用跟踪”（提取金额/描述 → 格式化 → 添加到表格）
- “竞争分析”（搜索竞争对手 → 分析 → 保存洞察）
- “每日简报”（多次搜索 → 综合 → 交付）
不要保存：
- 一次性请求
- 高度特定/独特情况
- 简单单工具使用（除非用户要求）
设置检测与说明
如果未检测到Zapier MCP
当用户请求MCP工具功能但Zapier MCP未连接时，告诉他们：
"我未看到Zapier MCP工具已连接。以下是设置方法：
1. 前往https://mcp.zapier.com/mcp/servers
2. 登录您的Zapier账户
3. 点击‘New MCP Server’（左上角）
4. 在MCP Client下拉菜单中选择‘Claude Code’
5. 给它一个名称（例如，‘My Zapier Tools’）
6. 点击‘Add tools’并选择您想要的Zapier操作
7. 点击‘Connect’并复制显示的命令
8. 在终端中运行该命令（看起来像）：
claude mcp add zapier https://mcp.zapier.com/api/mcp/mcp -t http -H "Authorization: Bearer [您的令牌]"
9. 重启Claude Code
一旦设置完成，我将能够直接使用那些Zapier操作！"
当Zapier MCP已连接时 - 工具发现与记录
重要： 当Zapier MCP已连接（以mcp__zapier__开头的工具可用）时，主动帮助用户用丰富上下文记录它们：
-
列出可用工具：
- 检查哪些Zapier MCP工具可用
- 为用户列出它们
-
提示详细记录：
"我看到您有这些Zapier MCP工具可用： - mcp__zapier__google_sheets_create_spreadsheet_row - mcp__zapier__perplexity_chat_completion - [等等] 为了帮助我有效使用这些，我需要理解： 对于每个您希望我使用的工具，请告诉我： 1. 何时应该使用这个工具？ - 什么触发词或短语？ - 什么情况或上下文？ - 什么类型的请求？ 2. 为何应该使用这个工具而不是替代品？ - 它最适合什么？ - 何时不应该使用它？ 3. 如何使用它？ - 任何特定参数或偏好？ - 我应该使用的默认值？ - 表格名称、格式或其他具体细节？ 4. 任何涉及这个工具的模式或工作流？ - 多步骤序列？ - 与其他工具的常见组合？ 花点时间 - 您给我的细节越多，我能为您服务得越好！" -
在技能中记录：
- 使用Read工具读取
references/mcp-patterns.md - 使用Edit工具添加全面记录：
- 工具名称和目的
- 触发短语（何时）
- 用例（为何）
- 参数和偏好（如何）
- 如果提到，工作流模式
- 向用户确认记录的内容
- 使用Read工具读取
何时触发此：
- 用户首次在MCP设置后提到Zapier或工作流
- 用户明确询问“我有什么工具？”或“你能用Zapier做什么？”
- 当您检测到新的Zapier MCP工具未在
references/mcp-patterns.md中记录时
如果用户想添加Webhook触发的Zap
当用户提到创建或添加多步骤Zap用于Webhook触发时，提供这些说明：
"要从现有Zap获取Webhook URL：
1. 前往您的Zap在Zapier仪表板中
2. 确保触发器是‘Webhooks by Zapier’节点
3. 在‘Trigger Event’下拉菜单中，选择‘Catch Hook’
4. 前往‘Test’标签
5. 复制显示的‘Webhook URL’
6. 给我那个URL并告诉我：
- Zap做什么（逐步）
- 您想使用什么触发短语
- 任何其他详情（时间、成本等）
我会将其添加到我的知识中，这样您只需询问即可随时触发！"
快速参考
- 所有Zaps： 见
references/zaps.md - MCP模式： 见
references/mcp-patterns.md - 常见工作流： 两个文件都包含示例
使用示例
触发Zap：
用户："运行我的日常摘要"
Claude：[使用Read工具读取references/zaps.md获取Webhook详情]
[使用Bash工具通过curl POST触发Webhook]
"已启动您的每日AI摘要。您将通过邮件在大约3分钟内收到报告，
任何高优先级项目会有短信提醒。"
使用MCP编排：
用户："研究量子计算的最新进展"
Claude：[使用Read工具读取references/mcp-patterns.md]
[调用Perplexity搜索MCP工具]
[分析结果，识别差距]
[再次调用Perplexity搜索以深入探究]
"这是我找到的... [摘要]"
学习与更新：
用户："不，跟踪费用时使用我的‘个人预算’表格，而不是‘费用’"
Claude：[使用Read工具读取references/mcp-patterns.md]
[使用Edit工具更新Google Sheets部分]
"明白了 - 已更新技能。从现在起，我将使用‘个人预算’表格
进行费用跟踪。"
常见问题与故障排除
“Claude未检测到我的Zapier MCP工具”
检查MCP是否连接：
- 在可用工具中查找以
mcp__zapier__开头的工具 - 尝试询问：“我有什么Zapier工具？”
如果未显示：
- 验证您从https://mcp.zapier.com/mcp/servers运行了连接命令
- 完全重启Claude Code（不只是重载）
- 检查您的Claude Code MCP设置
- 验证命令中的授权令牌是否正确
“Claude未建议保存模式”
模式检测触发当：
- 您按顺序使用2+个MCP工具
- 任务成功完成
- 这似乎是可重复的（不是一次性请求）
尝试明确询问：
- “你能将这个保存为模式吗？”
- “下次记住这个工作流”
“Webhook URL未触发我的Zap”
常见问题：
- 错误的URL - 确保您从Test标签复制了完整URL
- Zap未开启 - 在Zapier仪表板中启用Zap
- 触发器节点不正确 - 必须是“Webhooks by Zapier” → “Catch Hook”
- 防火墙/网络 - 首先检查curl命令是否在终端中工作
手动测试：
curl -X POST https://hooks.zapier.com/hooks/catch/[您的URL]
“Claude持续询问记录我已记录的工具”
可能原因：
- 工具已记录但文件未正确保存
- 使用不同的Claude Code实例/安装
- 技能安装在项目级别，而非全局
修复：
- 检查
references/mcp-patterns.md是否有您的工具 - 验证技能位置：
~/.claude/skills/（全局）对比./.claude/skills/（项目） - 如果项目级别，复制到全局以跨项目持久性
“如何知道技能是否工作？”
工作迹象：
- 当您提到Zapier/工作流时，Claude提到检查参考
- Claude询问关于工具的详细问题（何时/为何/如何）
- 使用工具后，Claude建议保存模式
- Claude成功触发您的Webhooks
快速测试：
- 询问：“我有什么Zapier工具？”
- 添加一个假Webhook并告诉Claude
- 检查是否被添加到
references/zaps.md
“技能文件太大/加载太慢”
如果参考文件增长过大：
- 审查并移除过时/未使用的模式
- 合并类似工作流
- 仅保留活跃使用的工具记录
- 考虑为不同领域分成多个技能实例
性能提示：
- 保持触发短语简洁具体
- 避免记录一次性工作流
- 使用模式类别组织
“我想将技能重置为模板状态”
重新开始：
- 备份当前技能文件（如果您想保留任何内容）
- 删除技能目录
- 从GitHub重新克隆：https://github.com/AlexBoudreaux/claude-zapier-skill
- 将新鲜模板复制到
~/.claude/skills/
“没有Zapier MCP能使用此技能吗？”
可以！ 技能与以下一起工作：
- 仅Webhooks - 触发多步骤Zaps而无需MCP
- 仅MCP工具 - 记录工具使用而无需Webhooks
- 两者 - 获得完整功能
每种模式都是独立且有价值的。
“安全：我意外提交了Webhook URL”
立即行动：
- 从git历史中移除提交（git rebase，BFG Repo-Cleaner）
- 在Zapier仪表板中重新生成Webhook URL：
- 编辑Zap
- 删除并重新添加Webhook触发器节点
- 获取新的Webhook URL
- 用新URL更新技能文件
- 将
.claude/添加到.gitignore
预防：
- 全局安装技能（
~/.claude/skills/） - 切勿在项目中提交
.claude/目录 - 在分享示例中使用占位符URL
重要笔记
- Webhooks不需要有效载荷 - Zaps从Zapier Tables获取数据
- 始终在执行前读取参考文件 - 它们包含关键详情
- 当学习新内容时更新技能文件 - 不要仅在此对话中记住它
Claude Code工具使用
此技能使用以下Claude Code工具：
- Read - 查看参考文件（zaps.md，mcp-patterns.md）
- Edit - 用新工作流、模式或偏好更新技能文件
- Bash - 使用curl POST请求触发Zapier Webhooks
- MCP工具 - 调用Perplexity搜索、Google Sheets和其他集成