SuperAPI AI 工具集

cursor-webhooks

编程与开发

查看项目

更新于 10-16 05:51

技能介绍

用途:该技能面向 Cursor Cloud Agent 的 Webhook 接入,用于搭建处理程序、调试签名校验失败,以及理解事件类型与负载结构。

主要能力:提供 Cursor 签名校验的 JavaScript 与 Python 实现;给出 Express Webhook 处理示例;说明常见事件类型,目前列出的是 statusChange(代理状态变化),常见用途为监控代理完成情况与处理错误;给出事件负载结构,包含 event、timestamp、id、status(FINISHED 或 ERROR)、source(repository、ref)、target(url、branchName、prUrl)与 summary 等字段。

必要用法:校验时需读取请求头 x-webhook-signature、x-webhook-id、x-webhook-event;签名为 sha256=xxxx 格式,需先按等号拆分并确认算法为 sha256,再用 HMAC-SHA256 对原始请求体计算十六进制摘要,并用恒定时间比较。Express 中必须使用 express.raw({ type: 'application/json' }) 保留原始请求体,且应在校验通过后再解析 payload。环境变量使用 CURSOR_WEBHOOK_SECRET。本地调试可安装 Hookdeck CLI 并执行 npx hookdeck-cli listen 3000 cursor --path /webhooks/cursor,无需账号,提供本地隧道与请求查看的 Web UI。

适用场景:Cursor Cloud Agent Webhook 处理程序开发、签名校验排查、状态变更事件的接收与处理。

限制与其他说明:资料未提供 Cursor 控制台的具体配置步骤细节、事件类型的完整清单、收费与价格信息,以及除 statusChange 外其他事件的处理方式;文档建议生产环境配合 webhook-handler-patterns 技能使用,以处理幂等、错误处理与重试逻辑。