关于 otterkit
otterkit 提供 Agent Skills,指导 AI 编码 Agent 操作 OtterKit 隧道和 Webhook 端点。其工作流涵盖事件捕获、验证和重放,并支持 Stripe、GitHub、Shopify 和 Slack 的签名事件。
主要功能
- 01指导 Agent 管理隧道和 Webhook 端点
- 02捕获、检查并重放 Webhook 投递
- 03发送带有服务商签名的模拟事件
- 04根据签名密钥验证捕获的请求
- 05提供 Stripe、GitHub、Shopify 和 Slack 工作流
适用场景
- 01用模拟服务商事件测试本地 Webhook 处理程序
- 02检查并验证捕获的 Webhook 投递
- 03用更新后的签名重放捕获事件
- 04在 AI 编码 Agent 中配置 OtterKit 工作流
MCP 相关
OtterKit 也可通过 `claude mcp add otterkit -- npx otterkit mcp` 添加为 MCP 服务,提供与 Skills 相同的功能。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
11收录的工具列表 · 更新于 3 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ttl | string | 否 | 例如,45m、4h、3d 后自动停止(默认 24h,最长 7d) |
| respond | integer | 否 | 自动响应的 HTTP 状态码(默认 200) |
| standby | boolean | 否 | 如果守护进程崩溃或断开连接,仍保持端点运行:服务器自行提供自动响应并缓冲请求(最多 200 个),重连后将请求重放到日志中。断开连接期间仍会计费。 |
| subdomain | string | 否 | 稳定的预留子域名(首次使用时绑定到帐户) |
| respondBody | string | 否 | 自动响应正文(默认 {"received":true}) |
详细介绍
OtterKit Agent 技能
这些技能可教会 AI 编码 Agent(Claude Code、Cursor、Copilot——以及任何能读取 Agent Skills 格式的工具)使用 OtterKit:隧道和无服务器 Webhook 端点,支持捕获、签名验证和重放。
| 技能 | Agent 将学会什么 |
|---|---|
otterkit | 核心功能:隧道、Webhook 端点、捕获、检查、重放、守护进程、定价 |
stripe-webhooks | Stripe:带签名的合成事件、Stripe-Signature 验证、重新签名后重放 |
github-webhooks | GitHub Apps:持久捕获端点、X-Hub-Signature-256 验证、重放 |
shopify-webhooks | Shopify:CLI 的稳定 --tunnel-url、HMAC 验证、备用端点 |
slack-webhooks | Slack:通过捕获隧道接收 Events API 事件、签名密钥验证、重新签名后重放 |
安装(Claude Code)
将任意技能目录复制到项目中的 .claude/skills/(或复制到 ~/.claude/skills/,以供所有项目使用):
git clone https://github.com/useotterkit/skill && cp -r skill/stripe-webhooks .claude/skills/
也可以添加 OtterKit MCP 服务,它会将相同功能作为工具提供:
claude mcp add otterkit -- npx otterkit mcp
与普通隧道有何不同
每项技能都依赖三项 ngrok 同类工具不具备的功能:
otterkit send—— 针对本地处理程序发送带真实签名标头的合成提供商事件(stripe:payment_intent.succeeded、github:pull_request.opened等),免费,且无需与提供商账户交互。otterkit verify—— 根据签名密钥检查捕获的投递请求,逐个请求验证,并显示失败原因。otterkit replay --resign—— 将捕获的事件重新投递到本地代码,并使用当前时间戳重新签名,这样能够容忍时间戳的处理程序(Stripe、Slack)仍会接受该事件。
这些技能根据 CLI 的实际实现生成,并与 CLI 同步更新。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。