pixiv

What This Skill Does

The Pixiv skill for OpenClaw provides a powerful command-line interface for interacting with the Pixiv ecosystem directly from your local environment. It acts as an integration layer that allows users to search for artwork, browse trending rankings across multiple categories, view user profiles, and manage personal feeds. Beyond simple consumption, the skill also supports downloading high-quality artwork for local archival and includes a direct publishing feature for uploading new illustrations to your Pixiv account. By utilizing the official Pixiv AppAPI, this skill ensures a streamlined workflow for artists and fans alike without needing to manually navigate the browser interface for every action.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/matrix-meta/pixiv-skill. Once installed, configuration is required to authenticate with the Pixiv servers. You must first obtain a valid Pixiv Refresh Token. Once you have this token, navigate to the skill directory and execute the following command: node skills/pixiv/scripts/pixiv-cli.js login <YOUR_REFRESH_TOKEN>. This will save your credentials to the config.json file, granting the agent authorized access to your account data.

Use Cases

This skill is ideal for digital artists looking to automate their portfolio management, as well as art enthusiasts who want to curate local collections of their favorite illustrations. It is perfect for tracking daily trends, monitoring specific artists, and quickly downloading content for mood boarding or research purposes. Creators can also use the publishing functionality to script batch uploads of their generated or finished artwork directly from their file system to their Pixiv profile.

Example Prompts

1. "Search for the latest 'Cyberpunk' illustrations and download the first one found."
2. "Show me the current daily rankings for AI-generated art on Pixiv."
3. "Upload my latest drawing located at ./art/my-work.png to Pixiv with the tags 'original, portrait, digital-art' set to private."

Tips & Limitations

When using the publishing feature, note that the skill automatically applies AI-related tagging protocols. Always ensure your Refresh Token is kept secure and never shared. If the agent returns an authentication error, you may need to re-run the login command as refresh tokens can occasionally expire or be revoked by Pixiv's security systems. For bulk downloading, remember that images are saved into the downloads/ directory structured by ID, making it easy to organize your local library over time.