Xiaohongshu MCP Server

Instructions

Implementation Reference

• src/xiaohongshu_mcp/server.py:16-58 (handler)

  The main handler function for the 'xiaohongshu_login' MCP tool. It is decorated with @mcp.tool() for registration and uses type hints/docstring for schema. Orchestrates browser management and delegates login to XiaohongshuLogin class.

  @mcp.tool()
  async def xiaohongshu_login(
      headless: bool = False,
      chrome_path: Optional[str] = None
  ) -> str:
      """
      登录小红书账号
  
      Args:
          headless: 是否使用无头模式，默认False（建议使用有界面模式进行扫码）
          chrome_path: Chrome浏览器可执行文件路径，可选
  
      Returns:
          登录结果消息
      """
      try:
          logger.info("开始小红书登录流程...")
  
          # 创建浏览器管理器
          browser_manager = BrowserManager(
              headless=headless,
              chrome_path=chrome_path
          )
  
          async with browser_manager.get_page() as page:
              # 创建登录处理器
              login_handler = XiaohongshuLogin(page)
  
              # 执行登录
              success = await login_handler.login()
  
              if success:
                  logger.success("🎉 登录成功！")
                  return "✅ 小红书登录成功"
              else:
                  logger.error("❌ 登录失败")
                  return "❌ 小红书登录失败"
  
      except Exception as e:
          error_msg = f"登录过程中发生错误: {e}"
          logger.error(error_msg)
          return f"❌ {error_msg}"

• src/xiaohongshu_mcp/xiaohongshu/login.py:94-135 (helper)

  The core login logic implementation in XiaohongshuLogin class, called by the tool handler. Handles navigation, QR code waiting, and login status detection.

  async def login(self) -> bool:
      """
      执行登录流程
  
      Returns:
          bool: 登录成功返回True，失败返回False
      """
      try:
          logger.info("开始登录流程...")
  
          # 导航到小红书探索页，这会触发登录弹窗
          await self.page.goto(self.base_url)
          await self.page.wait_for_load_state("networkidle")
  
          # 等待2秒让页面完全加载
          await asyncio.sleep(2)
  
          # 检查是否已经登录
          if await self.check_login_status():
              logger.info("已经处于登录状态，无需重新登录")
              return True
  
          logger.info("等待用户扫码登录...")
          logger.info("请在浏览器中扫描二维码完成登录")
  
          # 等待登录成功的元素出现，最多等待5分钟
          try:
              await self.page.wait_for_selector(
                  self.login_indicator,
                  timeout=300000  # 5分钟超时
              )
              logger.success("🎉 检测到登录成功！正在保存登录状态...")
              return True
  
          except PlaywrightTimeoutError:
              logger.error("❌ 登录超时，请检查是否完成扫码")
              return False
  
      except Exception as e:
          logger.error(f"登录过程中出错: {e}")
          return False

• src/xiaohongshu_mcp/xiaohongshu/login.py:17-42 (helper)

  Helper method to check login status, used within the login process.

  async def check_login_status(self) -> bool:
      """
      检查登录状态
  
      Returns:
          bool: True表示已登录，False表示未登录
      """
      try:
          logger.info("正在检查登录状态...")
  
          # 导航到小红书探索页，使用更短的超时时间
          await self.page.goto(self.base_url, timeout=15000)
  
          # 只等待domcontentloaded，不等待networkidle
          await self.page.wait_for_load_state("domcontentloaded")
  
          # 等待页面基本元素加载
          await asyncio.sleep(2)
  
          # 尝试多种方式检查登录状态
          return await self._check_login_with_multiple_methods()
  
      except Exception as e:
          logger.error(f"检查登录状态时出错: {e}")
          return False