官方 AI Skill · v2026.05
紫薯通告 AI Skill
在 Claude Code / Cursor 里一句话接入紫薯通告 API。
webhook 接收端 / REST 客户端 / 增量同步脚本，AI 帮你写完。
无需安装 npm 包；解压后 AI IDE 自动识别。
三步上手
1. 下载 zip
点上方按钮拿到 zs-openapi.zip（也可以从 GitHub 仓 git clone）。
2. 解压到 AI IDE 的 skills 目录
用户级：~/.claude/skills/ （所有项目共享）；项目级：<你的项目>/.claude/skills/。Cursor 同理。
3. 在 Claude Code / Cursor 里说一句
「接入紫薯通告」「对接紫薯通告 API」「紫薯通告 webhook」等任一关键词即可激活，AI 会读 SKILL 后引导你拿凭证、选技术栈、生成代码。
示例对话
你> 帮我接入紫薯通告主动推 webhook，用 Node.js
AI> [读 SKILL.md → references/signature-algorithm.md → examples/webhook-receiver-node.ts]
要确认几件事：
1. webhook 路径（默认 /zs-webhook 行吗？）
2. WEBHOOK_SECRET 拿到了吗？
3. 落到 MySQL / Postgres / 消息队列？
你> 路径 /api/zs/blogger，落 PostgreSQL bloggers 表
AI> [生成 src/routes/zs-webhook.ts + .env.example + 验签中间件]本期集成
数据同步全量覆盖。下列能力 AI 收到关键词后会直接生成代码。
主动推 Webhook 接收端
Node.js + Express 5 或 Python + FastAPI，含 HMAC-SHA256 验签、时间戳防重放、(endpointId, runId, bloggerId) 幂等去重。
主动拉 REST 客户端
覆盖 10 个 /open-api/* 接口（self / bloggers / changes / stats / scraping-tasks / sync-runs），Node fetch 或 Python httpx，含 429 按 Retry-After 退避。
增量同步脚本
cursor + since 双游标轮询、JSON 文件持久化、异常恢复、cron 集成；变更的达人批量落业务库。
LOCAL 模式守卫
AI 在生成主动拉代码前主动告知 CLOUD/LOCAL 影响，避免开发者撞 403。
未来集成路线图
下列场景随平台 API 扩展同步进 SKILL。
报价检索
按粉丝量 / 类目筛选并拉报价
任务管理
远程触发刷新任务 / 查任务进度
成员管理
开通子账号 / 配额查询
薯苗 / 订阅查询
余额、消费、订阅状态
反馈与支持
发现 SKILL 生成的代码不对、关键词没激活、字段对不上？或者想让我们提前集成 「报价检索 / 任务管理」？写邮件给我们。