用途:在 Facebook、Instagram、LinkedIn、YouTube、TikTok、Reddit、Threads、Mastodon、Bluesky 等平台管理评论,包括评论的读取、创建、更新、删除,以及导入评论串。
主要能力:评论 CRUD(列表可按 teamId、postId、platform、socialAccountId 过滤;支持获取单条、更新、删除、创建平台特定载荷的评论)与评论导入(多步异步流程:POST /api/v1/comment/import 启动导入,GET 该路径查看任务与状态,GET /api/v1/comment/import/{importId} 查看指定任务,GET /api/v1/comment/import/comments 获取已抓取评论)。导入状态包括 PENDING、FETCHING、RETRYING、COMPLETED、SKIPPED、FAILED、RATE_LIMITED。
使用方式:认证使用 x-api-key: <your-api-key>,基础 URL 为 https://api.bundle.social。操作时先确认是单条评论 CRUD 还是批量导入,再查阅对应参考文档(references/README.md 中平台枚举与标准错误,references/08-comment.md 中端点细节),生成以 <your-api-key> 为占位符的 curl 示例,不要实际调用 API。导入时引导用户完成多步流程,并以轮询方式等待 COMPLETED 后获取评论。
适用场景:评论审核工作流(按帖子列出评论、阅读、回复或删除)、评论串批量导入、按平台或帖子过滤查看评论。
限制:评论导入可能触发平台速率限制,需关注 RATE_LIMITED 状态并重试;评论操作的具体平台支持范围限于上述列出平台。其余细节暂未提供。