Author: Anton Gulin · Tool: opencode-skill-creator · GitHub: @antongulin · Registry: skills.sh
Bundle.social Comments
This skill covers managing comments and importing comment threads on Bundle.social.
Authentication
x-api-key: <your-api-key>
Base URL: https://api.bundle.social
Reference Docs
Read references/README.md for platform enums and standard errors.
Read references/08-comment.md for endpoint details.
How to Use This Skill
When a user asks to manage comments or import comment threads:
- Identify the operation — CRUD on individual comments, or bulk import of comment threads
- Read the reference doc for the relevant endpoint
- Generate curl command examples with
<your-api-key>as placeholder (NEVER call the actual API) - For imports, guide the user through the multi-step flow
Comment Import Flow
Importing comment threads is a multi-step async process:
- Start import:
POST /api/v1/comment/importwithpostIdandteamId - Monitor progress:
GET /api/v1/comment/importto see import jobs and their status - Check specific job:
GET /api/v1/comment/import/{importId} - Retrieve results:
GET /api/v1/comment/import/commentsto get all fetched comments
Import statuses: PENDING, FETCHING, RETRYING, COMPLETED, SKIPPED, FAILED, RATE_LIMITED
Endpoint Reference Summary
Comment CRUD
GET /api/v1/comment/— List comments (filterable byteamId,postId,platform,socialAccountId)POST /api/v1/comment/— Create a new comment (platform-specific payload)GET /api/v1/comment/{id}— Get single commentPATCH /api/v1/comment/{id}— Update commentDELETE /api/v1/comment/{id}— Delete comment
Comment Import
POST /api/v1/comment/import— Start comment import for a postGET /api/v1/comment/import— List import jobsGET /api/v1/comment/import/{importId}— Get import job by IDGET /api/v1/comment/import/comments— Get fetched comments for a post
Common Patterns
- Comment moderation workflow: List comments by post → Read individual comments → Reply or delete
- Import workflow: Start import → Poll status until COMPLETED → Retrieve comments
- Filtering: Use platform filter to see comments from specific platforms; use postId to narrow to specific content
- Rate limits: Comment imports can hit platform rate limits — watch for
RATE_LIMITEDstatus and retry
Platform Support for Comments
Comment operations are supported on: Facebook, Instagram, LinkedIn, YouTube, TikTok, Reddit, Threads, Mastodon, Bluesky