ComfyUI Pixiv Browser Node

在 ComfyUI 中直接浏览 Pixiv，选图后输出为 IMAGE 张量，接入任意下游节点。

---

功能

功能	说明
📌 推荐作品	浏览 Pixiv 为你推荐的插画
🏆 排行榜	日榜/周榜/月榜等多种排行
⭐ 收藏作品	查看你收藏的所有插画
👥 收藏画师	左栏列出收藏画师，点击右栏展示其全部作品
🖼 多选输出	可框选多张图片，批量输出 IMAGE batch
♾ 无限滚动	所有页面均支持滚动到底部自动加载下一页
🔒 OAuth 登录	使用 pixivpy3 官方 PKCE 流程，token 本地保存，重启免登录

---

安装

1. 克隆到 ComfyUI custom_nodes

cd ComfyUI/custom_nodes
git clone https://github.com/wrt122311/comfyui-pixiv-node.git

2. 安装依赖

在 ComfyUI 的 Python 环境中执行：

pip install pixivpy3 Pillow

如果使用 ComfyUI 便携版，请用便携版自带的 python_embeded\python.exe -m pip install pixivpy3 Pillow

3. 重启 ComfyUI

控制台出现以下提示说明加载成功：

[PixivBrowser] Loaded successfully

---

首次登录

节点首次使用时需要完成登录，之后 token 自动保存，重启无需重新登录。

弹窗提供两种登录方式：

方式一：Refresh Token（推荐）

1. 在 ComfyUI 的 Python 环境中安装工具：

   pip install gppt
   

2. 运行登录命令（将邮箱和密码替换为你的账号）：

   gppt login-headless -u 你的邮箱 -p 你的密码
   

3. 复制终端输出中的 refresh_token 值
4. 在 ComfyUI 画布中添加 Pixiv Browser 节点，点击 🖼 浏览 Pixiv 按钮
5. 弹窗默认显示"🔑 Refresh Token（推荐）"标签，将 token 粘贴到输入框，点击 "保存并登录"
6. 弹窗自动切换到图片浏览界面，登录完成

方式二：OAuth 授权（备选）

适用于无法使用命令行工具的情况。

1. 点击节点上的 🖼 浏览 Pixiv 按钮，弹出弹窗
2. 切换到 "🌐 OAuth 授权" 标签
3. 点击 "① 用浏览器登录 Pixiv"，在新标签页完成 Pixiv 账号登录
4. 登录后查看浏览器地址栏，若出现以下格式的 URL：

   pixiv://account/login?code=XXXXXXXXXXXXXXXX&via=login
   

   将其完整复制，粘贴到弹窗输入框，点击 "② 确认登录"
5. 若地址栏始终未出现 pixiv:// 开头的 URL（部分浏览器/系统不支持），请改用方式一

Token 保存在节点目录下的 config.json，请勿将此文件提交到 git（已自动加入 .gitignore）

---

使用方法

浏览与选图

弹窗顶部有四个 Tab：

• 推荐 — Pixiv 为你推荐的最新插画
• 排行榜 — 每日排行榜（日榜）
• 收藏 — 你收藏的插画
• 画师 — 左侧列出你收藏的画师，点击画师名在右侧显示其全部作品

点击图片卡片即可选中（紫色边框 + 右上角序号角标），再次点击取消选中。
支持跨 Tab 多选，底部显示已选张数。

输出图片

选好图片后点击 ✓ 确认选择，关闭弹窗。
点击 ComfyUI 的 Queue Prompt，节点将下载所选图片的原图并以 IMAGE batch 形式输出。

---

节点参数

参数	类型	说明
artwork_ids	STRING（隐藏）	由弹窗写入的 artwork ID 列表，逗号分隔，通常无需手动填写

输出	类型	说明
images	IMAGE	形状 [B, H, W, 3]，float32，范围 [0, 1]，B 为选中图片数量

---

示例工作流

示例 1：预览 Pixiv 图片

最简单的工作流，浏览 Pixiv 后直接在 ComfyUI 中预览。

[Pixiv Browser] ──images──▶ [Preview Image]

步骤：

1. 添加 Pixiv Browser 节点
2. 添加 PreviewImage 节点
3. 将 Pixiv Browser 的 images 输出连接到 PreviewImage 的 images 输入
4. 点击节点上的按钮选好图片
5. Queue Prompt

---

示例 2：以 Pixiv 图为参考做图生图（img2img）

用 Pixiv 收藏的插画作为参考图，通过 img2img 生成新的图像。

[Pixiv Browser] ──images──▶ [VAE Encode] ──latent──▶ [KSampler] ──latent──▶ [VAE Decode] ──▶ [Preview Image]
                                                           ▲
                                           [CLIP Text Encode (prompt)]
                                           [Load Checkpoint] ──model / clip / vae──▶ 各节点

步骤：

1. 加载模型：Load Checkpoint → model、clip、vae
2. 添加 Pixiv Browser 节点，选好参考图
3. 添加 VAE Encode，将 Pixiv Browser 的 images 连接到 pixels，vae 连接到 vae
4. 添加 CLIP Text Encode，填写提示词
5. 添加 KSampler，连接 model、positive prompt、latent_image（来自 VAE Encode）
   • 建议 denoise 设为 0.6~0.8（值越低越接近原图）
6. 添加 VAE Decode 和 Preview Image
7. Queue Prompt

---

示例 3：批量保存 Pixiv 图片到本地

[Pixiv Browser] ──images──▶ [Save Image]

步骤：

1. 添加 Pixiv Browser 节点，选多张图
2. 添加 Save Image 节点，设置保存路径前缀
3. Queue Prompt，所有选中的图片会按序号保存到 ComfyUI/output/ 目录

---

工作流 JSON（示例 1）

将以下 JSON 保存为 .json 文件，在 ComfyUI 中通过 Load 导入即可：

{
  "last_node_id": 3,
  "last_link_id": 2,
  "nodes": [
    {
      "id": 1,
      "type": "PixivBrowser",
      "pos": [100, 200],
      "size": [210, 80],
      "flags": {},
      "order": 0,
      "mode": 0,
      "inputs": [],
      "outputs": [
        {"name": "images", "type": "IMAGE", "links": [1], "slot_index": 0}
      ],
      "properties": {},
      "widgets_values": [""]
    },
    {
      "id": 2,
      "type": "PreviewImage",
      "pos": [380, 200],
      "size": [210, 246],
      "flags": {},
      "order": 1,
      "mode": 0,
      "inputs": [
        {"name": "images", "type": "IMAGE", "link": 1}
      ],
      "outputs": [],
      "properties": {}
    }
  ],
  "links": [
    [1, 1, 0, 2, 0, "IMAGE"]
  ],
  "groups": [],
  "config": {},
  "extra": {},
  "version": 0.4
}

---

常见问题

Q: gppt login-headless 报错或找不到命令？
A: 确认在 ComfyUI 所用的 Python 环境中安装了 gppt：pip install gppt。便携版用户请用 python_embeded\python.exe -m pip install gppt。

Q: OAuth 登录后地址栏没有出现 pixiv:// 开头的 URL？
A: 部分浏览器（如 Chrome/Edge）在未安装 Pixiv 客户端时不会显示 pixiv:// 协议地址。请改用方式一（Refresh Token）登录。

Q: 登录后弹窗没有自动刷新？
A: 检查粘贴的 URL 是否完整，OAuth 方式要求以 pixiv://account/login?code= 开头。

Q: 图片加载不出来？
A: Pixiv 图片需要通过代理加载以绕过防盗链限制，代理由节点自动处理。若仍失败，检查网络是否能访问 Pixiv（可能需要代理工具）。

Q: 选好图片后 Queue Prompt 报错"所有图片下载失败"？
A: 原图下载需要网络能访问 i.pximg.net。请确认网络环境。

Q: 重启 ComfyUI 需要重新登录吗？
A: 不需要。token 保存在 config.json，重启后自动使用。

---

依赖

• pixivpy3 — Pixiv App API Python 客户端
• Pillow — 图像处理
• aiohttp — 已包含在 ComfyUI 中
• torch — 已包含在 ComfyUI 中

---

License

MIT