📁 支持文件
references/platform-cookie-keys.md— 8 大平台 Cookie 关键字段速查表(zhihu/xhs/douyin/weibo/bilibili/公众号/快手/拼多多),含 HttpOnly 标记、有效期、反爬严度scripts/cookie_verify.py— Cookie 有效性一键验证(支持 5 大平台,自动判断有效/过期/状态不明)
Cookie 提取工作流(class-level skill)
从任何登录态网站提取 Cookie,喂给自动化脚本(curl/Playwright/requests),免登录、免验证码地调内部 API。
何时用这个 skill
✅ 用这个 skill 当:
- 老大要给自动化脚本喂登录态("我想自动发知乎"、"自动发小红书"、"自动抓微博")
- 已有脚本但 Cookie 失效("z_c0 过期了")
- 不知道哪个 Cookie 字段重要
- 不知道 Chrome 哪个扩展能用
❌ 不要用这个 skill 当:
- 老大要 OAuth/API key 接入(那走 API key 流程,不是 Cookie)
- 老大要 Playwright 自动登录(那是从零登录,不走 cookie 提取)
- 站点完全没登录态(公开 API 直接调)
核心 3 步流程
1. 浏览器登录目标站(带短信/扫码/2FA)
2. 提取关键 Cookie 字段(按平台各异)
3. 转成 curl/requests header 喂给脚本
1. 浏览器扩展选择(按推荐度)
| 扩展 | 评分 | 用户 | 优势 | 适用 |
|---|---|---|---|---|
| EditThisCookie (fork) | 4.4 ⭐ | 20K+ | Manifest V3、JSON/Netscape 导出、URL 解码、深色主题 | 首选 — 通用 |
| Get cookies.txt LOCALLY | 4.8 ⭐ | - | 一键 Netscape 格式(curl/wget 直接用) | 喂 curl 脚本 |
| Copy Cookies | 4.8 ⭐ | - | 点一下复制完整 cookie 到剪贴板 | 极简操作 |
| Cookie-Editor | 4.4 ⭐ | - | 现代 UI、过滤搜索 | 多账号管理 |
安装(Edge 浏览器)
1. 打开 edge://extensions/
2. 搜索 "EditThisCookie fork"
3. 认准:EditThisCookie (fork) by editthiscookiefork.com
4. 点 "获取" 安装
5. 浏览器右上角出现 🍪 图标
安装(Chrome 浏览器)
1. 打开 chrome://extensions/
2. 搜索 "EditThisCookie fork" 或访问 chromewebstore.google.com
3. 同上认准 fork 版(YoeriW 维护)
4. 点 "添加至 Chrome"
2. 手动 F12 提取(无需扩展)
适用场景:不想装扩展、临时一次、企业管控电脑。
步骤
1. 浏览器登录目标站
2. 按 F12 打开开发者工具
3. 切换到 Application 标签(不是 Elements!)
4. 左侧菜单:Storage → Cookies → https://<目标站>
5. 找关键字段(按平台表)
6. 双击 Value 复制
7. 发给小弟
Console 一键导出(更快)
F12 → Console 标签 → 粘贴:
// 导出所有 cookie 为 JSON
const cookies = document.cookie.split('; ');
const obj = {};
cookies.forEach(c => {
const [k, v] = c.split('=');
obj[k.trim()] = v;
});
console.log(JSON.stringify(obj, null, 2));
// 或单独拿关键字段
console.log('z_c0=' + (obj.z_c0 || 'NOT FOUND'));
console.log('SESSIONID=' + (obj.SESSIONID || 'NOT FOUND'));
限制:document.cookie 拿不到 HttpOnly 标记的 cookie(如 z_c0 通常是 HttpOnly)。
要拿 HttpOnly 字段必须用 F12 Application 标签,或用扩展。
3. 各平台关键 Cookie 字段表
| 平台 | 关键字段 | 数量 | 备注 |
|---|---|---|---|
| 知乎 zhihu.com | z_c0 / SESSIONID / __zse_ck |
3 | z_c0 是 HttpOnly |
| 小红书 xhslink.com | web_session / webId / a1 |
3+ | web_session 是核心 |
| 抖音 douyin.com | sessionid / ttwid / msToken |
3+ | ttwid 反爬关键 |
| 微博 weibo.com | SUB / SUBP / ALF |
3 | SUB 是核心登录态 |
| B 站 bilibili.com | SESSDATA / bili_jct / DedeUserID |
3 | SESSDATA 是核心 |
| 微信公众号 | wxtoken / pass_ticket / uin |
5+ | 复杂,需公众号工具 |
| 快手 kuaishou.com | kuaishou.server.web_st / kpf |
2 | web_st 是核心 |
| 微信公众号视频号 | 同公众号 | - | 需扫码 |
知乎 Cookie 三件套(详细)
{
"z_c0": "Mi4xQUFBQ...",
"SESSIONID": "3a8b9c0d1e2f...",
"__zse_ck": "001A1B2C3D-..."
}
z_c0— 登录态凭证(HttpOnly,最重要)。丢了 = 登出SESSIONID— 会话 ID。配合 z_c0 用__zse_ck— 反爬加密参数。知乎 API 调用必带
最小可用:只提 z_c0 也行,API 调用失败再加另外两个。
小红书 Cookie 三件套
{
"web_session": "040721b3e0f...",
"webId": "7f3a2b1c8d9e...",
"a1": "1234567890abcdef..."
}
web_session— 登录凭证(HttpOnly)a1— 设备指纹webId— 用户 ID
抖音 Cookie 三件套
{
"sessionid": "abc123def456...",
"ttwid": "1%7C...",
"msToken": "xyz789..."
}
sessionid— 核心登录态ttwid— 反爬关键msToken— 设备 token
4. Cookie 转 HTTP Header
通用格式
Cookie: name1=value1; name2=value2; name3=value3
Python 构造(最稳)
def cookies_to_header(cookies: dict) -> str:
"""把 {"z_c0": "...", "SESSIONID": "..."} 转成 Cookie header"""
return "; ".join(f"{k}={v}" for k, v in cookies.items())
# 用法
header = cookies_to_header({
"z_c0": "Mi4xQUFBQ...",
"SESSIONID": "3a8b...",
})
# → "z_c0=Mi4xQUFBQ...; SESSIONID=3a8b..."
# requests 调用
import requests
r = requests.get("https://www.zhihu.com/api/v4/...", headers={"Cookie": header})
# curl 调用
import subprocess
subprocess.run(["curl", "-H", f"Cookie: {header}", "https://..."])
字符串格式(老大直接粘给小弟)
最简形式(带前缀):
z_c0=Mi4xQUFBQ...; SESSIONID=3a8b...; __zse_ck=001A1B2C3D-...
或 JSON:
{"z_c0":"Mi4xQUFBQ...","SESSIONID":"3a8b...","__zse_ck":"001A1B2C3D-..."}
两种都收,小弟按情况解析。
5. Cookie 有效性验证
提完 Cookie 先验证再用,避免在失效 Cookie 上调 1 小时 API。
方法 A:curl 测登录态
# 知乎 — 访问"我的"页面看是不是已登录
curl -s -H "Cookie: z_c0=***" https://www.zhihu.com/api/v4/me
# 返 {"id":"xxx","name":"xxx",...} = 有效
# 返 {"error":{"code":100}} = 失效
方法 B:requests 测
import requests
cookies = {"z_c0": "Mi4xQUFBQ...", "SESSIONID": "3a8b..."}
r = requests.get("https://www.zhihu.com/api/v4/me", cookies=cookies, timeout=10)
print(r.status_code, r.json().get('name', r.text[:200]))
方法 C:Playwright 加载 Cookie 测
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch(headless=True)
page = browser.new_page()
page.context.add_cookies([
{"name": "z_c0", "value": "Mi4xQUFBQ...", "domain": ".zhihu.com", "path": "/"},
{"name": "SESSIONID", "value": "3a8b...", "domain": ".zhihu.com", "path": "/"},
])
page.goto("https://www.zhihu.com")
if page.locator(".Avatar").is_visible():
print("✅ 登录态有效")
else:
print("❌ Cookie 失效")
browser.close()
6. 过期检测与重提
典型过期信号
| 信号 | 平台 | 含义 |
|---|---|---|
返 {"code": 100, "msg": "未登录"} |
知乎 | 登录态失效 |
| 返 401/403 | 通用 | Cookie 被拒 |
| 跳转到 /login | 通用 | 需要重新登录 |
API 返 "登录已过期" |
小红书/微博 | 重新提 |
自动重提策略
def is_cookie_expired(resp_json: dict) -> bool:
"""各平台过期检测启发式"""
code = resp_json.get('code') or resp_json.get('error', {}).get('code')
msg = str(resp_json.get('msg') or resp_json.get('error', {}).get('message', ''))
expired_signals = [
'未登录', '请登录', '登录已过期', 'token expired',
'unauthorized', 'invalid session', 'not login'
]
if code in [100, 401, 403]:
return True
if any(sig in msg.lower() for sig in expired_signals):
return True
return False
# 用法
import requests
r = requests.get(API_URL, cookies=cookies)
if is_cookie_expired(r.json()):
print("⚠️ Cookie 失效,请重新提取")
# 触发老大重新提 Cookie
7. 关键 pitfall
7.1 HttpOnly cookie 拿不到
症状:F12 → Console 跑 document.cookie → 看不到 z_c0 / web_session / sessionid。
根因:HttpOnly 标记的 cookie 不暴露给 JS,只能在 Network/Application 标签看到。
解决:
- 装 EditThisCookie (fork) — 它能读 HttpOnly
- 或 F12 → Application → Cookies(手动找)
- 永远不要让老大"在 Console 跑 JS 拿 cookie" — 拿不全
7.2 Cookie 域名不对
症状:Cookie 提了但 API 返 401。
根因:cookie 有 domain 字段(.zhihu.com / www.zhihu.com)。www. 前缀或 . 前缀不一致时,浏览器不发送。
解决:
- domain 填
.zhihu.com(带点)— 匹配所有子域 - 不要填
zhihu.com(不带点)— 只匹配根域
7.3 Cookie 顺序敏感
症状:3 个 cookie 都提了,单放某个返 401,组合 OK。
根因:某些站点 API 后端按 cookie 顺序校验(虽然标准不要求)。
解决:
- 保持提 cookie 时的原顺序
- Python 字典保持插入顺序(Py3.7+)
- 存 cookie 时按 F12 看到的顺序写
7.4 HTTPS Only
症状:本地测试 HTTP 服务 OK,放生产 HTTPS 服务返 401。
根因:cookie 设了 Secure 标志,只在 HTTPS 传。
解决:
- 生产必须 HTTPS
- 测试用
Secure=False的 cookie(web_session默认有 Secure 标志)
7.5 Cookie 过期时间 ≠ Session 过期时间
症状:浏览器显示 cookie 还有 7 天,但 API 返"登录失效"。
根因:cookie 本身的 Expires/Max-Age 是 cookie 浏览器存续时间,登录态可能提前失效(异地登录、密码改、安全事件)。
解决:
- 每次跑自动化前先验证 cookie(5 秒)
- 准备备用账号 cookie(1 主 + 1 备)
8. 工作流速查
老大第一次提 Cookie
1. 浏览器登录(带短信/扫码)
2. 装 EditThisCookie (fork) 扩展
3. 点 🍪 图标
4. 点导出按钮(向下箭头)
5. 选 JSON 格式
6. 复制字符串发给小弟
小弟拿到 Cookie 后
import json, subprocess
# 1. 解析
cookies_str = '老大发的字符串'
cookies = {}
if cookies_str.startswith('{'):
cookies = json.loads(cookies_str)
else:
# "k1=v1; k2=v2" 格式
for kv in cookies_str.split('; '):
k, v = kv.split('=', 1)
cookies[k] = v
# 2. 验证(必须先验证!)
hdr = "; ".join(f"{k}={v}" for k, v in cookies.items())
r = subprocess.run(['curl','-s','-H',f'Cookie: {hdr}','https://www.zhihu.com/api/v4/me'],
capture_output=True, text=True, timeout=10)
print("验证响应:", r.stdout[:200])
# ✅ 返 {"id":"..."} = 有效
# ❌ 返 {"code":100} = 失效,让老大重提
# 3. 转成 requests/Playwright 用的格式
import requests
session = requests.Session()
session.cookies.update(cookies)
# 或 Playwright 见上面
9. 关联
hermes-secret-handling— Cookie 也算"凭证",不走泄露code-project-analysis— 分析项目里 Cookie 是怎么用的hermes-llm-endpoints— LLM key 走 OAuth/API key 流程(不靠 Cookie)browser-automation— Playwright/Selenium 操作浏览器(自动登录 vs Cookie 提取)
10. 速查:失败诊断树
Cookie 提取后 API 失败
├─ 返 401 / 未登录
│ ├─ z_c0 没拿全(HttpOnly 漏掉)→ 装 EditThisCookie (fork) 重提
│ ├─ Cookie 顺序错 → 按 F12 看到的顺序重排
│ ├─ domain 不对 → 改成 .zhihu.com(带点)
│ └─ 过期了 → 重新登录 + 重提
├─ 返 403 / Forbidden
│ └─ 缺反爬参数(__zse_ck / msToken / ttwid)→ 提全
├─ 返 404
│ └─ API 路径错 → 查目标站 API 文档
└─ 返 200 但内容空
└─ 反爬 → 加 User-Agent / Referer / 加频率限制