by FlanChanXwO
Pixiv, in your terminal — a CLI, MCP server, and Go SDK for discovery, accounts, creators, collections, and downloads.
# Add to your Claude Code skills
git clone https://github.com/FlanChanXwO/pixiv-cliGuides for using mcp servers skills like pixiv-cli.
pixiv-cli is an open-source mcp servers skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by FlanChanXwO. Pixiv, in your terminal — a CLI, MCP server, and Go SDK for discovery, accounts, creators, collections, and downloads. It has 55 GitHub stars.
pixiv-cli's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/FlanChanXwO/pixiv-cli" and add it to your Claude Code skills directory (see the Installation section above).
pixiv-cli is primarily written in Go. It is open-source under FlanChanXwO on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other MCP Servers skills you can browse and compare side by side. Open the MCP Servers category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh pixiv-cli against similar tools.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars
Unlocks once the catalog security scan passes (runs nightly).
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
Pixiv CLI · MCP stdio server · Go SDK
Install · Quick start · Interfaces · Documentation · Contributing
pixiv-cli brings the Pixiv ecosystem to the terminal: discover works and creators, manage accounts and collections, follow artists, bookmark artworks, and download visual works. It is an independent, unofficial third-party CLI, MCP server, and public Go SDK; it is not affiliated with or endorsed by Pixiv Inc. The CLI and MCP server both call the same public Go SDK, with the Pixiv App API as the authenticated source of truth. Use it in accordance with Pixiv's terms and applicable law.
Retry-After responses during pagination and download preparation.pixiv auth login, then use auth list, auth use, and auth check to manage local multi-account access..pixiv-cache metadata, resume verified partial data with Range and If-Range, and atomically replace completed files.Linux/macOS (sh):
curl -fsSLo /tmp/pixiv-install.sh https://github.com/FlanChanXwO/pixiv-cli/releases/latest/download/install.sh && sh /tmp/pixiv-install.sh --add-to-path
Windows Command Prompt (cmd.exe, no PowerShell):
curl.exe -fsSLo "%TEMP%\pixiv-install.cmd" https://raw.githubusercontent.com/FlanChanXwO/pixiv-cli/main/scripts/install.cmd && call "%TEMP%\pixiv-install.cmd" --add-to-path
Both scripts detect AMD64/ARM64, select the latest stable official Release archive, verify its published SHA-256,
preflight the staged binary, and install per-user before changing PATH. Use --no-path to leave PATH untouched or
--install-dir DIR to choose another destination. You can inspect the downloaded script before running it.
Versioned installers keep checksums.txt on the official GitHub HTTPS path. Embedded free source candidates are
probed only for the platform archive, must return the same checksum content, and the downloaded archive still has to
pass SHA-256 verification. This changes transport availability, never Release identity or integrity.
Copy this single prompt into Codex, Claude Code, Cursor, or another local AI agent with terminal access:
Install the latest stable pixiv-cli from https://github.com/FlanChanXwO/pixiv-cli for this machine: inspect the repository's scripts/install.sh or scripts/install.cmd first, choose the script matching the detected OS and architecture (the Windows path must use cmd.exe and must not invoke PowerShell), download only official GitHub Release assets, require the published SHA-256 check to pass before replacing anything, install per-user without administrator or root privileges, add only the chosen install directory to the user PATH, ask before installing any missing prerequisite, never read or output Pixiv credentials, verify with pixiv version, and report the installed version plus every file and PATH change.
Also install the `pixiv-cli` Skill that matches the same stable release tag (not main): download the full skills/pixiv-cli/ directory from that tag into the agent skills directory the user confirms. Do not guess the skills path and do not follow the main branch for skill content.
Agents with SkillHub support can install the published pixiv-cli Skill directly from SkillHub. The Skill has its own version and teaches the installed CLI; always use pixiv <cmd> --help as the final source of command syntax.
Agents using ClawHub can install the published pixiv-cli Skill with clawhub install pixiv-cli; pin the installed skill to the matching published release version rather than following an unversioned latest tag.
brew install FlanChanXwO/tap/pixiv-cli
Upgrade later with:
brew update
brew upgrade pixiv-cli
Use an exact published tag. A source install requires Go, cgo, a C linker, and the committed Rust static library for your target.
go install github.com/FlanChanXwO/pixiv-cli/cmd/pixiv@vX.Y.Z
Download a supported archive from GitHub Releases, or build the checkout:
sh scripts/build.sh
Direct downloads include checksums and a signed manifest. See the CLI reference for platform and trust details.
# Save a Pixiv account through browser OAuth.
pixiv auth login
# Search with App-side filters.
pixiv search "初音ミク" --type illust --ai-mode exclude --resolution high
pixiv novel search "初音ミク" --rating sfw --min-text-length 1000
# Follow creators and build your collection.
pixiv follow add 12345678
pixiv bookmark add 123456
# Inspect, discover recommendations, and download.
pixiv detail https://www.pixiv.net/artworks/123456
pixiv recommended all --limit 10
pixiv download https://www.pixiv.net/artworks/123456 --pages 1,3-5 --quality regular
pixiv download 123456 https://i.pximg.net/img-original/example.jpg --concurrency 8
# Batch-download every visual work from a creator.
pixiv download https://www.pixiv.net/users/12345678/artworks
Run pixiv --help or open the complete CLI reference for every command, flag, configuration key, environment variable, fallback rule, and update behavior.
Use the default text output interactively and --json where the command supports machine output:
pixiv ranking --mode day --json
pixiv user search "miku" --limit 10 --json
pixiv user detail 12345678
pixiv search-options "初音ミク"
Start the stdio server explicitly. stdout remains reserved for JSON-RPC. Operation summaries are written as daily plain-text files named YYYY-MM-DD.txt under ~/.pixiv-cli/logs (on Windows, %USERPROFILE%\.pixiv-cli\logs; default retention 7 days); the terminal stays free of log traces by default.
pixiv mcp
See the MCP tool contract for tools, parameters, structured output, and authentication behavior. Fixed MCP status, error, and display text is English; Pixiv metadata and user-supplied text are preserved verbatim.
client, err := pixiv.OpenDefault()
if err != nil {
// Handle local auth/configuration failure.
}
result, err := client.SearchIllust(ctx, pixiv.SearchIllustRequest{Word: "初音ミク"})
download, err := client.Download(ctx, "https://www.pixiv.net/artworks/123456")
Import github.com/FlanChanXwO/pixiv-cli/pixiv. Download/DownloadAll use documented beginner defaults; DownloadWith/DownloadAllWith expose paths, naming, pages, quality, and concurrency. The SDK guide documents models, cursors, resources, errors, and caller responsibilities.
pixiv auth login is the recommended setup. It saves raw Pixiv App OAuth refresh tokens by UID in the local account store.
Account names, IDs, membership signals, and the active local-account selection are convenience information from the local store and Pixiv responses. Treat them as convenience data rather than proof of account ownership, entitlement, or current Pixiv status. Verify important account details in Pixiv and use only accounts you are authorized to manage.
On macOS, desktop Linux, and Windows, an on-demand persistent pixiv:// callback handler supports local login and an explicitly configured cross-machine relay. The relay accepts the pixiv://account/login cal