用途:该技能用于自动化 Amazon KDP 后台操作。由于 Amazon 没有公开的 KDP 元数据 API,它借助保存的浏览器会话 Cookie 调用 KDP 内部页面与报告端点,由智能体自行完成全部任务,不要求用户执行终端命令。
主要能力:登录与会话状态检查、账户信息与报告目录、下载版税报告、将版税 Excel 解析为 JSON 摘要、拉取书籍元数据(全部或单本)、导出元数据到 Excel、审计关键词与分类、推送详情页修改、更新定价与 KDP Select、上传内文与封面 PDF、完整发布向导(创建到发布),以及取消发布、删除草稿、归档标题等写操作。
使用方式:先执行 npm install,必要时复制 .env.example 为 .env;用 npm run server:start 后台启动服务;任何同步、更新或下载前先运行 npm run status 检查会话。登录需用户在可见 Chromium 窗口中完成(含 MFA),之后轮询状态直到 connected: true。会话保存在 .kdp-session/ 目录。常用命令包括 npm run account:info、npm run bookshelf:list、npm run catalog:get、npm run download:report、npm run parse:report -- file.xlsx、npm run sync:metadata、npm run metadata:export、npm run metadata:analyze、npm run update:metadata -- file.json --dry-run、npm run publish:book -- spec.json --live 等。也可通过本地 REST API 调用读写端点。
限制与规则:写操作必须串行,一次只处理一本书,禁止并行发布、批量脚本或对多标题使用 /batch 端点,以避免超时、Server Busy 限流和会话冲突。服务端对每次请求按 KDP_REQUEST_DELAY_MS(默认 4 秒)限速,不可绕过。写操作前先对一本书 dry-run,未获用户明确确认不得设置 publish: true。不要提交 .kdp-session/ 或下载的 .xlsx 文件。写流程内置错误恢复与学习文件,发布响应可能包含 recoveryLog;重试耗尽后需根据错误修复底层问题。分类可通过浏览节点 ID 或模态路径选择器写入。具体字段、端点与排错细节见 references 目录。