用途：Publora API Skill 提供 Publora 社交媒体排程 API 的完整文档，适合在多个社交平台之间统一安排、发布和管理内容的场景，例如跨平台发布工作流、批量排程、媒体上传、LinkedIn 数据分析和互动管理。
主要能力：
- 帖子管理：/list-posts 列出帖子，/create-post 创建草稿、排程或立即发布，/get-post/:postGroupId 获取详情，/update-post/:postGroupId 修改内容、目标平台、时间或状态，/delete-post/:postGroupId 删除帖子。
- 发布方式：传 scheduledTime（ISO 8601 UTC）定时发布；传 publishNow: true 立即发布，不占用排程队列，但消耗每月发帖额度；同时传未来 scheduledTime 或 status: "draft" 会返回 400 PUBLISH_NOW_CONFLICT。PUT /update-post/:postGroupId 传 { "publishNow": true } 可将已有草稿或排程帖子立即发布。
- 媒体：/get-upload-url 获取预签名上传地址，/attach-media/:postGroupId 通过 download_url 与 file_id 附加文件（帖子保持草稿），/upload-instagram-cover 上传 Instagram Reel 封面，/upload-youtube-thumbnail 上传 YouTube 缩略图。
- 连接与限制：/platform-connections 列出已连接账号，/test-connection/:platformId 测试连接有效性，/platform-limits 获取各平台实时限制，/account-context 返回套餐、功能、月度与队列配额、最晚排程日期和允许平台。平台 ID 格式为 platform-id，例如 twitter-123456789、linkedin-Tz9W5i6ZYG。
- LinkedIn 分析与互动：/linkedin-post-statistics、/linkedin-account-statistics、/linkedin-followers、/linkedin-profile-summary 获取指标；/linkedin-reactions、/linkedin-comments、/linkedin-reshare 添加或删除反应、评论和转发；/linkedin-mentionables 列出可提及用户（付费套餐）。查询类型支持 IMPRESSION、MEMBERS_REACHED、RESHARE、REACTION、COMMENT，可用 ALL 一次获取。
- Mastodon 与 Bluesky 分析：/post-statistics 获取最多 50 条已发布帖子的互动数据，/profile-statistics 获取粉丝、关注和帖子数。
- Webhook：/webhooks 创建、列出、更新、删除和重新生成密钥；事件包括 post.scheduled、post.published、post.failed、post.demoted；token.expiring 已定义但当前不派发，不应依赖。
- 工作区：/workspace/users 列出、添加、附加和移除团队成员（需联系 support@publora.com 开通审批）。
- Agency 场景：提供 /company/platforms、/company/post-groups 及媒体预留与完成接口，用于按 Workspace ID 创建和更新 Agency 草稿。
使用方式：用户须先在 publora.com 注册（含免费套餐），在仪表盘通过 OAuth 连接社交账号（Channels → Add Channel），并在侧边栏 API 页面生成 API Key 后交给调用方。请求携带 x-publora-key: sk_YOUR_API_KEY；MCP 服务器改用 Authorization: Bearer sk_...。创建、更新和附加媒体可传 Idempotency-Key，同键同请求体重放原响应，同键不同请求体返回 422 IDEMPOTENCY_KEY_CONFLICT，处理中返回 409 IDEMPOTENCY_IN_FLIGHT，键按用户隔离并在 24 小时后过期。
时间与错误：scheduledTime 必须为未来时间。过去不足 5 分钟会钳制到服务器时间并在 200 响应中返回 warnings: [{ code: "SCHEDULED_TIME_COERCED", requested, effective }]；过去 5 分钟及以上当前同样钳制并警告，但按文档将于 2026-08-25 起改为返回 400 SCHEDULED_TIME_IN_PAST（生产配置可覆盖该日期）。应检查 response.ok，并依据机器可读 code 而非消息文本分支处理，如 SCHEDULED_TIME_IN_PAST、PLATFORM_SETTING_UNKNOWN、FIRST_COMMENT_INVALID、FIRST_COMMENT_PLATFORM_UNKNOWN、FIRST_COMMENT_TOO_LONG、INVALID_MEDIA_FILE 等。
适用场景：跨平台内容排程与发布、媒体附件管理、LinkedIn 数据与互动运营、发布状态通知集成、团队协作发布。
限制：账号注册、OAuth 连接和 API Key 生成无法程序化完成；免费套餐不含 X 平台且每月 15 条帖子，其他套餐价格与配额见文档表格；工作区功能需审批；token.expiring 事件当前不派发。更多端点细节见 docs/endpoints、docs/guides、docs/examples、docs/platforms。