Pixiv Skill — AI skill for Claude Code

pixiv-skill

一个给 AI 助手用的 Pixiv 技能：搜索、看排行、查详情、下载插画、漫画、动图和小说。

技能本身是一份 `SKILL.md` 加一个 Python 脚本，遵循通用的 [Agent Skills](https://agentskills.io) 格式，所以 Claude Code、Codex、OpenClaw、Hermes Agent、DeepSeek Harness 等支持技能的助手都能用。脚本也可以脱离助手，直接在命令行里用。

功能

• 搜索：插画、漫画、小说分开搜；可按最新、最旧、热门（男性向 / 女性向）排序；可按收藏数筛选；可只看全年龄或只看 R-18。
• 排行榜：日榜、周榜、月榜、新人榜、原创榜、AI 榜、R-18 榜等，可按插画、漫画、动图过滤，可看历史日期。
• 详情：作品、小说、小说系列（含章节目录）、画师（含作品数和最新作品）。
• 下载：
  • 单张图直接保存原图；
  • 多页作品合成一个 PDF（超过 50 页自动分卷），也可以存成图片文件夹；
  • 动图（ugoira）转成 GIF；
  • 小说存成 TXT，Pixiv 的注音、章节、插图标记会转成可读文字；
  • 整个小说系列一键下载，合并成一个 TXT 或每篇一个文件。
• 链接直接用：作品、小说、系列、画师主页的链接都能自动识别。
• 对助手友好：结果是纯文本（或 --json），不用 Markdown，聊天软件里也能正常显示；每个下载的文件都会打印 SAVED: 路径；出错有明确的退出码。

安装

先装 Python 3.9 或更新版本，然后：

git clone https://github.com/elither-gpt/pixiv-skill.git
cd pixiv-skill
pip install -r requirements.txt

再把整个文件夹放到你的助手读取技能的目录。文件夹名建议用 `pixiv`：

助手	技能目录
Claude Code	~/.claude/skills/pixiv/
Codex	~/.codex/skills/pixiv/
OpenClaw	~/.openclaw/workspace/skills/pixiv/
Hermes Agent	~/.hermes/skills/pixiv/（Windows 为 %LOCALAPPDATA%\hermes\skills\pixiv\）
通用	~/.agents/skills/pixiv/ 或项目里的 .agents/skills/pixiv/

各家目录可能会变，以对应助手的文档为准。

DeepSeek Harness（dsh）

可以像上面一样放进 `~/.dsh/skills/pixiv/`，也可以当插件装，装好后技能会自动出现：

dsh plugin --profile web add github:elither-gpt/pixiv-skill

把 `web` 换成你用的配置名（如 `tui`、`headless`）。Python 依赖仍要自己装：`pip install -r requirements.txt`。

登录（可选）

不登录也能搜索和下载全年龄作品。R-18 作品、R-18 排行榜需要你自己的 Pixiv 登录凭证，其实只要 `PHPSESSID` 这一个值。

最省事的办法：

python scripts/pixiv.py cookie --login

脚本会打开一个全新的临时浏览器窗口（支持 Chrome、Edge、Brave、Chromium），你在里面自己登录 Pixiv，成功后窗口自动关闭，Cookie 自动保存。这个窗口不会读取你平时浏览器里的任何数据，用完就删；账号密码也只在 Pixiv 官网上输入，脚本碰不到。

也可以在浏览器开发者工具里手动复制 `PHPSESSID`，再运行 `python scripts/pixiv.py cookie --set -` 粘贴进去。各浏览器的详细步骤、手机上怎么弄、常见问题，见 **[获取 Cookie 教程](docs/cookie.md)**。

凭证保存在本机：Windows 是 `%APPDATA%\pixiv-skill\cookie.json`，其他系统是 `~/.config/pixiv-skill/cookie.json