anbeime/skill / skills/qiaomu-x-article-publisher/qiaomu-x-article-publisher-github
x-article-publisher
Verified内容创作者在需要将 Markdown 长文发布到 X (Twitter) 时,使用此技能一键将 Markdown 自动转换为富文本并发布至 X Articles,完美保留排版,免去手动调整与重复登录烦恼,让长文分发更高效。
| File | Kind | Size |
|---|---|---|
| .gitignore | other | 392 B |
| CHANGELOG.md | markdown | 1.5 KB |
| CONTRIBUTING.md | markdown | 2.4 KB |
| LICENSE | other | 1.0 KB |
| README.md | markdown | 3.4 KB |
| README_FULL.md | markdown | 5.0 KB |
| SKILL.md | skill md | 7.5 KB |
| data/.gitignore | other | 701 B |
| data/.gitkeep | other | 0 B |
| data/browser_state/.gitkeep | other | 53 B |
| metadata.json | config | 702 B |
| scripts/auth_manager.py | script | 8.9 KB |
| scripts/copy_to_clipboard.py | script | 6.0 KB |
| scripts/debug_editor.py | script | 4.9 KB |
| scripts/debug_page.py | script | 2.3 KB |
| scripts/parse_markdown.py | script | 16.7 KB |
| scripts/publish_article.py | script | 39.5 KB |
| scripts/site_config.py | script | 1.7 KB |
README.md
View on GitHub# Qiaomu X Article Publisher
> 🚀 一键发布 Markdown 文章到 X (Twitter) Articles,让写作更流畅




---
## 📖 为什么需要这个工具?
X Articles 是一个强大的长文发布平台,但直接在网页编辑器写作体验不够流畅:
- ❌ 格式工具栏操作繁琐
- ❌ 无法用熟悉的 Markdown 语法
- ❌ 缺少本地版本管理
- ❌ 需要手动上传图片
**这个 Skill 解决了这些痛点**:
- ✅ 用 Markdown 写作,自动转换为 X Articles 格式
- ✅ 本地文件管理,配合 Git 版本控制
- ✅ 持久化登录,7天免重复认证
- ✅ 智能图片处理,一键上传
- ✅ **完全自包含,开箱即用**
---
## ✨ 核心功能
### 🔐 持久化认证
一次登录,7天内无需重复认证。基于内置浏览器认证框架实现。
### 📝 Markdown 完整支持
自动转换以下格式:
- 标题(H1-H6)
- 粗体、斜体
- 列表(有序/无序)
- 引用块
- 代码块(转为引用样式)
- 超链接
- 图片(封面图 + 内容图)
### 🖼️ 智能图片处理
- 自动识别封面图(文章第一张图)
- 内容图片自动上传
- 支持本地路径和相对路径
### 🤖 智能增强(可选)
- 无标题时,可请求 Claude 生成吸引人的标题
- 无封面图时,可调用图片生成 Skill 创建封面
### ⚡ 一键发布
单条命令完成所有步骤,只保存为草稿,不会自动发布(安全第一)。
---
## 🚀 快速开始
### 安装(与 Claude Code 对话)
**最简单的方式** - 直接告诉 Claude Code:
```
安装这个 Claude skill:https://github.com/[your-username]/qiaomu-x-article-publisher
```
Claude Code 会自动完成所有安装步骤!
### 手动安装
```bash
# 1. 克隆到 Claude skills 目录
git clone https://github.com/[your-username]/qiaomu-x-article-publisher.git \
~/.claude/skills/qiaomu-x-article-publisher
# 2. 安装 Python 依赖
pip install Pillow pyobjc-framework-Cocoa patchright
# 3. 首次认证
cd ~/.claude/skills/qiaomu-x-article-publisher/scripts
python auth_manager.py setup
```
---
## 📖 使用示例
### 示例 1:基本发布
```bash
cd ~/.claude/skills/qiaomu-x-article-publisher/scripts
python publish_article.py --file ~/articles/my-post.md
```
### 示例 2:与 Claude Code 协作
```
你:帮我写一篇关于 AI 的文章
Claude:[生成文章并保存]
你:发布到 X Articles
Claude:[自动调用 Skill 发布]
```
---
## 🎯 完整功能文档
查看完整功能、使用场景、故障排查请访问:
👉 [完整 README.md](./README_FULL.md)
---
## 📋 系统要求
- macOS
- Python 3.9+
- X Premium Plus 订阅
---
## 🔧 常见问题
**Q: 认证过期怎么办?**
A: `python auth_manager.py reauth`
**Q: 会自动发布吗?**
A: 不会,只保存为草稿,需手动发布
**Q: 支持 Windows/Linux 吗?**
A: 目前仅支持 macOS(使用 pyobjc 剪贴板功能)
---
## 📝 更新日志
### v1.0.0 (2026-01-14) - 首次发布 🎉
- Markdown 自动转换
- 持久化认证(7天)
- 智能图片处理
- 完全自包含
---
## 📄 许可证
MIT License - 查看 [LICENSE](./LICENSE)
---
**⭐ 如果有帮助,请给个 Star!**
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |