Pixiv 集成:通过 Openclaw Skills 搜索、管理和发布艺术作品
作者:互联网
2026-04-17
什么是 Pixiv?
Pixiv 技能是一个强大的工具,旨在将全球最大的艺术社区直接集成到您的 AI 智能体环境中。作为 Openclaw Skills 库的核心组件,它允许开发者和艺术家通过编程方式与 Pixiv 交互,执行深度搜索、坚控每日或每周排行,并在无需打开浏览器的情况下管理用户个人资料。
除了简单的浏览,该技能还提供高级的内容管理功能。它支持下载高分辨率插画、漫画集,甚至动图 (ugoira) 文件。对于创作者,它通过 Pixiv AppAPI v2 提供简化的发布路径,支持直接上传新作品并具备自动 AI 标签支持。
下载入口:https://github.com/openclaw/skills/tree/main/skills/matrix-meta/pixiv-skill
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install pixiv-skill
2. 手动安装
将技能文件夹复制到以下位置之一
全局模式~/.openclaw/skills/
工作区
/skills/
优先级:工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 pixiv-skill。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。
Pixiv 应用场景
- 坚控每日、每周或每月艺术排行榜以获取创作灵感。
- 自动下载特定插画或整个漫画系列进行存档。
- 使用基于关键词的查询搜索高质量参考资料。
- 直接从开发流水线发布 AI 生成或原创艺术作品。
- 管理关注的用户动态,获取喜爱艺术家的最新更新。
- 技能初始化,通过存储在本地配置文件中的 Pixiv 刷新令牌进行身份验证。
- 通过 Node.js CLI 脚本发出命令,将用户意图转化为 Pixiv AppAPI v2 请求。
- 搜索和排行查询返回包含插画元数据、标签和用户信息结构化 JSON 数据。
- 下载请求触发资产获取进程,并将它们根据插画 ID 整理到唯一的本地目录中。
- 发布工作流使用直接文件路径引用来上传图像,包含标题、标签和可见性限制等元数据。
Pixiv 配置指南
要将其集成到您的 Openclaw Skills 设置中,您必须先获取 Pixiv 刷新令牌并通过 CLI 登录:
node skills/pixiv/scripts/pixiv-cli.js login
请确保您的配置保存在技能目录内的 config.json 文件中,以保持持久访问。
Pixiv 数据架构与分类体系
该技能将数据组织成结构化的 JSON 响应和本地文件系统,以便于检索:
| 功能 | 输出格式 | 关键元数据 |
|---|---|---|
| 搜索/排行 | JSON 数组 | 标题, URL, 标签, 用户 ID, AI 类型 |
| 下载 | 本地目录 | 保存至 downloads/ |
| 用户资料 | JSON 对象 | 用户名, 账号 ID, 关注数 |
| 发布 | API 响应 | 可见性确认和帖子 ID |
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
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
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 scripts/pixiv-cli.js download
Files are saved to downloads/. Returns JSON containing the list of downloaded files.
Publishing Illustrations (New)
To publish a new illustration directly to Pixiv using the AppAPI v2 (pure code, no browser needed):
node scripts/pixiv-cli.js post "" "[TAGS_COMMA_SEPARATED]" [VISIBILITY]
VISIBILITY:public(default),login_only,mypixiv, orprivate.- Automatic AI-generated tagging (
illust_ai_type: 2) is applied by default.
Example:
node scripts/pixiv-cli.js post "./output.png" "My New Art" "Original, Girl, AI" private
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_tokenin 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.
相关推荐
专题
+ 收藏
+ 收藏
+ 收藏
+ 收藏
+ 收藏
+ 收藏
最新数据
相关文章
ClawHub 发布:创建并部署 Openclaw 技能 - Openclaw Skills
DuckDuckGo 搜索:为 AI 提供即时网络访问 - Openclaw Skills
SynapseAI Wallet:AI 智能体托管支付 - Openclaw Skills
OSINT 图谱分析器:知识图谱与模式发现 - Openclaw Skills
Agent Relay Digest:精选 AI Agent 社区摘要 - Openclaw Skills
Pinterest API v5:自动化 Pin 和看板管理 - Openclaw Skills
FACEPALM:智能日志分析与聊天故障排除 - Openclaw 技能
clawback: 安全的 Gmail 代理与策略执行 - Openclaw Skills
Didit 身份验证:全球身份证件 OCR - Openclaw Skills
OpenClaw Git: 自动化工作区同步与备份 - Openclaw Skills
AI精选
