Files
Obsidian/MyArticles/Browser Cookie3 详解:功能特性与使用指南.md
T
coco 8b94d76799 a
2026-07-21 13:57:15 +08:00

4.5 KiB
Raw Blame History

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 ✅ - -
  • 多数浏览器(Chrome/Firefox 等)将 Cookie 存储在用户主目录的 SQLite 数据库中;

  • 部分浏览器(如 W3m/Lynx)存储在制表符分隔的 TXT 文件中。

安装

通过 pip 安装最新版本(当前为 0.20.1):

pip install browser-cookie3

使用方法

1. Python 代码中使用

以 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:

import browser_cookie3
import requests

cj = browser_cookie3.load()
r = requests.get("https://bitbucket.org", cookies=cj)
print(r.content.decode('utf-8'))

仅加载目标域名的 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 查看所有参数,常用示例:

# 查看 Firefox 中 stackoverflow.com 的 acct 字段 Cookie
browser-cookie --firefox stackoverflow.com acct
# 以 JSON 格式输出 Chrome 中 stackoverflow.com 的 acct 字段 Cookie
browser-cookie --json --chrome stackoverflow.com acct
# 检查不存在的域名/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 命令。

常见问题

以 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(需注明浏览器版本、操作系统)。