nonebot-plugin-pixiv-dl

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

📖 介绍

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

Ugoira 在用户层面属于图片，无需额外的动图搜索或下载命令

推荐使用 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 列表时只追加插件加载名即可

在机器人项目的 .env 文件中设置 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_UGOIRA_PREVIEW_MAX_EDGE`	否	`256`	动图 GIF 预览最长边，范围为 `64` 至 `512`
`PIXIV_UGOIRA_PREVIEW_MAX_FRAMES`	否	`60`	动图 GIF 预览最多保留帧数，范围为 `1` 至 `120`
`PIXIV_FORWARD_MAX_MESSAGES`	否	`20`	每包转发的节点上限，最小为 `2`
`PIXIV_DOWNLOAD_MAX_PAGES`	否	`30`	漫画单次下载的页数上限
`PIXIV_NOVEL_MAX_CHAPTERS`	否	`50`	小说系列单次下载的章节上限
`PIXIV_TIMEOUT`	否	`20`	网络请求超时秒数
`PIXIV_PROXY`	否	空	网页和图片共用的 HTTP 或 SOCKS 代理
`PIXIV_FIXED_IP`	否	空	Pixiv 主站固定 IP，显式代理优先

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

以下指令均可在群聊和私聊使用

指令	说明
`/px搜索图片关键词`	搜索普通插画和 Ugoira，动图默认显示小尺寸 GIF 预览
`/px搜索漫画关键词`	搜索漫画，默认显示预览
`/px搜索小说关键词`	搜索小说信息
`/px搜索关键词`	分别搜索图片，漫画和小说
`/px搜索下一页`	继续本人当前搜索的全部可用分类
`/px搜索图片下一页`	继续图片搜索，包含普通插画和 Ugoira
`/px搜索漫画下一页`	继续漫画搜索
`/px搜索小说下一页`	继续小说搜索
`/px下载图片 PID`	下载插画原图，Ugoira 则发送原始帧 ZIP 和全尺寸无损 MP4
`/px下载漫画 PID`	下载漫画原图
`/px下载小说 ID`	下载小说或所在系列的章节 TXT 文件
`/px下载 PID`	自动识别作品类型并下载

参数前可省略空格，例如 /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.1.7
File	Size	Uploaded
nonebot_plugin_pixiv_dl-0.1.7.tar.gz	61.3 kB	Oct 3, 2026	Details

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

Total release size: 94.7 kB

Download URL	nonebot_plugin_pixiv_dl-0.1.7.tar.gz
Size	61.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`8bfdfe850140946bd91e81272e9795e1f73806f39670612dcca0e02998acf20e`
BLAKE2b-256 checksum How to use checksums	`87e78aceec50f3249c1bbf79fd510244d2b99bf993d4b25e1297744a6b4eaaa1`
Upload date	Oct 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.11.20 {"installer":{"name":"uv","version":"0.11.20","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.1.7-py3-none-any.whl
Size	33.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7185b3edb8a0396407ea22f9244dce25206864512df458751a21e053553bb29a`
BLAKE2b-256 checksum How to use checksums	`2538819e9b0d48c726e04d6333a0ea050bd0e9ca853887fc34af2b3bc7c66a56`
Upload date	Oct 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.11.20 {"installer":{"name":"uv","version":"0.11.20","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}`