from xhs_sdk import XhsClient
from xhs_sdk.exceptions import XhsAuthError

# 初始化客户端
client = XhsClient(cookie="你的Cookie")

try:
    # 获取当前用户信息
    user = client.get_current_user()
    print(f"用户名: {user.nickname} (ID: {user.user_id})")
    
    # 搜索笔记
    notes = client.search_notes("Python编程", limit=10)
    for note in notes:
        print(f"- {note.title} ({note.likes} 赞)")
        
except XhsAuthError:
    print("认证失败，请更新 Cookie")

import asyncio
from xhs_sdk import AsyncXhsClient

async def main():
    async with AsyncXhsClient(cookie="你的Cookie") as client:
        # 并发请求
        user, notes = await asyncio.gather(
            client.get_current_user(),
            client.search_notes("编程")
        )
        print(f"{user.nickname} 搜索到 {len(notes)} 篇笔记")

asyncio.run(main())

client = XhsClient(
    cookie: str,              # 必需：认证 Cookie
    timeout: int = 30,        # 请求超时时间（秒）
    max_retries: int = 3,     # 最大重试次数
    retry_delay: float = 1.0, # 重试延迟（秒）
    debug: bool = False,      # 调试模式
    proxy: dict = None        # 代理设置
)

user_id: str          # 用户ID
nickname: str         # 昵称
avatar: str          # 头像URL
description: str     # 个人简介
followers: int       # 粉丝数
following: int       # 关注数
notes_count: int     # 笔记数

note_id: str         # 笔记ID
title: str           # 标题
description: str     # 描述
author: User         # 作者信息
images: List[str]    # 图片列表
video: dict         # 视频信息
likes: int          # 点赞数
comments: int       # 评论数
collects: int       # 收藏数
created_at: datetime # 创建时间

comment_id: str      # 评论ID
content: str         # 评论内容
user: User          # 评论者
created_at: datetime # 创建时间
likes: int          # 点赞数

from xhs_sdk.exceptions import (
    XhsAuthError,      # 认证错误
    XhsAPIError,       # API 错误
    XhsNetworkError,   # 网络错误
    XhsRateLimitError  # 频率限制
)

try:
    notes = client.search_notes("test")
except XhsAuthError:
    print("Cookie 已失效")
except XhsRateLimitError:
    print("请求过于频繁")
except XhsAPIError as e:
    print(f"API 错误: {e.code} - {e.message}")

all_comments = []
cursor = ""

while True:
    page = client.get_note_comments(
        note_id="笔记ID",
        xsec_token="token",
        cursor=cursor
    )
    all_comments.extend(page.comments)
    
    if not page.has_more:
        break
    cursor = page.cursor
    
print(f"总共获取 {len(all_comments)} 条评论")

async def batch_search():
    async with AsyncXhsClient(cookie="cookie") as client:
        keywords = ["Python", "机器学习", "数据分析"]
        
        # 并发搜索
        results = await asyncio.gather(*[
            client.search_notes(kw, limit=5) 
            for kw in keywords
        ])
        
        for keyword, notes in zip(keywords, results):
            print(f"{keyword}: {len(notes)} 篇笔记")