pixiv

Pixiv Skill

This skill allows searching and browsing Pixiv illustrations.

Setup

Before using, you must have a valid Pixiv Refresh Token. The token is stored in config.json inside the skill directory.

To configure:

1. Ask the user for their Pixiv Refresh Token.
2. Run: node skills/pixiv/scripts/pixiv-cli.js login <REFRESH_TOKEN>

Usage

Searching Illustrations

To search for illustrations by keyword:

node skills/pixiv/scripts/pixiv-cli.js search "KEYWORD" [PAGE]

Example:

node skills/pixiv/scripts/pixiv-cli.js search "miku" 1

Returns a JSON array of illustration details (title, url, tags, user, etc.).

Viewing Rankings

To view rankings:

node skills/pixiv/scripts/pixiv-cli.js ranking [MODE] [PAGE]

Modes: day, week, month, day_male, day_female, week_original, week_rookie, day_ai. Default is day.

Example:

node skills/pixiv/scripts/pixiv-cli.js ranking day

Viewing User Profile

To view a user's profile details:

node skills/pixiv/scripts/pixiv-cli.js user <USER_ID>

Example:

node skills/pixiv/scripts/pixiv-cli.js user 11

Viewing Logged-in User Profile (Me)

To view the profile of the currently logged-in account (based on Refresh Token):

node skills/pixiv/scripts/pixiv-cli.js me

Viewing Followed Users (Following)

To list users that the logged-in account follows:

node skills/pixiv/scripts/pixiv-cli.js following [PAGE]

Viewing Feed (New Works from Followed Users)

To view latest illustrations from followed users:

node skills/pixiv/scripts/pixiv-cli.js feed [RESTRICT] [PAGE]

RESTRICT can be all, public, or private. Default is all.

Downloading Illustrations

To download an illustration (single image, manga/multiple, or ugoira zip):

node skills/pixiv/scripts/pixiv-cli.js download <ILLUST_ID>

Files are saved to skills/pixiv/downloads/<ILLUST_ID>/. Returns JSON containing the list of downloaded files.

How to get a Token (for User)

If the user asks how to get a token:

1. Direct them to look up "Pixiv Refresh Token" or use a tool like gppt (Get Pixiv Token).
2. Or tell them to log in to Pixiv in their browser, and look for the refresh_token in Local Storage or Cookies (though OAuth refresh token is cleaner).
3. The easiest way for non-technical users is to use a helper script, but we don't have one here. Just ask them to provide it.