| name | pixiv |
| description | Access Pixiv for searching illustrations, manga, and viewing rankings. Supports searching by keyword and viewing daily/weekly/monthly rankings. |
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:
- Ask the user for their Pixiv Refresh Token.
- 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:
- Direct them to look up "Pixiv Refresh Token" or use a tool like
gppt (Get Pixiv Token).
- 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).
- 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.
