x-article-publisher

X Article Publisher

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

Prerequisites

• X Premium Plus subscription
• Python 3.9+ with dependencies: pip install Pillow pyobjc-framework-Cocoa patchright

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

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

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

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

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

流程：

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

📋 认证管理命令

# 检查认证状态
python auth_manager.py status

# 验证认证是否有效
python auth_manager.py validate

# 清除认证数据（需重新登录）
python auth_manager.py clear

# 重新认证（清除 + 设置）
python auth_manager.py reauth

🚀 自动化工作流

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

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

注意：认证数据存储在 ~/.claude/skills/x-article-publisher/data/browser_state/，已通过 .gitignore 排除，不会提交到 Git。

---

Scripts

Located in ~/.claude/skills/x-article-publisher/scripts/:

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

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

# 基本用法（默认显示浏览器）
python publish_article.py --file article.md

# 隐藏浏览器（后台运行）
python publish_article.py --file article.md --headless

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

parse_markdown.py

Parse Markdown and extract structured data:

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

copy_to_clipboard.py

Copy image or HTML to system clipboard:

# Copy image (with optional compression)
python copy_to_clipboard.py image /path/to/image.jpg [--quality 80]

# Copy HTML for rich text paste
python copy_to_clipboard.py html --file /path/to/content.html

Workflow (简化版)

前提：已完成认证设置（python auth_manager.py setup）

🚀 一键发布（推荐）

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

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

脚本会自动：

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

手动工作流（高级用户）

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

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

---

🧠 智能增强功能

智能标题生成