176 lines
4.5 KiB
Markdown
176 lines
4.5 KiB
Markdown
|
||
|
||
# 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(需注明浏览器版本、操作系统)。 |