nonebot-plugin-pixiv-dl

基于 NoneBot2 的 Pixiv 搜索与下载插件

📖 介绍

支持 Pixiv 插图，漫画和小说的搜索，翻页与下载，通过 OneBot V11 发送结果

推荐使用 NB-CLI 安装

nb plugin install nonebot-plugin-pixiv-dl

其他安装方式

使用 pip 安装

pip install nonebot-plugin-pixiv-dl

从源码安装时，在插件目录执行

pip install .

使用 uv 时执行 uv pip install .

手动安装后，在机器人项目的 pyproject.toml 中追加插件，并确认已注册 OneBot V11 适配器

[tool.nonebot]
plugins = ["nonebot_plugin_pixiv_dl"]

已有 plugins 列表时只追加插件加载名即可

安装时会自动安装 nonebot-plugin-localstore，用于保存插件设置

在机器人项目的 .env 文件中配置，PIXIV_COOKIE 必填，其余配置可选，Cookie 不包含 Cookie: 前缀

PIXIV_COOKIE="PHPSESSID=替换为自己的会话值"
PIXIV_PROXY="http://127.0.0.1:7890"

配置项	默认值	说明
`PIXIV_COOKIE`	空	Pixiv 登录 Cookie
`PIXIV_R18`	`true`	是否允许搜索和下载 R18 作品
`PIXIV_SEARCH_LIMIT`	`20`	每批各分类的搜索结果上限
`PIXIV_SEARCH_PREVIEW`	`true`	是否显示插图，漫画和动图的静态缩略图
`PIXIV_PREVIEW_CONCURRENCY`	`4`	静态预览处理并发数，范围为 `1` 至 `16`
`PIXIV_PREVIEW_MAX_EDGE`	`512`	静态预览最长边像素上限，范围为 `64` 至 `1024`
`PIXIV_FORWARD_MAX_MESSAGES`	`20`	范围为 `2` 至 `99`，搜索时为每包作品数，另加 1 个提示节点，下载时为每包节点总数
`PIXIV_DOWNLOAD_MAX_PAGES`	`30`	漫画单次下载的页数上限
`PIXIV_NOVEL_MAX_CHAPTERS`	`50`	小说系列单次下载的章节上限
`PIXIV_TIMEOUT`	`20`	网络请求超时秒数
`PIXIV_PROXY`	空	Pixiv 请求代理，支持 HTTP 或 SOCKS
`PIXIV_FIXED_IP`	空	Pixiv 主站固定 IP，显式代理优先

代理与固定 IP 均未设置时使用系统 DNS 或环境代理

以下指令均可在群聊和私聊使用，插图指令同时支持动图

指令	说明
`/px搜索图片关键词`	搜索插图，默认显示预览
`/px搜索漫画关键词`	搜索漫画，默认显示预览
`/px搜索小说关键词`	搜索小说信息
`/px搜索关键词`	分别搜索插图，漫画和小说
`/px搜索下一页`	继续本人当前搜索的全部可用分类
`/px搜索图片下一页`	继续插图搜索
`/px搜索漫画下一页`	继续漫画搜索
`/px搜索小说下一页`	继续小说搜索
`/px下载图片 PID`	下载插图，动图发送 ZIP 和 MP4
`/px下载漫画 PID`	下载漫画原图
`/px下载小说 ID`	下载小说或所在系列的章节 TXT 文件
`/px下载 N`	下载当前结果序号，序号不存在时按 Pixiv ID 下载
`/px相关 N`	查看当前结果序号的相关作品，序号不存在时按 Pixiv ID 查询
`/px群R18 群号`	查看指定群的 R18 状态，仅限 SUPERUSER
`/px群R18 群号开` 或 `/px群R18 群号关`	调整指定群的 R18 开关，仅限 SUPERUSER
`/px设置`	查看自己的内容偏好，群聊中同时显示当前群 R18 状态
`/px设置 R18 开` 或 `/px设置 R18 关`	调整本人搜索与下载的 R18 开关
`/px设置 AI 开` 或 `/px设置 AI 关`	调整本人搜索与相关推荐的 AI 接收偏好

参数前可省略空格，例如 /px搜索图片风景 和 /px下载图片123456

本项目采用 MIT 许可证

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution for nonebot-plugin-pixiv-dl 0.2.3
File	Size	Uploaded
nonebot_plugin_pixiv_dl-0.2.3.tar.gz	83.2 kB	Oct 8, 2026	Details

Table of built distributions (wheels) for nonebot-plugin-pixiv-dl 0.2.3
File	Interpreter	ABI	Platform	Reset
nonebot_plugin_pixiv_dl-0.2.3-py3-none-any.whl 40.9 kB Oct 8, 2026	Python 3	none	any	Details

Total release size: 124.1 kB

Download URL	nonebot_plugin_pixiv_dl-0.2.3.tar.gz
Size	83.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`b0f19b61dabc466a7d77f224c67933d3b16baab15f8e581f17063ced36455534`
BLAKE2b-256 checksum How to use checksums	`69fdf0bfd6ff268e05edacf32e2d39e791518ffe972733af7fcc71135efa4404`
Upload date	Oct 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Download URL	nonebot_plugin_pixiv_dl-0.2.3-py3-none-any.whl
Size	40.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0b71f26be5ecca94dca813ae30054d58fa6e569f4d357c67df5975b5809a90c0`
BLAKE2b-256 checksum How to use checksums	`b762c542a5d4e94435a2dd801a90706f5e8a08ba66d19fbb6cd987fa14b3fab9`
Upload date	Oct 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`