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下载图片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.9
File	Size	Uploaded
nonebot_plugin_pixiv_dl-0.1.9.tar.gz	69.1 kB	Oct 6, 2026	Details

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

Total release size: 105.4 kB

Download URL	nonebot_plugin_pixiv_dl-0.1.9.tar.gz
Size	69.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`2d7261030dd2452be6985ef96c0a8fd19eb708d6057dc29bb083b027326bf156`
BLAKE2b-256 checksum How to use checksums	`e25bb6bc66713439cc92d750e6fe37cbd188c212dd168d0765d490958232abb8`
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.1.9-py3-none-any.whl
Size	36.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`1735fb53c140e9bf1a2a070e6425027297f4008116e4d66c61c2d3e9da537ec5`
BLAKE2b-256 checksum How to use checksums	`deb19c4cd04a44390a59df1a027e4557f23f089418161bc70ea939e04fca73e2`
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}`