# 仅发布文本
/post-to-x "Your post content here"

# 发布带图片的推文
/post-to-x "Your post content" --image /path/to/image.png

# 发布带多张图片的推文 (最多 4 张)
/post-to-x "Your post content" --image img1.png --image img2.png

# 实际提交发布
/post-to-x "Your post content" --submit

# 预览模式 (不发布)
npx -y bun ./scripts/x-browser.ts "Hello from Claude!" --image ./screenshot.png

# 实际发布
npx -y bun ./scripts/x-browser.ts "Hello!" --image ./photo.png --submit

npx -y bun ./scripts/copy-to-clipboard.ts image /path/to/image.png

# 导航
mcp__playwright__browser_navigate url="https://x.com/compose/post"

# 获取元素引用
mcp__playwright__browser_snapshot

# 输入文本
mcp__playwright__browser_click element="editor" ref="<ref>"
mcp__playwright__browser_type element="editor" ref="<ref>" text="Your content"

# 粘贴图片 (复制到剪贴板后)
mcp__playwright__browser_press_key key="Meta+v"  # macOS
# 或
mcp__playwright__browser_press_key key="Control+v"  # Windows/Linux

# 截图以验证
mcp__playwright__browser_take_screenshot filename="preview.png"

User: /post-to-x "Hello from Claude!" --image ./screenshot.png

Claude:
1. Runs: npx -y bun ./scripts/x-browser.ts "Hello from Claude!" --image ./screenshot.png
2. Chrome opens with X compose page
3. Text is typed into editor
4. Image is copied to clipboard and pasted
5. Browser stays open 30s for preview
6. Reports: "Post composed. Use --submit to post."

# 发布 Markdown 文章 (预览模式)
/post-to-x article /path/to/article.md

# 带自定义封面图片
/post-to-x article article.md --cover ./hero.png

# 带自定义标题
/post-to-x article article.md --title "My Custom Title"

# 实际发布 (不仅仅是草稿)
/post-to-x article article.md --submit

npx -y bun ./scripts/x-article.ts article.md
npx -y bun ./scripts/x-article.ts article.md --cover ./cover.jpg
npx -y bun ./scripts/x-article.ts article.md --submit

---
title: My Article Title
cover_image: /path/to/cover.jpg
---

# Title (becomes article title)

Regular paragraph text with **bold** and *italic*.

## Section Header

More content here.

![Image alt text](./image.png)

- List item 1
- List item 2

1. Numbered item
2. Another item

> Blockquote text

[Link text](https://example.com)

\`\`\`
Code blocks become blockquotes (X doesn't support code)
\`\`\`

# 获取包含所有元数据的 JSON
npx -y bun ./scripts/md-to-html.ts article.md

# 仅输出 HTML
npx -y bun ./scripts/md-to-html.ts article.md --html-only

# 保存 HTML 到文件
npx -y bun ./scripts/md-to-html.ts article.md --save-html /tmp/article.html

{
  "title": "Article Title",
  "coverImage": "/path/to/cover.jpg",
  "contentImages": [
    {
      "placeholder": "[[IMAGE_PLACEHOLDER_1]]",
      "localPath": "/tmp/x-article-images/img.png",
      "blockIndex": 5
    }
  ],
  "html": "<p>Content...</p>",
  "totalBlocks": 20
}

User: /post-to-x article ./blog/my-post.md --cover ./thumbnail.png

Claude:
1. Parses markdown: title="My Post", 3 content images
2. Launches Chrome with CDP
3. Navigates to x.com/compose/articles
4. Clicks create button
5. Uploads thumbnail.png as cover
6. Fills title "My Post"
7. Pastes HTML content
8. Inserts 3 images at placeholder positions
9. Reports: "Article composed. Review and use --submit to publish."