pixiv-cli
Unofficial Pixiv CLI and MCP server: search works, reverse-search images, bookmark and download from a terminal or an agent.
- 132 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Bookmarks, follows and comments run as your Pixiv account.
- Refresh tokens are plaintext and the remote HTTP mode of MCP reaches the server's files and network.
Install
- Works in
Manual install
brew install FlanChanXwO/tap/pixiv-cliThe recommended path for macOS and Linux; upgrade with `brew update && brew upgrade pixiv-cli`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Bookmarks, follows and comments run as your Pixiv account.
- Refresh tokens are plaintext and the remote HTTP mode of MCP reaches the server's files and network.
This is third-party code. Review the repository files before installing.
What it does
pixiv-cli is an unofficial Pixiv client written in Go. The `pixiv` command searches illustrations, novels and users with filters for rating, AI mode, resolution and bookmark count, shows all 16 ranking modes, recommendations and feeds, and finds a source by image through SauceNAO and ascii2d. Bookmarks, follows, comments and downloads (page ranges, Ugoira as GIF or APNG) run as the logged-in account. The `pixiv mcp` command starts an MCP server with the same features: local over stdio and remote over HTTP with OAuth. The repository ships an agent skill, `skills/pixiv-cli`, with a version check, token-handling rules and confirmation of changes. Pixiv Fanbox is read-only and uses a separate `FANBOXSESSID`.
Who it is for. People who build reference boards and collections on Pixiv and want to automate search and downloads from a terminal, scripts or an agent.
Good fit when
- You need illustrations for a tag without AI works and at high resolution.
- You have an unsigned image and look for its author through SauceNAO or ascii2d.
- All works of one creator are downloaded into a folder as a batch with a failure report.
- An agent collects the daily ranking feed and bookmarks the chosen items.
Not a fit when
- You need an official client: the project is not affiliated with Pixiv Inc.
- You work without a Pixiv account: the app API accepts only authenticated requests.
- Downloading would break Pixiv terms or creators' rights.
Example request
Find Pixiv illustrations tagged 初音ミク without AI works at high resolution and show the first five.Limitations
A Pixiv account and browser OAuth sign-in (`pixiv auth login`) are required. The project is unofficial and the README asks you to follow Pixiv terms and the law. The remote HTTP mode of MCP acts on the server's files and network, for example reverse search reads server-side paths, so only trusted clients should get access. Refresh tokens and export bundles are plaintext and must stay out of chat and logs. The agent skill is installed by hand: take `skills/pixiv-cli` from the tag matching your CLI version. Fanbox needs a separate `FANBOXSESSID`.
How to disable. Remove the `pixiv` server from the MCP client configuration and the binary itself (`brew uninstall pixiv-cli` for Homebrew). Drop saved accounts with `pixiv auth remove`.
FAQ
How do I connect pixiv-cli to an MCP client?
Add a `pixiv` server with the command `pixiv` and the argument `mcp` to the client configuration. The default mode is stdio and it uses accounts already saved by the CLI.
How do I run MCP over HTTP?
Run `pixiv mcp auth init` once, then `pixiv mcp --port 1270`; the server answers at `http://127.0.0.1:1270/mcp`. Behind an HTTPS proxy add `--base-url`.
How do I install without Homebrew?
There is `install.sh` for Linux and macOS, `install.cmd` for Windows, the Docker image `ghcr.io/flanchanxwo/pixiv-cli` and `go install`. The scripts verify the release SHA-256, but read them before running.
Can I download every work of a creator?
Yes: pass `pixiv download` a link such as `https://www.pixiv.net/users/12345678/artworks`. For a page range of one work there is the `--pages` flag.
How is the skill different from the CLI itself?
The CLI runs Pixiv commands. The `skills/pixiv-cli` skill teaches an agent to check the version, never disclose tokens and confirm account changes before bookmarks, follows and downloads.
Discussion
No questions or reviews yet.
Related
CLI toolsAn MCP server giving an agent 123 Aseprite tools for pixel art and animation, plus previews to check its own drawing
Skill, MCP server and CLI that let any agent call Codex image generation, after picking a style from several directions
Pixelbolt lets an agent draw and edit pixel art from a JSON recipe: sprites, effects and animations as PNG, GIF and atlases.
Skills for an agent that makes video, images, speech and music through the PixVerse CLI using ready pipelines.
Gyazo MCP server: the agent finds screenshots by keyword or app, reads text on captures through OCR and uploads new ones
Recraft's remote MCP server: an agent draws raster and vector images, edits a region, removes the background and upscales
README in short
The README lists install channels (Homebrew, scripts, Docker, Go), a one-minute quick start, the choice between CLI and MCP, an NDJSON pipeline diagram and documentation links. A separate block holds a prompt for an agent to install the CLI and the skill.