Twitter Article Skill

Notion 文章一键同步到 Twitter/X Article（Premium+ 长文，图文混排）。

快速使用

# 环境变量（必须）
export AUTH_TOKEN="<twitter auth_token cookie>"
export CT0="<twitter ct0 cookie>"
export HTTPS_PROXY="http://127.0.0.1:7897"

# Notion 文章 → Twitter 草稿（一条命令搞定）
node twitter-article.js notion-to-article --notion-key <key> --page-id <id>

# 或者分步操作
node twitter-article.js upload-media --file image.png        # 上传图片
node twitter-article.js create --title "标题" --file a.md     # 创建含内容的草稿
node twitter-article.js update-content --id <id> --file a.md  # 更新已有草稿内容
node twitter-article.js update-cover --id <id> --media-id <m> # 设封面
node twitter-article.js publish --id <id>                     # 发布

命令一览

前提条件

• Twitter Premium+ 账号（Article 功能需要）
• Cookies 认证：AUTH_TOKEN + CT0（从浏览器获取）
• 代理：HTTPS_PROXY（国内需要）

内容格式（核心）

Twitter Article 使用修改版 Draft.js 格式。发送用 snake_case，返回用 camelCase。

Block

{
  "data": {},
  "text": "段落文字",
  "key": "a1b2c",
  "type": "unstyled",
  "entity_ranges": [],
  "inline_style_ranges": []
}

支持的 type：unstyled header-one header-two blockquote unordered-list-item ordered-list-item atomic

不支持：header-three header-four code-block（服务端 500）

内嵌图片

Atomic block + MEDIA entity：

// entity_map 条目
{
  "key": "0",
  "value": {
    "type": "MEDIA",
    "mutability": "Immutable",
    "data": {
      "entity_key": "<uuid-v4>",
      "media_items": [{
        "local_media_id": 1,
        "media_category": "DraftTweetImage",
        "media_id": "<media_id_string>"
      }]
    }
  }
}

// 对应的 atomic block
{
  "data": {},
  "text": " ",
  "key": "xxx",
  "type": "atomic",
  "entity_ranges": [{"key": 0, "offset": 0, "length": 1}],
  "inline_style_ranges": []
}

API 变量名速查

⚠️ UpdateContent 用 article_entity，其他用 articleEntityId！

⚠️ 关键注意事项

1. media_id 必须用字符串 — JS Number 对 19 位数字丢精度，用 media_id_string
2. 第一个 # 标题自动跳过 — 作为 title 参数传递，不重复写入正文
3. h3/h4 → h2 — Twitter 不支持三级以下标题
4. code → blockquote — code-block 类型会报错
5. QueryID 可能变 — Twitter 前端更新后需要重新抓取
6. 封面图格式 — coverMedia: {media_id, media_category: "DraftTweetImage"}，不是平铺的 media_id

文件结构

skills/twitter-article/
├── SKILL.md              # 本文档
└── twitter-article.js    # CLI 工具（所有功能）