X Article Publisher Skill: MarkdownをX Articlesに自動変換
X Article Publisher Skill – Markdownを数秒でX Articlesに変換
X（旧Twitter）ArticlesにMarkdownを投稿する際、プレーンテキストを貼り付けると書式が失われ、画像を手動でアップロードし、配置も不安定になることがあります。X Article Publisher Skillはワンクリックで全作業を自動化するソリューションです：
- Markdownを解析し、タイトル、カバーページ、埋め込み画像を抽出します。
- MarkdownをクリーンなHTMLへ変換し、見出し・リンク・表・Mermaidダイアグラムをそのまま保持します。
- Playwright（Claude Codeフレームワーク経由）でX Articlesエディタを開きます。
- リッチテキストとして貼り付けます。
- Markdownで指定した正確なブロックインデックスに画像を挿入し、位置ずれを防止します。
- 記事を下書きとして保存—誤って公開される心配はありません。
結果は、完璧にフォーマットされた下書きがレビュー準備完了で、すべての画像が配置済み。 3分以内で完了します。
なぜこのツールが必要なのか
Markdownを愛するコンテンツクリエイターは、X Articlesに投稿する際に次の3つの痛点に直面します：
- 書式の喪失 – プレーンMarkdownを貼り付けるとヘッダー・リスト・スタイルが消えてしまう。
- 画像アップロードに時間がかかる – それぞれの画像をメディアメニューで手動で選択する必要がある。
- 画像配置が不安定 – 手動ドラッグやテキストベースの位置決めがよく誤って配置される。
このスキルはそれぞれの問題を解決します： - リッチテキスト貼り付け クリップボード経由でMarkdownの意味合いをそのまま保護。 - 自動画像アップロード スマート待機検出でクリック不要、迅速にアップロード。 - ブロックインデックス位置決め 複雑なドキュメントでも期待通りに画像を挿入。
効率向上
横並び比較で典型的な節約を示しています：
| タスク | 手動 | スキル使用 |
|---|---|---|
| 書式変換 | 15‑20分 | 0分 |
| カバー画像アップロード | 1‑2分 | < 10秒 |
| 複数コンテンツ画像 | 5‑10分 | 1分 |
| 合計 | 20‑30分 | 2‑3分 |
これは最低10倍の生産性向上です。
はじめに
前提条件
| 要件 | 備考 |
|---|---|
| Claude Code | https://claude.ai/code でインストール |
| Playwright MCP | ブラウザ自動化ドライバー |
| X Premium Plus | Articles機能はPremium Plus限定 |
| Python 3.9+ | ヘルパースクリプト用 |
| OS | macOSまたはWindows（Linuxは進行中） |
| Clip Utilities | Windowsならpip install Pillow pywin32 clip-util、macOSならpip install Pillow pyobjc-framework-Cocoa |
| Mermaid CLI | オプション、ダイアグラム変換用(npm install -g @mermaid-js/mermaid-cli) |
インストール
# 方法1：クローンしてClaudeスキルディレクトリにコピー
git clone https://github.com/wshuyi/x-article-publisher-skill.git
cp -r x-article-publisher-skill/skills/x-article-publisher ~/.claude/skills/
# 方法2：Claudeプラグインマーケットプレイス経由でインストール
/plugin marketplace add wshuyi/x-article-publisher-skill
/plugin install x-article-publisher@wshuyi/x-article-publisher-skill
使い方
スキルは自然言語または直接コマンドで呼び出せます。
- 自然言語（Claudeチャットボット経由）:
Help me post this article to X Articles: ~/Documents/my-post.md - 直接スキル呼び出し（ターミナル）:
/x-article-publisher /path/to/article.md
ワークフローは次の通りです。
1. Markdownを解析しメタデータを抽出。
2. X Articlesエディタを x.com/compose/articles で開く。
3. カバー画像をアップロードし本文を貼り付け。
4. ブロックインデックス戦略で画像挿入。
5. 後でレビューできるよう下書き保存。
主な機能ハイライト
| 機能 | バージョン | 利点 |
|---|---|---|
| Divider Support | v1.2.0 | --- を認識し、InsertメニューからX Articlesの区切りを挿入 |
| Table‑to‑Image | v1.2.0 | Markdown表をPNGへ変換し、ビジュアルの忠実度を保つ |
| Mermaid Support | v1.2.0 | mmdc を使用してダイアグラムを画像化 |
| Block‑Index Positioning | v1.1.0 | テキストマッチングに弱いのではなく、正確に画像配置 |
| Reverse Insertion Order | v1.1.0 | 画像を複数挿入時のインデックスシフトを防止 |
| Automatic Wait Strategy | v1.1.0 | アップロード完了時に即応答、アイドル時間を削減 |
| Safe Publishing | Every Release | 下書き専用モードで誤投稿を防止 |
貢献案内
プロジェクトはアクティブに保守され、プルリクエストを歓迎します。主な貢献領域：
- Linuxサポート（クリップボードとPlaywright設定）
- 画像フォーマットサポートの拡張（JPG/PNG/GIF/WebP以外）
- エラーハンドリングの改善（画像パス未設定時など）
- ドキュメントの充実（追加ユースケースと高度な例）
GitHubリポジトリでissueやPRを提出できます。
結論
X Article Publisher Skillは、Markdownを書いてX Articlesへ投稿する全ての人にとって革命的です。自動書式化、精密画像配置、迅速な下書きワークフローにより、手作業のドラッグ＆ドロップのフラストレーションを解消します。ソロブロガー、コピーライター、デジタルマーケティングチームを問わず、記事制作サイクルを10倍に短縮し、編集を安全で完璧なレビューに持って行けます。
ぜひ本日から試し、フォークし、改善点を共有してください—オープンソースは協働で発展します！