get_followers
Retrieve detailed follower information for a specific Weibo user by providing their unique identifier. Supports pagination and customizable limit to manage data retrieval efficiently.
Instructions
Get a Weibo user's followers.
Returns:
list[dict]: List of dictionaries containing follower information
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of followers to return, defaults to 15 | |
| page | No | Page number for pagination, defaults to 1 | |
| uid | Yes | The unique identifier of the Weibo user |
Implementation Reference
- src/mcp_server_weibo/server.py:113-126 (handler)MCP tool registration and handler for 'get_followers'. Decorated with @mcp.tool(), defines input parameters with descriptions and defaults, delegates execution to WeiboCrawler.get_followers.@mcp.tool() async def get_followers( ctx: Context, uid: Annotated[int, Field(description="The unique identifier of the Weibo user")], limit: Annotated[int, Field(description="Maximum number of followers to return, defaults to 15", default=15)] = 15, page: Annotated[int, Field(description="Page number for pagination, defaults to 1", default=1)] = 1 ) -> list[dict]: """ Get a Weibo user's followers. Returns: list[dict]: List of dictionaries containing follower information """ return await crawler.get_followers(uid, limit, page)
- Core implementation of get_followers in WeiboCrawler class. Makes HTTP request to Weibo API using specific containerid for followers, parses response, extracts user profiles from cards, limits results.async def get_followers(self, uid: int, limit: int = 15, page: int = 1) -> list[UserProfile]: """ Get followers of a specific Weibo user. Args: uid (int): The unique identifier of the Weibo user limit (int): Maximum number of followers to return, defaults to 15 page (int): The page number for pagination, defaults to 1 Returns: list[UserProfile]: List of UserProfile objects containing follower information """ async with httpx.AsyncClient() as client: try: params = { 'containerid': f'231051_-_followers_-_{str(uid)}', 'page': page, } encoded_params = urlencode(params) response = await client.get(f'{SEARCH_URL}?{encoded_params}', headers=DEFAULT_HEADERS) result = response.json() cards = result["data"]["cards"] if len(cards) < 1: return [] else: cardGroup = cards[-1]['card_group'] return [self._to_user_profile(item['user']) for item in cardGroup][:limit] except httpx.HTTPError: self.logger.error(f"Unable to get followers for uid '{str(uid)}'", exc_info=True) return []
- src/mcp_server_weibo/schemas.py:4-31 (schema)Pydantic model UserProfile defining the structure of follower profiles returned by get_followers tool.class UserProfile(BaseModel): """ Data model for a Weibo user's profile information. Attributes: id (int): User's unique identifier screen_name (str): User's display name profile_image_url (str): URL to user's profile image profile_url (str): URL to user's Weibo profile page description (str): User's profile description follow_count (int): Number of users the user is following followers_count (str): Number of followers (as string) avatar_hd (str): URL to user's high-resolution avatar image verified (bool): Whether the user is verified verified_reason (str): Reason for verification gender (str): User's gender """ id: int = Field() screen_name: str = Field() profile_image_url: str = Field() profile_url: str = Field() description: str = Field() follow_count: int = Field() followers_count: str = Field() avatar_hd: str = Field() verified: bool = Field() verified_reason: str = Field() gender: str = Field()