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_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搜索图片风景 和 /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.2
File	Size	Uploaded
nonebot_plugin_pixiv_dl-0.2.2.tar.gz	71.5 kB	Oct 8, 2026	Details

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

Total release size: 107.5 kB

Download URL	nonebot_plugin_pixiv_dl-0.2.2.tar.gz
Size	71.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`0ee42a79d348080ad1cff316fe63aa3bd28558d2514c62989f2624d03dad33b6`
BLAKE2b-256 checksum How to use checksums	`2215ea7c136b3afaccbabe6d99118e4d03c4df238675be82f76d934a396df302`
Upload date	Oct 8, 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.2-py3-none-any.whl
Size	36.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`02a4110988cba88cdf5514752d1b02b54b1915fbe8b0c8fcac20e411fe4bdde9`
BLAKE2b-256 checksum How to use checksums	`33229521784ad5fb2ebfa16b5bccfd3001409d3bb75c0323327c6ba8dcb2cd0a`
Upload date	Oct 8, 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}`