# Weibo Webmcp

> 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.

- Skill: `holon-run/weibo-webmcp` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add holon-run/weibo-webmcp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/holon-run/weibo-webmcp/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: holon-run (https://skillmd.com/u/holon-run)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/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:

```bash
--site weibo
```

The default profile path is:

```bash
~/.uxc/webmcp-profile/weibo
```

Refresh the link with:

```bash
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`