# browser_cookie3 详解 `browser_cookie3` 是一个 Python 库,能够从主流网页浏览器中加载 cookie 到 `cookiejar` 对象,让你无需手动登录就能通过 Python 访问浏览器中已登录的网页内容。 ## 核心特性 ### 1. 支持的浏览器 涵盖多平台主流浏览器,具体支持情况: |浏览器|Linux|MacOS|Windows| |---|---|---|---| |Chrome|✅|✅|✅| |Firefox|✅|✅|✅| |LibreWolf|✅|✅|✅| |Opera|✅|✅|✅| |Opera GX|-|✅|✅| |Edge|✅|✅|✅| |Chromium|✅|✅|✅| |Brave|✅|✅|✅| |Vivaldi|✅|✅|✅| |Safari|-|✅|-| |W3m|✅|-|-| |Lynx|✅|-|-| ### 2. Cookie 存储机制 - 多数浏览器(Chrome/Firefox 等)将 Cookie 存储在用户主目录的 SQLite 数据库中; - 部分浏览器(如 W3m/Lynx)存储在制表符分隔的 TXT 文件中。 ## 安装 通过 pip 安装最新版本(当前为 0.20.1): ```Bash pip install browser-cookie3 ``` ## 使用方法 ### 1. Python 代码中使用 #### 加载指定浏览器的 Cookie 以 Chrome 为例,结合 `requests` 访问网页: ```Python import browser_cookie3 import requests # 加载 Chrome 浏览器的 Cookie cj = browser_cookie3.chrome() # 访问需要登录的网页 r = requests.get("https://bitbucket.org", cookies=cj) print(r.content.decode('utf-8')) # 输出已登录状态的网页内容 ``` #### 加载所有浏览器的 Cookie 无需指定浏览器,自动加载所有支持浏览器的 Cookie: ```Python import browser_cookie3 import requests cj = browser_cookie3.load() r = requests.get("https://bitbucket.org", cookies=cj) print(r.content.decode('utf-8')) ``` #### 过滤指定域名的 Cookie 仅加载目标域名的 Cookie,减少冗余: ```Python import browser_cookie3 import requests # 仅加载 www.bitbucket.com 的 Chrome Cookie cj = browser_cookie3.chrome(domain_name='www.bitbucket.com') r = requests.get("https://bitbucket.org", cookies=cj) print(r.content.decode('utf-8')) ``` ### 2. 命令行使用 执行 `browser-cookie --help` 查看所有参数,常用示例: #### 查看指定浏览器+域名的 Cookie 值 ```Bash # 查看 Firefox 中 stackoverflow.com 的 acct 字段 Cookie browser-cookie --firefox stackoverflow.com acct ``` #### 输出 Cookie 的 JSON 详情 ```Bash # 以 JSON 格式输出 Chrome 中 stackoverflow.com 的 acct 字段 Cookie browser-cookie --json --chrome stackoverflow.com acct ``` #### 检查 Cookie 是否存在 ```Bash # 检查不存在的域名/Cookie,返回对应状态 browser-cookie nonexistent-domain.com nonexistent-cookie && echo "Cookie found" || echo "No cookie found" ``` ## 开发与贡献 ### 1. 计划中的不兼容变更(1.0 版本) - 优化 Cookie 文件检查顺序(如 Firefox 优先使用 `profiles.ini` 中定义的默认路径)。 ### 2. 贡献方向 目前已支持多平台主流浏览器,欢迎贡献: - 新增其他浏览器的支持; - 补充现有浏览器在未覆盖平台的适配; - 修复 Cookie 解析/加载的已知问题。 ## 许可证 该项目基于 **GNU LESSER GENERAL PUBLIC LICENSE v3** 开源,允许自由复制、分发和修改(需遵循许可证条款)。 ## 依赖说明 安装时自动依赖以下库: - `lz4`:数据压缩/解压缩; - `pycryptodomex`:Cookie 解密(如 Chrome 的加密 Cookie); - `dbus-python/jeepney`:Linux 下访问系统密钥库(依 Python 版本适配); - `shadowcopy`:Windows 下支持影子拷贝获取 Cookie; - 命令行入口依赖:`entry_points` 注册 `browser-cookie` 命令。 ## 常见问题 ### 1. 测试新鲜 Cookie 文件(排除用户环境问题) 以 Chrome/Chromium 为例(Linux/Mac): ```Bash # 启动临时 Chrome 实例,生成全新 Cookie 文件 google-chrome-stable --user-data-dir=browser_cookie3 # 关闭浏览器后,Cookie 文件位于 browser_cookie3/Default/Cookies ``` 访问如 `https://www.theverge.com/`(接受 GDPR 提示)生成测试用 Cookie,避免上传主目录的敏感 Cookie 文件。 ### 2. 版本更新记录 关键版本变更: - v0.20.0:新增 CLI、支持 Lynx/W3m/Arc 浏览器、Windows 影子拷贝、修复 ResourceWarning; - v0.14.0:新增 HTTPOnly 标记、修复 Firefox/Chromium Cookie 过期时间; - v0.11.4:支持 Chromium v80、优化 Cookie 文件缺失报错。 如果遇到问题,可在 [GitHub 仓库](https://github.com/borisbabic/browser_cookie3) 提交 Issue(需注明浏览器版本、操作系统)。