get_user_recent_tweets

Implementation Reference

• server.py:8-16 (handler)

  The main handler function for the 'get_user_recent_tweets' tool, which fetches and cleans recent tweets for a given username using the TwitterCrawler instance.

  @mcp.tool()
  def get_user_recent_tweets(username: str) -> list:
      data = twitter_crawler.get_timeline(username)
      new_tweets = twitter_crawler.clean_tweet_data(
          data['timeline'],
          data.get('prev_cursor'),
          data.get('next_cursor')
      )
      return new_tweets

• server.py:8-8 (registration)

  The @mcp.tool() decorator registers the get_user_recent_tweets function as an MCP tool.

  @mcp.tool()

• twitter_crawler.py:52-77 (helper)

  Helper method in TwitterCrawler class that fetches the user's timeline data from the RapidAPI Twitter endpoint.

  def get_timeline(self, username: str, cursor: Optional[str] = None) -> Dict:
      """获取用户时间线数据"""
      # logging.info(f'getTimeline params: {username} {cursor}')
  
      try:
          params = {'screenname': username}
          if cursor:
              params['cursor'] = cursor
  
          response = requests.get(
              'https://twitter-api45.p.rapidapi.com/timeline.php',
              headers=self.headers,
              params=params
          )
          data = response.json()
  
          if data.get('timeline'):
              timeline_info = 'empty array' if not data['timeline'] else \
                  [tweet.get('tweet_id') for tweet in data['timeline']]
              # logging.info(f'接口返回结果: {timeline_info}')
  
          return data
      except Exception as e:
          logging.error(f'获取{username}时间线数据失败: {str(e)}')
          return {}

• twitter_crawler.py:78-90 (helper)

  Helper method in TwitterCrawler class that cleans and formats the raw timeline data into a list of dictionaries with selected fields.

  def clean_tweet_data(self, timeline_data: List[Dict], prev_cursor: str, next_cursor: str) -> List[Dict]:
      """清理推文数据，提取所需字段"""
      return [{
          'tweet_id': tweet.get('tweet_id', ''),
          'created_at': tweet.get('created_at', ''),
          'favorites': tweet.get('favorites', 0),
          'bookmarks': tweet.get('bookmarks', 0),
          'text': tweet.get('text', ''),
          'views': tweet.get('views', '0'),
          'quotes': tweet.get('quotes', 0),
          'prev_cursor': prev_cursor,
          'next_cursor': next_cursor
      } for tweet in timeline_data]