weibo-hub

Use the WeiboClient hot_search() or hot_band() methods, which return the trending sidebar and full trending list as JSON without requiring login. Create the client in a with block and iterate over the returned list of topic dictionaries.

Authentication uses browser cookies instead of passwords. Log into weibo.com in a browser, extract cookies via browser_use get_cookies, then pass them to WeiboClient.setup_credential(), which saves them to a local credential file valid for 7 days.

Hot search, hot band, trending suggestions, hot feed, and keyword search all work without authentication. User profiles, home timelines, weibo details, comments, reposts, and follower lists require valid SUB and SUBP cookies.

The client raises SessionExpiredError when the API returns ok=-100 or a login-required message, meaning your cookies are stale. Re-extract cookies from a logged-in browser session and call setup_credential() again to refresh them.

Each request waits about one second plus Gaussian jitter, with a 5% chance of a 2-5 second pause to mimic reading behavior. HTTP 429 and 5xx responses trigger exponential backoff retries up to three times.

Only httpx version 0.27 or higher is required, on Python 3.10 or later. Install dependencies by running uv sync in the skill directory; no CLI, QR code, or browser-cookie libraries are needed.