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

在机器人项目的 .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_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`	空	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搜索图片风景 和 /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.0
File	Size	Uploaded
nonebot_plugin_pixiv_dl-0.2.0.tar.gz	71.5 kB	Oct 6, 2026	Details

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

Total release size: 108.7 kB

Download URL	nonebot_plugin_pixiv_dl-0.2.0.tar.gz
Size	71.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`81b78ff67a1b72f9fa124da599aa3bf44a0af20282e48700e727d14ae25d81a0`
BLAKE2b-256 checksum How to use checksums	`3cceb8bcd7b5827911cfb8f233e4aada7fb0694abb1f82370732447b58554449`
Upload date	Oct 6, 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.2.0-py3-none-any.whl
Size	37.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a5d496fee829bfb9b024935bf70f001ba623b8d79d4808490e4c4d933d0f1c8c`
BLAKE2b-256 checksum How to use checksums	`5cb6b13ba7dadae2d6c1356da90c084a02c98c30b2dee1f523a401cf111b5701`
Upload date	Oct 6, 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}`