用途：在 Python 项目中封装 Bright Data 官方 SDK 与 REST 契约，形成应用自有的类型化接口，避免厂商对象直接进入业务代码。
主要能力：固定并审查 SDK 依赖版本；定义返回规范化记录与回执（如 CollectionReceipt）的应用端口；将 API key、代理区域、Browser API 适配器分离；把文档化的终止状态与 x-brd-* 错误映射为稳定的应用失败类型；用合成契约夹具验证边界。
使用方式：先读取锁文件并用 Grep 查找直接导入 Bright Data 的位置，通过仓库依赖流程固定已审查的 SDK 版本；再编写应用接口，返回规范化记录和 provider 回执而非原始 SDK 响应；分别实现各产品适配器；最后用 Bash(python:*) 运行类型检查与夹具测试，升级前对照官方 SDK 文档。示例中通过自有协议暴露 trigger_collection、get_progress、download_snapshot，并在边界保留厂商响应夹具，下游只依赖 CollectionReceipt。
适用场景：需要接入 Bright Data 采集、进度查询、快照下载等操作，同时希望隔离供应商升级、隐藏产品与成本策略、保持可测试性的 Python 项目。
限制：需要 Python 项目具备锁文件和受支持运行时，并已批准 Bright Data 产品与凭据模式；实时 SDK 调用需单独授权流程；资料未提供具体价格、平台支持范围或完整安装命令。