A comprehensive CLI-based skill for searching, downloading, and publishing illustrations and manga on the Pixiv platform.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pixiv-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install pixiv-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Pixiv?
The Pixiv skill is a robust tool designed to integrate the world's largest art community directly into your AI agent's environment. As a key component of the Openclaw Skills library, it allows developers and artists to programmatically interact with Pixiv to perform deep searches, monitor daily or weekly rankings, and manage user profiles without opening a browser.
Beyond simple browsing, this skill provides advanced capabilities for content management. It supports downloading high-resolution illustrations, manga sets, and even ugoira (animated) files. For creators, it offers a streamlined publishing path through the Pixiv AppAPI v2, enabling the direct upload of new artwork with automated AI-tagging support.
Pixiv Use Cases
- Monitoring daily, weekly, or monthly art rankings for creative inspiration.
- Automating the download of specific illustrations or entire manga series for archival.
- Searching for high-quality reference material using keyword-based queries.
- Publishing AI-generated or original artwork directly from a development pipeline.
- Managing followed user feeds to stay updated on favorite artists.
How Pixiv Works
- The skill initializes by authenticating through a Pixiv Refresh Token stored in a local configuration file.
- Commands are issued via a Node.js CLI script, which translates user intent into Pixiv AppAPI v2 requests.
- Search and ranking queries return structured JSON data containing illustration metadata, tags, and user information.
- Download requests trigger a process that fetches assets and organizes them into unique local directories based on illustration IDs.
- Publishing workflows use direct file path references to upload images with metadata like titles, tags, and visibility restrictions.
Pixiv Setup
To integrate this with your Openclaw Skills setup, you must first obtain a Pixiv Refresh Token and log in via the CLI:
node skills/pixiv/scripts/pixiv-cli.js login <REFRESH_TOKEN>
Ensure that your configuration is saved in the config.json file within the skill directory to maintain persistent access.
Pixiv Data Schema & Taxonomy
The skill organizes data into structured JSON responses and local file systems for easy retrieval:
| Feature | Output Format | Key Metadata |
|---|---|---|
| Search/Ranking | JSON Array | Title, URL, Tags, User ID, AI Type |
| Downloads | Local Directory | Saves to downloads/<ILLUST_ID>/ |
| User Profiles | JSON Object | User Name, Account ID, Follow Count |
| Publishing | API Response | Confirmation of visibility and post ID |
Pixiv Advanced Features
- Direct publishing using AppAPI v2 for pure code-based uploads without browser reliance.
- Automated AI-generated tagging (
illust_ai_type: 2) for uploaded content. - Comprehensive support for specialized ranking modes including
day_ai,week_original, andweek_rookie. - Multi-page result fetching for searches, feeds, and followed user lists.
- Ugoira support for downloading and managing animated illustration ZIP files.
SKILL.md
Loading
Related Openclaw Skills
hex-vetter
A physical-layer hex auditing tool that detects hidden binary data, control characters, and encoding-based attacks in file packages.
Browser Use Automation
A powerful browser automation skill for managing social media platforms through persistent, authenticated sessions.
BenderStack Integration
A specialized skill for AI agents to interact securely with the BenderStack Q&A platform using advanced cryptographic verification.
YouTube Playlists
A Python-powered automation skill for programmatically creating, listing, and managing YouTube playlists via OAuth authentication.
Agent Emergence Test
A comprehensive testing framework designed to probe AI agents for emergent properties, self-awareness, and cognitive capabilities beyond their explicit training.
Bug Report Generator
A professional utility that transforms vague bug descriptions into structured, actionable reports with reproduction steps and severity levels.
METADATA
Featured*
