holon-run/weibo-webmcp

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