Baoyu Post To X

1---2name: baoyu-post-to-x3description: Posts content and articles to X (Twitter). Supports regular posts with images/videos and X Articles (long-form Markdown). Uses real Chrome with CDP to bypass anti-automation. Use when user asks to "post to X", "tweet", "publish to Twitter", or "share on X".4version: 1.56.15metadata:6  openclaw:7    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-post-to-x8    requires:9      anyBins:10        - bun11        - npx12---13 14# Post to X (Twitter)15 16Posts text, images, videos, and long-form articles to X via real Chrome browser (bypasses anti-bot detection).17 18## Script Directory19 20**Important**: All scripts are located in the `scripts/` subdirectory of this skill.21 22**Agent Execution Instructions**:231. Determine this SKILL.md file's directory path as `{baseDir}`242. Script path = `{baseDir}/scripts/<script-name>.ts`253. Replace all `{baseDir}` in this document with the actual path264. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun27 28**Script Reference**:29| Script | Purpose |30|--------|---------|31| `scripts/x-browser.ts` | Regular posts (text + images) |32| `scripts/x-video.ts` | Video posts (text + video) |33| `scripts/x-quote.ts` | Quote tweet with comment |34| `scripts/x-article.ts` | Long-form article publishing (Markdown) |35| `scripts/md-to-html.ts` | Markdown → HTML conversion |36| `scripts/copy-to-clipboard.ts` | Copy content to clipboard |37| `scripts/paste-from-clipboard.ts` | Send real paste keystroke |38| `scripts/check-paste-permissions.ts` | Verify environment & permissions |39 40## Preferences (EXTEND.md)41 42Check EXTEND.md existence (priority order):43 44```bash45# macOS, Linux, WSL, Git Bash46test -f .baoyu-skills/baoyu-post-to-x/EXTEND.md && echo "project"47test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-post-to-x/EXTEND.md" && echo "xdg"48test -f "$HOME/.baoyu-skills/baoyu-post-to-x/EXTEND.md" && echo "user"49```50 51```powershell52# PowerShell (Windows)53if (Test-Path .baoyu-skills/baoyu-post-to-x/EXTEND.md) { "project" }54$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }55if (Test-Path "$xdg/baoyu-skills/baoyu-post-to-x/EXTEND.md") { "xdg" }56if (Test-Path "$HOME/.baoyu-skills/baoyu-post-to-x/EXTEND.md") { "user" }57```58 59┌──────────────────────────────────────────────────┬───────────────────┐60│                       Path                       │     Location      │61├──────────────────────────────────────────────────┼───────────────────┤62│ .baoyu-skills/baoyu-post-to-x/EXTEND.md          │ Project directory │63├──────────────────────────────────────────────────┼───────────────────┤64│ $HOME/.baoyu-skills/baoyu-post-to-x/EXTEND.md    │ User home         │65└──────────────────────────────────────────────────┴───────────────────┘66 67┌───────────┬───────────────────────────────────────────────────────────────────────────┐68│  Result   │                                  Action                                   │69├───────────┼───────────────────────────────────────────────────────────────────────────┤70│ Found     │ Read, parse, apply settings                                               │71├───────────┼───────────────────────────────────────────────────────────────────────────┤72│ Not found │ Use defaults                                                              │73└───────────┴───────────────────────────────────────────────────────────────────────────┘74 75**EXTEND.md Supports**: Default Chrome profile76 77## Prerequisites78 79- Google Chrome or Chromium80- `bun` runtime81- First run: log in to X manually (session saved)82 83## Pre-flight Check (Optional)84 85Before first use, suggest running the environment check. User can skip if they prefer.86 87```bash88${BUN_X} {baseDir}/scripts/check-paste-permissions.ts89```90 91Checks: Chrome, profile isolation, Bun, Accessibility, clipboard, paste keystroke, Chrome conflicts.92 93**If any check fails**, provide fix guidance per item:94 95| Check | Fix |96|-------|-----|97| Chrome | Install Chrome or set `X_BROWSER_CHROME_PATH` env var |98| Profile dir | Shared profile at `baoyu-skills/chrome-profile` (see CLAUDE.md Chrome Profile section) |99| Bun runtime | `brew install oven-sh/bun/bun` (macOS) or `npm install -g bun` |100| Accessibility (macOS) | System Settings → Privacy & Security → Accessibility → enable terminal app |101| Clipboard copy | Ensure Swift/AppKit available (macOS Xcode CLI tools: `xcode-select --install`) |102| Paste keystroke (macOS) | Same as Accessibility fix above |103| Paste keystroke (Linux) | Install `xdotool` (X11) or `ydotool` (Wayland) |104 105## References106 107- **Regular Posts**: See `references/regular-posts.md` for manual workflow, troubleshooting, and technical details108- **X Articles**: See `references/articles.md` for long-form article publishing guide109 110---111 112## Post Type Selection113 114Unless the user explicitly specifies the post type:115- **Plain text** + within 10,000 characters → **Regular Post** (Premium members support up to 10,000 characters, non-Premium: 280)116- **Markdown file** (.md) → **X Article**117 118## Regular Posts119 120```bash121${BUN_X} {baseDir}/scripts/x-browser.ts "Hello!" --image ./photo.png122```123 124**Parameters**:125| Parameter | Description |126|-----------|-------------|127| `<text>` | Post content (positional) |128| `--image <path>` | Image file (repeatable, max 4) |129| `--profile <dir>` | Custom Chrome profile |130 131**Note**: Script opens browser with content filled in. User reviews and publishes manually.132 133---134 135## Video Posts136 137Text + video file.138 139```bash140${BUN_X} {baseDir}/scripts/x-video.ts "Check this out!" --video ./clip.mp4141```142 143**Parameters**:144| Parameter | Description |145|-----------|-------------|146| `<text>` | Post content (positional) |147| `--video <path>` | Video file (MP4, MOV, WebM) |148| `--profile <dir>` | Custom Chrome profile |149 150**Note**: Script opens browser with content filled in. User reviews and publishes manually.151 152**Limits**: Regular 140s max, Premium 60min. Processing: 30-60s.153 154---155 156## Quote Tweets157 158Quote an existing tweet with comment.159 160```bash161${BUN_X} {baseDir}/scripts/x-quote.ts https://x.com/user/status/123 "Great insight!"162```163 164**Parameters**:165| Parameter | Description |166|-----------|-------------|167| `<tweet-url>` | URL to quote (positional) |168| `<comment>` | Comment text (positional, optional) |169| `--profile <dir>` | Custom Chrome profile |170 171**Note**: Script opens browser with content filled in. User reviews and publishes manually.172 173---174 175## X Articles176 177Long-form Markdown articles (requires X Premium).178 179```bash180${BUN_X} {baseDir}/scripts/x-article.ts article.md181${BUN_X} {baseDir}/scripts/x-article.ts article.md --cover ./cover.jpg182```183 184**Parameters**:185| Parameter | Description |186|-----------|-------------|187| `<markdown>` | Markdown file (positional) |188| `--cover <path>` | Cover image |189| `--title <text>` | Override title |190 191**Frontmatter**: `title`, `cover_image` supported in YAML front matter.192 193**Note**: Script opens browser with article filled in. User reviews and publishes manually.194 195**Post-Composition Check**: The script automatically verifies after all images are inserted:196- Remaining `XIMGPH_` placeholders in editor content197- Expected vs actual image count198 199If the check fails (warnings in output), alert the user with the specific issues before they publish.200 201---202 203## Troubleshooting204 205### Chrome debug port not ready206 207If a script fails with `Chrome debug port not ready` or `Unable to connect`, kill existing Chrome CDP instances first, then retry:208 209```bash210pkill -f "Chrome.*remote-debugging-port" 2>/dev/null; pkill -f "Chromium.*remote-debugging-port" 2>/dev/null; sleep 2211```212 213**Important**: This should be done automatically — when encountering this error, kill Chrome CDP instances and retry the command without asking the user.214 215## Notes216 217- First run: manual login required (session persists)218- All scripts only fill content into the browser, user must review and publish manually219- Cross-platform: macOS, Linux, Windows220 221## Extension Support222 223Custom configurations via EXTEND.md. See **Preferences** section for paths and supported options.