Weibo MCP Server

Instructions

Implementation Reference

• src/server.ts:18-30 (registration)

  Registers the 'search_users' MCP tool, defining its description, input schema with Zod, and inline handler that delegates to WeiboCrawler.searchWeiboUsers

  server.tool("search_users",
    "根据关键词搜索微博用户并返回匹配的用户列表",
    { 
      keyword: z.string().describe("查找用户的搜索词"),
      limit: z.number().describe("返回的最大用户数量")
    },
    async ({ keyword, limit }) => {
      const users = await crawler.searchWeiboUsers(keyword, limit);
      return {
        content: [{ type: "text", text: JSON.stringify(users) }]
      };
    }
  );

• src/weibo.ts:69-95 (handler)

  Implements the core logic for searching Weibo users by keyword: constructs API URL for mobile Weibo search, fetches data with axios, parses cards to extract user list, maps to SearchResult using toSearchResult helper, limits results.

  async searchWeiboUsers(keyword: string, limit: number): Promise<SearchResult[]> {
    try {
      const params = { 'containerid': `100103type=3&q=${keyword}&t=`, 'page_type': 'searchall' };
      const searchParams = new URLSearchParams();
      for (const [key, value] of Object.entries(params)) {
        searchParams.append(key, value);
      }
      const queryString = searchParams.toString();
      
      const response = await axios.get(`https://m.weibo.cn/api/container/getIndex?${queryString}`, {
        headers: DEFAULT_HEADERS
      });
      
      const result = response.data;
      const cards = result.data.cards;
      
      if (cards.length < 2) {
        return [];
      } else {
        const cardGroup = cards[1]['card_group'];
        return cardGroup.map((item: any) => this.toSearchResult(item.user)).slice(0, limit);
      }
    } catch (error) {
      console.error(`无法搜索关键词为'${keyword}'的用户`, error);
      return [];
    }
  }

• src/server.ts:20-23 (schema)

  Zod input schema for 'search_users' tool defining keyword (string) and limit (number) parameters.

  { 
    keyword: z.string().describe("查找用户的搜索词"),
    limit: z.number().describe("返回的最大用户数量")
  },

• src/weibo.ts:103-110 (helper)

  Helper method to transform raw Weibo user data into standardized SearchResult interface.

  private toSearchResult(user: any): SearchResult {
    return {
      id: user.id,
      nickName: user.screen_name,
      avatarHD: user.avatar_hd,
      description: user.description
    };
  }

• src/types.ts:19-39 (schema)

  TypeScript interface defining the output structure for search results (SearchResult[]).

  export interface SearchResult {
    /**
     * 用户的唯一标识符
     */
    id: number;
    
    /**
     * 用户的显示名称
     */
    nickName: string;
    
    /**
     * 用户高分辨率头像图片的URL
     */
    avatarHD: string;
    
    /**
     * 用户的个人简介
     */
    description: string;
  }