x-article-publisher

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

X Article Publisher

Publish Markdown content to X (Twitter) Articles editor, preserving formatting with rich text conversion.

将Markdown内容发布到X（Twitter）Articles编辑器，通过富文本转换保留原有格式。

Prerequisites

前置条件

X Premium Plus subscription

Python 3.9+ with dependencies:

pip install Pillow pyobjc-framework-Cocoa patchright

X Premium Plus订阅

Python 3.9+及以下依赖：

pip install Pillow pyobjc-framework-Cocoa patchright

🎉 首次使用：一次认证，告别重复登录

X Article Publisher 现在支持持久化认证，无需每次手动登录！

🔧 初始化认证（仅需一次）

首次使用前，运行认证设置：

bash

cd ~/.claude/skills/x-article-publisher/scripts
python auth_manager.py setup

流程：

✅ 浏览器窗口自动打开 X 登录页面
🔐 手动登录你的 X 账号（需 Premium+ 订阅）
✅ 完成 2FA 验证（如已启用）
🏠 登录成功后自动跳转到 Home 时间线
💾 认证状态自动保存（有效期 7 天）

首次使用前，运行认证设置：

bash

cd ~/.claude/skills/x-article-publisher/scripts
python auth_manager.py setup

流程：

✅ 浏览器窗口自动打开 X 登录页面
🔐 手动登录你的 X 账号（需 Premium+ 订阅）
✅ 完成 2FA 验证（如已启用）
🏠 登录成功后自动跳转到 Home 时间线
💾 认证状态自动保存（有效期 7 天）

📋 认证管理命令

bash

undefined

bash

undefined

检查认证状态

python auth_manager.py status

验证认证是否有效

python auth_manager.py validate

清除认证数据（需重新登录）

python auth_manager.py clear

重新认证（清除 + 设置）

python auth_manager.py reauth

undefined

python auth_manager.py reauth

undefined

🚀 自动化工作流

认证设置完成后，skill 执行时会自动：

✅ 检查认证状态
🔓 如已认证，直接使用保存的浏览器状态（无需登录）
⚠️ 如未认证，提示运行
```
auth_manager.py setup
```

注意：认证数据存储在

~/.claude/skills/x-article-publisher/data/browser_state/

，已通过 .gitignore 排除，不会提交到 Git。

认证设置完成后，skill 执行时会自动：

✅ 检查认证状态
🔓 如已认证，直接使用保存的浏览器状态（无需登录）
⚠️ 如未认证，提示运行
```
auth_manager.py setup
```

注意：认证数据存储在

~/.claude/skills/x-article-publisher/data/browser_state/

，已通过 .gitignore 排除，不会提交到 Git。

Scripts

脚本

Located in

~/.claude/skills/x-article-publisher/scripts/

存放在

~/.claude/skills/x-article-publisher/scripts/

目录下：

publish_article.py (主脚本 - 一键发布)

推荐使用 - 自动完成所有发布步骤：

bash

undefined

推荐使用 - 自动完成所有发布步骤：

bash

undefined

基本用法

python publish_article.py --file article.md

显示浏览器（调试用）

python publish_article.py --file article.md --show-browser

自定义标题

python publish_article.py --file article.md --title "自定义标题"

undefined

python publish_article.py --file article.md --title "自定义标题"

undefined

parse_markdown.py

Parse Markdown and extract structured data:

bash

python parse_markdown.py <markdown_file> [--output json|html] [--html-only]

Returns JSON with: title, cover_image, content_images (with block_index for positioning), html, total_blocks

解析Markdown并提取结构化数据：

bash

python parse_markdown.py <markdown_file> [--output json|html] [--html-only]

返回包含以下字段的JSON：title, cover_image, content_images (带用于定位的block_index), html, total_blocks

copy_to_clipboard.py

Copy image or HTML to system clipboard:

bash

undefined

将图片或HTML复制到系统剪贴板：

bash

undefined

Copy image (with optional compression)

复制图片（支持可选压缩）

python copy_to_clipboard.py image /path/to/image.jpg [--quality 80]

Copy HTML for rich text paste

复制HTML用于富文本粘贴

python copy_to_clipboard.py html --file /path/to/content.html

undefined

python copy_to_clipboard.py html --file /path/to/content.html

undefined

Workflow (简化版)

工作流 (简化版)

前提：已完成认证设置（

python auth_manager.py setup

）

前提：已完成认证设置（

python auth_manager.py setup

）

🚀 一键发布（推荐）

直接运行 publish_article.py，自动完成所有步骤：

bash

cd ~/.claude/skills/x-article-publisher/scripts
python publish_article.py --file /path/to/article.md

脚本会自动：

✅ 检查认证状态
📄 解析 Markdown 文件
🌐 启动已认证的浏览器
📍 导航到 X Articles 编辑器
🔘 点击 create 按钮
🖼️ 上传封面图（如有）
📝 填写标题
📋 粘贴 HTML 内容
✅ 保存草稿（不会自动发布）

直接运行 publish_article.py，自动完成所有步骤：

bash

cd ~/.claude/skills/x-article-publisher/scripts
python publish_article.py --file /path/to/article.md

脚本会自动执行以下操作：

✅ 检查认证状态
📄 解析 Markdown 文件
🌐 启动已认证的浏览器
📍 导航到 X Articles 编辑器
🔘 点击 create 按钮
🖼️ 上传封面图（如有）
📝 填写标题
📋 粘贴 HTML 内容
✅ 保存草稿（不会自动发布）

手动工作流（高级用户）

如需更精细控制，可分步执行：

Parse Markdown:
```
python parse_markdown.py article.md
```
手动操作浏览器发布

如需更精细控制，可分步执行：

解析Markdown:
```
python parse_markdown.py article.md
```
手动操作浏览器发布

🧠 智能增强功能

智能标题生成

当文章没有 H1 标题时，

parse_markdown.py

会返回

needs_title_generation: true

。

Claude 应该自动：

阅读文章内容，理解核心观点
生成一个吸引人点击的标题（15-25字为佳）
使用
```
--title "生成的标题"
```
参数发布

好标题的特点：

包含数字或具体细节（"3个方法"、"90%的人不知道"）
激发好奇心（"为什么..."、"如何..."、"...的真相"）
与读者切身相关
避免标题党，但要有吸引力

示例：

bash

undefined

当文章没有 H1 标题时，

parse_markdown.py

会返回

needs_title_generation: true

。

Claude 应该自动：

阅读文章内容，理解核心观点
生成一个吸引人点击的标题（15-25字为佳）
使用
```
--title "生成的标题"
```
参数发布

好标题的特点：

包含数字或具体细节（"3个方法"、"90%的人不知道"）
激发好奇心（"为什么..."、"如何..."、"...的真相"）
与读者切身相关
避免标题党，但要有吸引力

示例：

bash

undefined

解析文章

python parse_markdown.py article.md

如果 needs_title_generation: true，Claude 生成标题后：

python publish_article.py --file article.md --title "AI时代，普通人的3个生存法则"

undefined

python publish_article.py --file article.md --title "AI时代，普通人的3个生存法则"

undefined

智能封面图生成

当文章没有封面图时，

parse_markdown.py

会返回

needs_cover_generation: true

。

Claude 应该自动：

阅读文章，提炼核心概念（1-3个关键词）

调用

gemini-image-generator

或

jimeng-image-generator

skill 生成封面图

封面图风格建议：
- 简洁大气，避免复杂细节
- 可以是抽象概念的可视化
- 或是带有核心关键词的文字海报
将生成的图片路径插入到文章开头作为封面

封面图生成提示词模板：

为一篇关于「{文章主题}」的文章生成封面图。
风格：简洁、现代、科技感
元素：{1-3个核心视觉元素}
文字：可选，如果加文字只放{1-3个关键词}
尺寸：16:9 横版

工作流示例：

bash

undefined

当文章没有封面图时，

parse_markdown.py

会返回

needs_cover_generation: true

。

Claude 应该自动：

阅读文章，提炼核心概念（1-3个关键词）

调用

gemini-image-generator

或

jimeng-image-generator

skill 生成封面图

封面图风格建议：
- 简洁大气，避免复杂细节
- 可以是抽象概念的可视化
- 或是带有核心关键词的文字海报
将生成的图片路径插入到文章开头作为封面

封面图生成提示词模板：

为一篇关于「{文章主题}」的文章生成封面图。
风格：简洁、现代、科技感
元素：{1-3个核心视觉元素}
文字：可选，如果加文字只放{1-3个关键词}
尺寸：16:9 横版

工作流示例：

bash

undefined

1. 解析文章

python parse_markdown.py article.md

输出: needs_cover_generation: true

2. Claude 调用生图 skill 生成封面（假设保存到 /tmp/cover.png）

3. 将封面图插入文章开头，或手动上传


**注意**：封面图上传目前需要在浏览器中手动操作，脚本会打开编辑器后等待用户操作。

---


**注意**：封面图上传目前需要在浏览器中手动操作，脚本会打开编辑器后等待用户操作。

---

技术细节

parse_markdown.py 输出格式

json

{
  "title": "Article Title",
  "title_source": "h1",           // "h1", "h2", "first_line", or "none"
  "needs_title_generation": false, // true if no H1 title
  "cover_image": "/path/to/first-image.jpg",
  "needs_cover_generation": false, // true if no cover image
  "content_images": [
    {"path": "/path/to/img2.jpg", "block_index": 5}
  ],
  "html": "<p>Content...</p><h2>Section</h2>...",
  "total_blocks": 45
}

字段说明：

```
title_source
```
: 标题来源
- ```
h1
```
  : 来自 H1 标题（最理想）
- ```
h2
```
  : 来自第一个 H2 标题
- ```
first_line
```
  : 来自第一行文本
- ```
none
```
  : 无法提取标题
```
needs_title_generation
```
: 是否需要 Claude 生成更好的标题
```
needs_cover_generation
```
: 是否需要 Claude 生成封面图

json

{
  "title": "Article Title",
  "title_source": "h1",           // "h1", "h2", "first_line", or "none"
  "needs_title_generation": false, // true if no H1 title
  "cover_image": "/path/to/first-image.jpg",
  "needs_cover_generation": false, // true if no cover image
  "content_images": [
    {"path": "/path/to/img2.jpg", "block_index": 5}
  ],
  "html": "<p>Content...</p><h2>Section</h2>...",
  "total_blocks": 45
}

字段说明：

```
title_source
```
: 标题来源
- ```
h1
```
  : 来自 H1 标题（最理想）
- ```
h2
```
  : 来自第一个 H2 标题
- ```
first_line
```
  : 来自第一行文本
- ```
none
```
  : 无法提取标题
```
needs_title_generation
```
: 是否需要 Claude 生成更好的标题
```
needs_cover_generation
```
: 是否需要 Claude 生成封面图

Critical Rules

核心规则

NEVER auto-publish - Only save as draft
NO automatic cover images - User adds cover manually, never insert first image as cover
Clean placeholders - Remove all remaining
```
@@@IMG_X@@@
```
markers after image insertion
H1 title handling - H1 is used as title only, not included in body

绝对禁止自动发布 - 仅保存为草稿
禁止自动设置封面图 - 由用户手动添加封面，不得将第一张图片自动设为封面
清理占位符 - 插入图片后移除所有剩余的
```
@@@IMG_X@@@
```
标记
H1标题处理规则 - H1仅用作文章标题，不会纳入正文内容

Supported Formatting

支持的格式

H2 headers (## )
Blockquotes (> )
Code blocks (converted to blockquotes)
Bold text (**)
Hyperlinks (text)
Ordered/Unordered lists
Paragraphs

H2 标题 (## )
块引用 (> )
代码块（转换为块引用）
粗体文本 (**)
超链接 (text)
有序/无序列表
段落

Example

示例

User: "Publish /path/to/article.md to X"

bash

cd ~/.claude/skills/x-article-publisher/scripts
python publish_article.py --file /path/to/article.md

Output:

📄 解析文件：/path/to/article.md
  📝 标题：文章标题
  🖼️  封面图：/path/to/cover.jpg
  📷 内容图：2 张

🌐 启动浏览器...
  📍 导航到 X Articles...
  🔘 点击 create 按钮...
  📝 填写标题...
  📋 粘贴内容...

✅ 草稿已创建！
  💡 请在浏览器中检查并手动发布
  🖥️  浏览器保持打开，请检查草稿并手动发布
  ⏎  完成后按回车键关闭浏览器...

技术经验参考: 浏览器自动化调试技巧详见 skill-development-guide

用户: "Publish /path/to/article.md to X"

bash

cd ~/.claude/skills/x-article-publisher/scripts
python publish_article.py --file /path/to/article.md

输出:

📄 解析文件：/path/to/article.md
  📝 标题：文章标题
  🖼️  封面图：/path/to/cover.jpg
  📷 内容图：2 张

🌐 启动浏览器...
  📍 导航到 X Articles...
  🔘 点击 create 按钮...
  📝 填写标题...
  📋 粘贴内容...

✅ 草稿已创建！
  💡 请在浏览器中检查并手动发布
  🖥️  浏览器保持打开，请检查草稿并手动发布
  ⏎  完成后按回车键关闭浏览器...

技术经验参考: 浏览器自动化调试技巧详见 skill-development-guide