SuperAPI AI 工具集

buttondown

办公与效率

查看项目

更新于 10-16 05:05

技能介绍

用途:该技能让代理通过 Buttondown 新闻通讯平台的 REST API 执行标签、自动化、订阅者和邮件等资源的增删改查操作。

认证与基础:所有请求需用户 API 密钥,从 https://buttondown.com/requests 获取,通过环境变量 BUTTONDOWN_API_KEY 提供,请求头格式为 Authorization: Token $BUTTONDOWN_API_KEY。调用前先确认变量已设置,缺失时提示用户执行 export BUTTONDOWN_API_KEY="your-api-key-here"。基础地址为 https://api.buttondown.com/v1,所有路径相对该地址。

调用方式:统一使用 curl,GET 用于列表/获取,POST 创建,PATCH 更新,DELETE 删除,并可用 jq 格式化输出。列表接口分页返回 count、next、previous、results,需沿 next 直到 null 获取全部结果。

主要能力:标签支持列表、创建(name 与 color 必填,description 可选)、获取、更新、删除。自动化由触发器、可选过滤器和动作组成,可创建、获取、更新、删除,状态分 active 与 inactive;动作类型包括发送邮件、添加标签、发送 webhook、发布到社交平台、发送 Discord 邀请,且可立即或延迟执行。订阅者接口支持列表、创建(email_address 必填)、更新(可用 ID 或邮箱)、删除。邮件接口支持列表、创建、获取,正文格式可自动识别或用注释显式指定。

限制与注意:执行 DELETE 或批量更新等破坏性操作前应先向用户展示并确认;创建/更新失败时读取响应体错误信息并清晰转达;ID 为 UUID,用户按名称指代时先列表匹配;邮件正文以 YAML frontmatter 开头会被拒绝,需加 X-Buttondown-Live-Dangerously: true 绕过;将订阅者类型从 premium 改为 unsubscribed 会取消其 Stripe 订阅。