How to use the Post to Weibo agent skill (baoyu-post-to-weibo)

What the skill makes the agent do

The skill gives an agent two publishing paths. Regular posts take text plus up to 18 images or videos in total and are placed on the Weibo homepage. Headline articles take a Markdown file, convert it to HTML, and insert it into Weibo's article editor at card.weibo.com.

The scripts only fill in content. The browser opens with everything entered, and you review the draft and press publish yourself. The skill is a helper for composing and uploading, not an autonomous poster.

• Regular post: text with optional images or videos
• Headline article: Markdown with optional cover image, title and summary
• Uses a real Chrome browser, which the skill says helps it avoid anti-bot detection

Install the Post to Weibo skill

Download the ZIP for this skill from our page and unzip it. Place the folder in ~/.claude/skills/ for your user account, or in a project's .claude/skills/ folder if you want it limited to one project.

You can also upload the skill in the Claude apps under Settings → Capabilities → Skills.

• Personal install: ~/.claude/skills/
• Project install: .claude/skills/ inside your project folder
• Claude apps: Settings → Capabilities → Skills

Check the requirements before you start

You need Google Chrome or Chromium, a bun runtime (or npx, which can run bun), and a Weibo account. The first time you run the skill, you log in to Weibo manually in the browser it opens, and the session is saved for later runs.

The scripts depend on Node packages listed in scripts/package.json, which include baoyu-md and baoyu-chrome-cdp.

• Google Chrome or Chromium
• bun runtime, or npx to run bun
• A Weibo account, logged in manually on first run
• Node packages from scripts/package.json

Trigger the skill with natural requests

You do not need to call scripts yourself. Ask the agent in plain language. The skill's description lists phrases such as "post to Weibo", "发微博", "发布微博", "publish to Weibo", "share on Weibo", "写微博", and "微博头条文章".

If you do not specify a type, the skill picks one: a Markdown (.md) file becomes a headline article, while plain text or text with images becomes a regular post. Say so explicitly if you want a different type.

• "Post to Weibo: Hello from my new blog post, with photo.png attached"
• "Publish article.md to Weibo as a headline article with cover.jpg as the cover"
• "发微博：今天的新品发布，附上 photo.png"

Post a regular Weibo post with text, images or video

For a regular post, the agent runs weibo-post.ts with your text as a positional argument. Use --image or --video for files; both can be repeated. The browser opens with the content filled in, and you publish manually.

• <text>: post content (positional)
• --image <path>: image file, repeatable
• --video <path>: video file, repeatable
• --profile <dir>: custom Chrome profile

Publish a Markdown headline article

For long-form content, pass a Markdown file to weibo-article.ts. The script opens the Weibo article editor, clicks the write button, fills the title and summary, pastes the HTML into the editor, and then replaces image placeholders one by one.

Titles are limited to 32 characters and summaries to 44. A longer title is truncated with a warning, and a longer summary is regenerated from the content. You can set title, summary and cover_image in YAML front matter, or override them with flags. Do not pass a --theme parameter when converting Markdown; use the default theme.

• <markdown>: Markdown file (positional)
• --cover <path>: cover image
• --title <text>: override title (max 32 characters)
• --summary <text>: override summary (max 44 characters)
• --profile <dir>: custom Chrome profile

Review the draft and check the warnings

After inserting images, the article script checks for leftover WBIMGPH_ placeholders and compares the expected and actual image count. If the check fails, the output shows warnings. Read them and fix the issues before you publish. Nothing is posted automatically.

• Look for remaining WBIMGPH_ placeholders in the editor
• Confirm the image count matches what you expected
• Check the title and summary lengths

Safety notes: scripts, network and your Weibo session

This skill runs Bun scripts on your machine and uses the network. It drives a Chrome browser that holds your Weibo login, and the source notes that the scripts read the clipboard (copy-to-clipboard.ts and paste-from-clipboard.ts send a real paste keystroke). Read the scripts in the scripts/ folder if you need to be sure what runs.

The troubleshooting section says that on a "Chrome debug port not ready" or "Unable to connect" error, the skill kills only Chrome instances that were launched with its own baoyu-skills profile and retries. It states it must never kill all Chrome processes, because you may have regular Chrome windows open. Save any work in your normal Chrome before running it.

Because this works by automating the Weibo website, it can stop working if the site changes. It is not an official API integration.

• Runs scripts: yes
• Uses network: yes
• Reads and writes the clipboard during paste steps
• Keeps a saved Weibo login in a Chrome profile

Tips for better results

Keep article titles within 32 characters and summaries within 44 so the script does not truncate or rewrite them. Put your cover image path in the front matter so you do not need to repeat it.

If you use a custom browser profile, pass it with --profile or set a default Chrome profile in an EXTEND.md preferences file. The skill checks project, XDG and home-folder locations in that order.

• Use the Markdown file type for long articles and plain text for short posts
• Set a custom profile with --profile to keep the Weibo login separate
• Always read the output warnings before publishing