4.5 KiB
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):
pip install browser-cookie3
使用方法
1. Python 代码中使用
加载指定浏览器的 Cookie
以 Chrome 为例,结合 requests 访问网页:
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:
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,减少冗余:
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 值
# 查看 Firefox 中 stackoverflow.com 的 acct 字段 Cookie
browser-cookie --firefox stackoverflow.com acct
输出 Cookie 的 JSON 详情
# 以 JSON 格式输出 Chrome 中 stackoverflow.com 的 acct 字段 Cookie
browser-cookie --json --chrome stackoverflow.com acct
检查 Cookie 是否存在
# 检查不存在的域名/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):
# 启动临时 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 仓库 提交 Issue(需注明浏览器版本、操作系统)。