optimize-tweets

用途

optimize-tweets 用于在发布推文前，针对 X（Twitter）算法对草稿进行优化。它会对推文草稿进行评分，并给出有针对性的改写建议，帮助提升预测互动表现。该技能不负责发布推文。

主要能力

该技能提供两个核心操作，均通过 POST /compose 接口完成：

• 评分（step=score）：对一条推文草稿进行评分，返回 0-100 的分数、各项信号以及改进建议。信号包括：hook_quality（钩子质量）、length_fit（长度适配）、format（格式）、media_bonus（媒体加分）、reply_bait_risk（回复诱导风险）、link_penalty（外链惩罚）。
• 优化（step=optimize）：对草稿进行改写，以提升预测互动，返回多个变体及其评分。可指定 target_score（如 80）。

使用方式

接口基础地址为 https://xquik.com/api/v1，认证方式为请求头 x-api-key: xq_...。

评分请求示例：

POST /compose
{
  "step": "score",
  "text": "<draft>"
}

返回示例：

{
  score: 0-100,
  signals: { hook_quality, length_fit, format, media_bonus, reply_bait_risk, link_penalty },
  suggestions: string[]
}

优化请求示例：

POST /compose
{ "step": "optimize", "text": "<draft>", "target_score": 80 }

返回示例：

{ variants: [{ text, score }] }

典型流程：

1. 获取用户的草稿。
2. 先调用 step: "score"，展示当前分数和各项信号。
3. 如果用户希望改写，调用 step: "optimize"，展示 2-3 个带评分的变体。
4. 用户选定最终文本后，交给 post-tweets 进行实际发布。

适用场景

适用于希望在发布前评估推文互动潜力、并根据建议进行改写的用户。可用于单条推文的评分与优化，也可作为推文创作与发布流程中的一环。

限制与注意事项

• 评分仅为估算，并非承诺。实际互动取决于发布时间、受众和运气。
• link_penalty 是真实存在的：包含外部 URL 的推文通常表现较差。如果用户坚持添加外链，应提醒用户。
• 该技能本身不发布推文，发布需使用 post-tweets。
• 相关技能：草稿撰写使用 write-tweets，发布使用 post-tweets，完整 API 见 x-twitter-scraper。