用途：XTwitterScraper 是面向 .NET 应用的 NuGet 包，用于通过强类型 SDK 访问 Xquik 的 X（推特）自动化 REST API，适合需要在 .NET 中搜索推文、读取推文与用户数据、运行提取任务、监控账号，或执行发帖、回复、点赞、转发、关注、私信等写操作，以及把 Xquik Webhook 事件接入 ASP.NET Core、后台任务或队列的场景。
主要能力：客户端 XTwitterScraperClient 可从环境变量读取 X_TWITTER_SCRAPER_API_KEY、X_TWITTER_SCRAPER_BEARER_TOKEN 和 X_TWITTER_SCRAPER_BASE_URL，也可手动配置；默认 API 基址为 https://xquik.com/api/v1。读路径包括推文搜索、推文详情、用户搜索、用户详情、个人资料推文、关注者、趋势、监控与提取任务；写路径包括发推、回复、点赞、转发、关注、私信、媒体上传与抽奖操作。请求使用类型化 Params 类（如 TweetSearchParams），返回类型化响应模型；二进制导出方法返回 HttpResponse，需按流处理；WithRawResponse 可查看状态、响应头或原始响应体；WithOptions 可对单次调用覆盖客户端选项。SDK 默认对部分瞬时故障重试。
使用方式：安装命令为 dotnet add package XTwitterScraper。凭据通过环境变量或密钥存储配置，优先使用 X_TWITTER_SCRAPER_API_KEY，除非测试夹具刻意覆盖，否则保持 X_TWITTER_SCRAPER_BASE_URL 默认值。在组合边界创建客户端并注入应用服务，避免在处理器中分散构造；用类型化 Params 构建请求而非手工拼接查询字符串；分页响应、提取任务、二进制导出与 Webhook 事件应作为不同流程处理；保留类型化异常，仅在可重试、可延迟或可展示有用状态处捕获限流、授权与 5xx 错误。
限制与注意：不要提交 API 密钥或本地环境文件；不要手工拼接 URL；导出端点可能返回二进制而非 JSON；避免用通用 Exception 掩盖 API 失败；重试写操作前需确认幂等性；Webhook 处理应先校验签名或事件真实性；生产代码不应全局覆盖 BaseUrl。单元测试应覆盖包装层，实时集成测试仅在显式配置凭据时运行。具体收费、价格与平台支持范围暂未提供。