用途:该技能用于管理 Bundle.social 上的社交账号连接,是其与各社交平台之间的桥梁,支持连接、断开账号及频道配置。
主要能力与用法:所有请求需携带 x-api-key 头,基础地址为 https://api.bundle.social。连接流程调用 POST /api/v1/social-account/connect 生成 OAuth URL,需用户浏览器访问授权,需参数 type、teamId、redirectUrl。断开用 DELETE /api/v1/social-account/disconnect。频道管理含 set-channel、unset-channel、refresh-channels,用于 Discord 服务器/频道、Slack 频道与 Reddit 子版块。维护类含 create-portal-link、connection-check、profile-refresh。查询类含 GET by-type、POST copy、GET to-delete。平台特定字段:Mastodon/Bluesky 需 serverUrl,Instagram 支持 instagramConnectionMethod(FACEBOOK 或 INSTAGRAM)。
适用场景:帮助用户识别平台枚举后生成 curl 示例(以 <your-api-key> 占位,切勿实际调用 API),解释 OAuth 流程,以及按连接、频道设置、维护、清理等常见模式操作。常见流程为:获取组织→创建团队→连接账号→用户授权→按类型验证账号。
限制:Bundle.social 不存储凭证,仅用 OAuth 令牌;执行前应阅读 references/README.md 与 references/04-social-account.md。错误处理:400 查 issues 数组,401 检查 API key,404 核对 ID 与团队,并关注平台特定错误信息。