weibo-webmcp

name	weibo-webmcp
description	Connect to Weibo through the built-in local-mcp Weibo adapter and one fixed UXC link. Use when the user wants to read timelines, inspect posts, publish posts or comments, manage Weibo articles, or run Weibo search from an authenticated browser profile.

Weibo WebMCP

Use this skill to operate Weibo through the built-in --site weibo bridge preset in @webmcp-bridge/local-mcp.

For generic bridge setup patterns or non-Weibo sites, switch to $webmcp-bridge.

Prerequisites

• uxc is installed and available in PATH.
• npx is installed and available in PATH.
• Network access to https://weibo.com and https://s.weibo.com.
• On a fresh machine, or under an isolated HOME, install Playwright browsers first with npx playwright install.
• Weibo is auth-sensitive. Expect bootstrap_then_attach behavior when the profile is not signed in yet.

Core Workflow

1. Ensure the fixed Weibo link exists:
   • command -v weibo-webmcp-cli
   • if missing or pointed at the wrong profile, run skills/weibo-webmcp/scripts/ensure-links.sh
2. Inspect the bridge and tool schema before calling tools:
   • weibo-webmcp-cli -h
   • weibo-webmcp-cli timeline.home.list -h
   • weibo-webmcp-cli search.weibo -h
   • weibo-webmcp-cli search.ai.summary -h
3. Check authentication state first when the profile is new or looks stale:
   • weibo-webmcp-cli bridge.session.status
   • weibo-webmcp-cli auth.get
   • if the session is not ready, start bootstrap or switch to headed:
     • weibo-webmcp-cli bridge.session.bootstrap
     • weibo-webmcp-cli bridge.session.mode.set '{"mode":"headed"}'
     • weibo-webmcp-cli bridge.open
4. Use read tools for timeline, posts, and profiles:
   • weibo-webmcp-cli timeline.home.list limit=10
   • weibo-webmcp-cli post.get '{"url":"https://weibo.com/1648815335/QkMA02KXt"}'
   • weibo-webmcp-cli post.replies.list '{"id":"5279584255214211"}'
   • weibo-webmcp-cli post.repost.list '{"id":"5279584255214211"}'
   • weibo-webmcp-cli user.get screenName=jolestar
   • weibo-webmcp-cli user.posts.list '{"uid":"1648815335"}'
5. Use write tools carefully:
   • weibo-webmcp-cli post.create '{"text":"webmcp dry run","dryRun":true}'
   • weibo-webmcp-cli comment.create '{"id":"5279584255214211","text":"webmcp dry run","dryRun":true}'
   • weibo-webmcp-cli article.listDrafts
   • weibo-webmcp-cli article.draftMarkdown '{"markdownPath":"/abs/path/article.md"}'
   • weibo-webmcp-cli article.publishMarkdown '{"markdownPath":"/abs/path/article.md","coverImagePath":"/abs/path/cover.png","dryRun":true}'
6. Use search tools for public results and AI summaries:
   • weibo-webmcp-cli search.weibo '{"query":"OpenAI","limit":10}'
   • weibo-webmcp-cli search.ai.summary '{"query":"OpenAI"}'
7. Parse JSON output only:
   • success path: .ok == true, consume .data
   • failure path: .ok == false, inspect .error.code and .error.message

Default Target

The built-in preset uses:

--site weibo

The default profile path is:

~/.uxc/webmcp-profile/weibo

Refresh the link with:

skills/weibo-webmcp/scripts/ensure-links.sh

Guardrails

• Keep the Weibo profile isolated from other sites.
• Weibo uses bootstrap_then_attach; do not expect page tools to work until the managed profile is authenticated.
• Prefer dryRun: true before any real write operation on a user account.
• The current Weibo skill supports posting, commenting, and article drafting/publishing, but does not cover liking, following, deleting content, or account settings writes.
• timeline.home.list is network-first but may warm templates in a dedicated read page; do not assume the currently visible tab is the one serving data.
• search.weibo uses server-rendered results with page-number pagination, not a stable public JSON results API.
• search.ai.summary can return structured status without a non-empty summary body. Treat summary_unavailable as a valid no-summary state, not an automatic failure.
• Detail URLs returned by the adapter use uid/mblogid or uid/number_id; do not rewrite them into handle/number_id.
• Prefer explicit bridge.session.mode.set over relaunching the command to change runtime mode.
• If the user closes the visible Weibo window manually, the headed owner session ends. Run weibo-webmcp-cli bridge.open again if you still need a visible session on the same profile.

References

• Common command patterns:
  • references/usage-patterns.md
• Link creation helper:
  • scripts/ensure-links.sh