pixiv-cli

A command line for Pixiv. One pure-Go binary, no account or API key required.

pixiv ranking                          # daily illustration ranking (top 50)
pixiv ranking --mode weekly --content manga --limit 20
pixiv ranking --mode rookie -o json
pixiv modes                            # list all modes and content types

Output is a table when you are at a terminal and JSONL when you pipe, so jq and friends work with no flags.

Installation

Download a prebuilt binary from the releases page.

macOS / Linux

VERSION=0.1.0
OS=darwin      # or linux
ARCH=arm64     # or amd64
curl -fsSL -O "https://github.com/tamnd/pixiv-cli/releases/download/v${VERSION}/pixiv_${VERSION}_${OS}_${ARCH}.tar.gz"
tar -xzf "pixiv_${VERSION}_${OS}_${ARCH}.tar.gz"
mv pixiv /usr/local/bin/

go install

go install github.com/tamnd/pixiv-cli/cmd/pixiv@latest

Docker

docker run --rm ghcr.io/tamnd/pixiv:latest ranking --mode daily

Commands

Command	Description
pixiv ranking	Fetch the Pixiv ranking
pixiv modes	List available ranking modes and content types
pixiv version	Print version information

Ranking flags

Flag	Default	Description
--mode	daily	Ranking mode: daily, weekly, monthly, rookie, original
--content	illust	Content type: illust, manga, ugoira
--page	1	Page number (each page has up to 50 items)
-n, --limit	50	Max records to return

Output flags

Flag	Description
-o, --output	Format: table, json, jsonl, csv, tsv, url, raw
--fields	Comma-separated columns to include
--no-header	Omit header row
--template	Go text/template per record

Examples

# Top 10 daily illustrations as JSON
pixiv ranking --mode daily -n 10 -o json

# Weekly manga ranking, URLs only
pixiv ranking --mode weekly --content manga -o url

# Rookie illustrations, specific fields as CSV
pixiv ranking --mode rookie --fields rank,title,artist,tags -o csv

# Pipe to jq
pixiv ranking -o jsonl | jq -r '.title'

# List all available modes
pixiv modes

License

Apache-2.0. pixiv-cli is an independent tool and is not affiliated with Pixiv Inc.