Post to Weibo
FreeEffortlessly publish to Weibo with Markdown support.
Free · Opens the source repo
What Post to Weibo does
The Post to Weibo skill allows users to publish content directly to Weibo, a popular social media platform in China. This skill supports various types of posts, including regular text posts with images and videos, as well as long-form articles formatted in Markdown. By leveraging the Chrome DevTools Protocol (CDP), it bypasses common anti-bot detection mechanisms, ensuring a smoother posting experience.
For regular posts, users can easily share text along with up to 18 media files (images or videos) directly to their Weibo homepage. The skill provides a straightforward command-line interface where users can specify their post content and media files, which are then filled into the browser for manual review and publication. This allows for a controlled posting process, ensuring that users can double-check their content before it goes live.
When it comes to sharing longer articles, the skill supports Markdown input, allowing users to write in a familiar format. The article publishing process opens the Weibo article editor, automatically filling in the title and summary while ensuring that all images are correctly inserted. The skill also includes validation checks to alert users if there are any issues with the content, such as missing images, before they publish.
This skill is ideal for developers and designers who frequently post content to Weibo and prefer a more automated yet controlled approach to managing their posts. By using this skill, users can streamline their content creation and sharing process, making their interactions on Weibo more efficient.
When to use it
Use this skill when you need to publish content to Weibo, especially if you prefer Markdown for articles or need to include multiple media files.
When not to use it
This skill may not be suitable for users who require fully automated posting without manual intervention, as it still requires user review before publishing.
What you can build with it
Quick Social Media Updates
Easily share quick updates with text and images on Weibo, perfect for staying connected with your audience.
Publishing Long Articles
Use Markdown to write and publish detailed articles on Weibo, ensuring your content is well-formatted and engaging.
Media-Rich Posts
Share multimedia content, including videos and images, to enhance your posts and attract more engagement.
How to install Post to Weibo
View source1. Install with the skills CLI
npx skills add jimliu/baoyu-skills/baoyu-post-to-weibo --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by jimliuPost to Weibo
Posts text, images, videos, and long-form articles to Weibo via real Chrome browser (bypasses anti-bot detection).
Script Directory
Important: All scripts are located in the scripts/ subdirectory of this skill.
Agent Execution Instructions:
- Determine this SKILL.md file's directory path as
{baseDir} - Script path =
{baseDir}/scripts/<script-name>.ts - Replace all
{baseDir}in this document with the actual path - Resolve
${BUN_X}runtime: ifbuninstalled →bun; ifnpxavailable →npx -y bun; else suggest installing bun
Script Reference:
| Script | Purpose |
|---|---|
scripts/weibo-post.ts | Regular posts (text + images) |
scripts/weibo-article.ts | Headline article publishing (Markdown) |
scripts/copy-to-clipboard.ts | Copy content to clipboard |
scripts/paste-from-clipboard.ts | Send real paste keystroke |
Preferences (EXTEND.md)
Check EXTEND.md in priority order — the first one found wins:
| Priority | Path | Scope |
|---|---|---|
| 1 | .baoyu-skills/baoyu-post-to-weibo/EXTEND.md | Project |
| 2 | ${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-post-to-weibo/EXTEND.md | XDG |
| 3 | $HOME/.baoyu-skills/baoyu-post-to-weibo/EXTEND.md | User home |
If none found, use defaults.
EXTEND.md supports: Default Chrome profile
Prerequisites
- Google Chrome or Chromium
bunruntime- First run: log in to Weibo manually (session saved)
Regular Posts
Text + images/videos (max 18 files total). Posted on Weibo homepage.
${BUN_X} {baseDir}/scripts/weibo-post.ts "Hello Weibo!" --image ./photo.png
${BUN_X} {baseDir}/scripts/weibo-post.ts "Watch this" --video ./clip.mp4
Parameters:
| Parameter | Description |
|---|---|
<text> | Post content (positional) |
--image <path> | Image file (repeatable) |
--video <path> | Video file (repeatable) |
--profile <dir> | Custom Chrome profile |
Note: Script opens browser with content filled in. User reviews and publishes manually.
Headline Articles (头条文章)
Long-form Markdown articles published at https://card.weibo.com/article/v3/editor.
${BUN_X} {baseDir}/scripts/weibo-article.ts article.md
${BUN_X} {baseDir}/scripts/weibo-article.ts article.md --cover ./cover.jpg
Parameters:
| Parameter | Description |
|---|---|
<markdown> | Markdown file (positional) |
--cover <path> | Cover image |
--title <text> | Override title (max 32 chars, truncated if longer) |
--summary <text> | Override summary (max 44 chars, auto-regenerated if longer) |
--profile <dir> | Custom Chrome profile |
Frontmatter: title, summary, cover_image supported in YAML front matter.
Character Limits:
- Title: 32 characters max (truncated with warning if longer)
- Summary/导语: 44 characters max (auto-regenerated from content if longer)
Markdown-to-HTML: Do NOT pass any --theme parameter when converting markdown to HTML. Use the default theme (no theme argument).
Article Workflow:
- Opens
https://card.weibo.com/article/v3/editor - Clicks "写文章" button, waits for editor to become editable
- Fills title (validated for 32-char limit)
- Fills summary/导语 (validated for 44-char limit)
- Inserts HTML content into ProseMirror editor via paste
- Replaces image placeholders one by one (copy image → select placeholder → paste)
Post-Composition Check: The script automatically verifies after all images are inserted:
- Remaining
WBIMGPH_placeholders in editor content - Expected vs actual image count
If the check fails (warnings in output), alert the user with the specific issues before they publish.
Post Type Selection
Unless the user explicitly specifies the post type:
- Markdown file (
.md) → Headline Article (头条文章) - Plain text / text with images → Regular Post
Troubleshooting
Chrome debug port not ready
If a script fails with Chrome debug port not ready or Unable to connect, kill only the CDP Chrome instances (those with --remote-debugging-port AND the baoyu-skills profile), then retry:
pkill -f "remote-debugging-port.*baoyu-skills/chrome-profile" 2>/dev/null; sleep 2
CRITICAL: Never kill all Chrome processes (pkill -f "Google Chrome"). Only kill Chrome instances launched by CDP with the baoyu-skills profile directory. The user may have regular Chrome windows open.
Important: This should be done automatically -- when encountering this error, kill the CDP Chrome instances and retry the command without asking the user.
Notes
- First run: manual login required (session persists)
- All scripts only fill content into the browser, user must review and publish manually
- Cross-platform: macOS, Linux, Windows
Extension Support
Custom configurations via EXTEND.md. See Preferences section for paths and supported options.
Frequently asked questions about Post to Weibo
Similar skills
Content Creator
Streamline your content creation with SEO and brand voice tools.
Content Production
Transform topics into polished, publish-ready content.
Content Creator
Streamline your content creation with brand voice and SEO tools.
Content Strategy
Plan impactful content that drives traffic and engagement.
Blog Post
Create structured long-form articles effortlessly.
Post to WeChat
Effortlessly publish content to WeChat Official Accounts.