Skip to main content
Glama
weibo-hot-search-mcp-server

weibo-hot-search-mcp-server

by Yooki-K

Weibo Hot Search MCP Server

This is a Weibo hot search data acquisition server based on the Model Context Protocol (MCP) framework, providing functions to fetch Weibo hot search list, hot search details, and comments.

Features

  1. Get Weibo Hot Search List

    • Display hot search rankings

    • Show hot search keywords

    • Show hot search index

  2. Get Hot Search Details

    • Topic category

    • Topic description

    • Topic link

    • Topic claim information

    • Statistics (reads, discussions, interactions, original posts)

  3. Get Hot Search Comments

    • Support getting comments from the first Weibo post or claim's post through hot search link

    • Configurable maximum comment fetch count

    • Display comment content and like count

Related MCP server: HotNews MCP Server

Requirements

  • Python >=3.10

  • Dependencies:

    • requests

    • lxml

    • mcp>=1.0.0

Installation

Installation from sources

  1. Clone the repository

git clone https://github.com/Yooki-K/weibo-mcp-server.git
  1. Install dependencies:

pip install -r requirements.txt

Note: If using uv run weibo_mcp_server, dependencies will be installed automatically, no need for pip install

Installation from Pypi

pip install weibo-mcp-server

Configuration

Create a Weibo account, press F12 to open developer tools, and get the cookie as shown below: Get Cookie

Run Project Locally

Add this tool to the MCP server

Cursor

On Windows: C:/Users/YOUR_USER/.cursor/mcp.json

{
  "mcpServers": {
    "weibo": {
      "command": "uv",
      "args": [
         "--directory",
         "path/to/weibo-mcp-server",
         "run",
         "weibo_mcp_server"
      ],
      "env":{
        "weibo_COOKIE": YOUR_WEIBO_COOKIE
      }
    }
  }
}

Claude

On Windows: %APPDATA%/Claude/claude_desktop_config.json

"weibo": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/weibo-mcp-server",
      "run",
      "weibo_mcp_server"
    ],
    "env": {
      "weibo_COOKIE": YOUR_WEIBO_COOKIE
    }
  }

License

MIT License - see LICENSE file for details.

Contributing

  1. Fork the repository

  2. Create your feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'Add some amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request

Available Tools

3 tools
WeiboGetHotSearchC

Get hot search from weibo.

Inputs: no named parameters.

WeiboGetHotSearchCommentByUrlC

Get hot search comment by url from weibo.

Inputs: url (required), claim_id, max_comments.

WeiboGetHotSearchDetailA

Get hot search detail by word from weibo. Sometimes the word is not found, that's normal.

Inputs: word (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool clearly targets a distinct function: listing hot searches, retrieving details for a specific word, and fetching comments for a URL. There is no overlap in purpose, so an agent can easily choose the correct tool.

    Naming Consistency5/5

    All tool names follow the same CamelCase pattern with the common prefix 'WeiboGetHotSearch' and a specific suffix indicating the operation (empty, Detail, CommentByUrl). This consistent naming convention makes the set predictable.

    Tool Count5/5

    Three tools provide a concise, focused surface for the server's stated purpose of accessing Weibo hot searches. This is within the ideal range and each tool contributes a distinct capability without unnecessary bloat.

    Completeness5/5

    The tool set covers the core workflow of browsing hot searches: listing them, getting details for a word, and fetching comments via URL. No obvious gaps exist for the narrow domain of hot search consumption.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides real-time hot trending topics and heat indices from nine major Chinese social media and news platforms including Weibo, Zhihu, and Bilibili. It enables users to fetch markdown-formatted news summaries and clickable links via the get_hot_news tool.
      1
      3
      MIT