快速开始 — Quasar

拿一个 API Key

注册并创建账户后，在 Web UI 即可签发 qak_ 开头的 API Key，明文仅展示一次，请立即妥善保存。

qak_khDD6Fv9****…****Xw2m

登录 CLI

先安装命令行工具（一行直达，无需配置 PyPI 源），再登录（注意：全局参数写在子命令之前）。login 会先验证 key 余额再落盘。

$ pip install https://www.quasar.oreoking.cn/dl/quasar_cli-0.1.0-py3-none-any.whl
$ quasar --api-key qak_**** \
    --base-url https://api.quasar.oreoking.cn login
ok — balance: 100000

离线 / 内网环境？直接下载安装包：quasar_cli-0.1.0-py3-none-any.whl · quasar_cli-0.1.0.tar.gz（源码包），本地执行 pip install ./quasar_cli-0.1.0-py3-none-any.whl 即可。

抓第一个页面

markdown 直出 stdout；加 --output screenshot 连整页截图一起拿走。

$ quasar scrape https://books.toscrape.com/ \
    -O out/ --output markdown --output screenshot
wrote out/markdown.md
wrote out/screenshot.png

不用命令行？打开 Web UI → Playground，点一下「运行」就能看到同样的结果。

速查

常见任务，复制即用

结构化采集（给程序吃）

$ quasar --json scrape https://example.com | jq .data
# {"markdown": "# Example Domain\n..."}

指定地区出口 IP

$ quasar scrape --proxy managed --proxy-geo CN \
    --proxy-sticky https://httpbin.org/ip

浏览器会话：填表并提交

$ quasar session create --proxy off
$ quasar session type $SID --selector input[name=q] --text hello
$ quasar session snapshot $SID   # 拿到 [ref=eN]
$ quasar session click $SID --ref e14

登录态复用

$ quasar jar bind my-jar --cookies-file c.json \
    --site https://example.com
$ quasar jar verify my-jar
$ quasar scrape  --jar my-jar

五分钟，拿到第一份数据