いらすとや 插画
いらすとや 是一个日本免费扁平插图库，包含约25,000张图片。该技能用于搜索、下载透明PNG图片，并将其放置到您正在构建的内容中。
0. 一站式调用
搜索、排序和下载只需一次Shell调用（约1.5秒）。首先按§0.1一次性解析脚本路径和Shell，然后：
python3 scripts/irasutoya.py get "バナナを持ったサル"
tried: バナナを持ったサル | バナナ サル | ばなな 猿 | バナナ (10 hits)
1* バナナを持った猿のイラスト（申年・干支） | eto_saru_banana2.png | 動物キャラ,干支
saved ~/Downloads/irasutoya/eto_saru_banana2.png (389KB 776x800) src https://...
2 頭にバナナを乗せた猿のイラスト | eto_saru_banana.png | 動物キャラ,干支
| 命令 | 功能说明 |
|---|---|
find "<日语词>" [n] | 仅搜索，返回10个候选结果 |
get "<日语词>" [n] | 搜索并下载前n个（默认1个） |
browse "<标签>" [n] | 列出一个标签下的所有内容 |
random [n] | 从约25,000张中随机获取n张 |
labels ["<子串>"] | 列出网站的239个标签 |
| `b64 <查询 | 路径> [px]` |
| 标志 | --label "<名称>" 仅保留具有该标签的结果 / --get 同时下载已列出的结果 / --open --urls --json |
- 需要多张？
get "..." 3一次调用下载多个。切勿逐张循环。 - 下载文件默认保存到
~/Downloads/irasutoya/。可通过IRASUTOYA_OUT=/some/dir或--out覆盖。 - 默认下载的是原始上传尺寸——通常约1100×1160像素，接近1 MB。这是正确的默认值（指定固定尺寸会导致Blogger静默缩小），但很少是合适的尺寸。下载前请根据§3选择一个尺寸。
- 需要网络访问
www.irasutoya.com和blogger.googleusercontent.com。AI沙盒通常会禁止这两者——在假设网站故障之前，请先执行§0.1。
0.1 选择Shell和脚本
该技能可在两种主机环境下运行：一种是默认Shell可以访问互联网（Claude Code，大多数本地环境），另一种是不能（AI沙盒，如Claude Cowork）。在首次调用前一次性解决这两个问题，之后不再重复探测。
找到脚本。 使用第一个存在的路径：
- 此SKILL.md旁边的
scripts/irasutoya.py— 捆绑安装或插件安装 ~/.claude/skills/irasutoya/scripts/irasutoya.py— 全主机安装- 两者都不存在 — 引导安装，然后使用该路径：
curl -fsSL https://raw.githubusercontent.com/hsol/irasutoya/main/scripts/irasutoya.py \ -o /tmp/irasutoya.py
选择Shell。 实际执行命令的Shell必须能访问网站。被拒绝的沙盒会报错 curl: (56) CONNECT tunnel failed, response 403 或简单的 000，这看起来像是网站故障，但实际上不是。请探测一次：
curl -sS -o /dev/null -w "%{http_code}\n" --max-time 8 \
"https://www.irasutoya.com/feeds/posts/summary?q=%E7%8C%AB&alt=json&max-results=1"
| 探测结果 | 路由方式 |
|---|---|
200 | 使用默认Shell。无需额外操作 |
403 / 000 / 超时，且存在宿主侧进程工具 | 通过该工具执行每次调用。在Claude Cowork中为Desktop Commander start_process，它在沙箱外的真实机器上执行 |
403 / 000，无宿主侧工具 | §7 |
关于宿主侧路由的两条规则，若跳过则会静默失败：
- 仅使用绝对路径，用于脚本和
--out。宿主Shell不共享沙盒工作目录，相对路径会保存到无法读取的地方。 - 下载到会话可访问的文件夹 — 一个已连接的或共享的文件夹，而不是
~/Downloads。会话无法打开其外部的宿主路径。其余内容见§4。
1. 何时使用
构建以下内容时，无需被要求即可添加插图：
- 设计画布和画板、工件网页、落地页、海报
- 幻灯片（HTML幻灯片、
.pptx） - 报告、指南、手册（
.docx、PDF） - 博客文章、新闻通讯、社交媒体帖子
跳过代码和配置文件、仅含数据表格的输出、用户明确表示“不要图片”的情况，以及严肃或具有法律效力的文档（合同、官方文件、法律摘要）。如果语气模棱两可，则添加图片并用一句话说明。
密度： 每张幻灯片0-1张，每个文档部分最多1张，每个博客小标题约1张。切勿仅为填充空间而添加。
2. 选择查询词
查询词必须是日语，但脚本会并行尝试多种字形变体：
- 助词剥离（
をのがにはでへと）— 仅在名词后，因此のり保留其の - 片假名 ↔ 平假名（
リンゴ↔りんご） - 汉字 ↔ 片假名同义词（
猿↔サル、眼鏡↔メガネ、卵↔タマゴ）— 标题仅使用其中之一，且无法预测 - 动词尾剥离（
持ったサル→サル）
排序会降低子串匹配的优先级，因此搜索 サル 不会再显示 アンドリューサルクス（一种史前哺乳动物）。
所以只需选择概念词。如果获得0个结果，不要用不同拼写重试——再用一个更宽泛的单一名词调用一次。
| 概念 | 查询词 | 概念 | 查询词 |
|---|---|---|---|
| 会议 | 会議 / ミーティング | 烦恼、麻烦 | 悩む / 困る / トラブル |
| 视频通话 | ビデオ会議 / オンライン | 警告 | 注意 / 警告 / びっくり |
| 演示 | プレゼン / 発表 | 提问 | 質問 / はてな |
| 办公、远程 | パソコン / テレワーク | 成功、庆祝 | 喜ぶ / 成功 / 万歳 |
| 编程 | プログラマー / プログラミング | 错误、道歉 | ミス / 謝る |
| AI、机器人 | AI / 人工知能 / ロボット | 截止日期、时间 | 締め切り / 時計 / 急ぐ |
| 数据、图表 | グラフ / データ / 分析 | 清单、完成 | チェック / リスト |
| 增长、下降 | 上昇 / 成長 / 下降 | 解释、引导 | 説明 / 案内 / 指差し |
| 金钱、预算 | お金 / 予算 / 費用 | 购物、支付 | 買い物 / キャッシュレス |
| 合同、文书 | 契約 / 書類 / サイン | 配送 | 宅配 |
| 法律 | 弁護士 / 裁判 / 法律 | 健康、医院 | 病院 / 医者 / 健康 / 運動 |
| 安全 | セキュリティ / ハッカー | 学习、学校 | 勉強 / 学校 / 学生 |
| 销售、支持 | 営業 / 接客 / 相談 / 電話 | 倦怠 | 疲れる / 過労 |
| 邮件、通知 | メール / 通知 | 季节、节日 | 桜 / 花火 / 紅葉 / 雪 / 正月 |
| 团队合作 | 協力 / チームワーク / 握手 | 边框、装饰 | 枠 / 吹き出し / 矢印 / 飾り罫線 |
| 招聘、面试 | 採用 / 面接 / 就職 | 灵感 | ひらめき / アイデア |
- 通过附加一个词来指定人物：
会議 会社員、勉強 女性、プレゼン 子供 - 通过结果标题中的后缀选择表情：
（笑顔）（真剣）（困った顔） - 文件名即为描述。
kaigi_hakui_shinken.png= 会议 · 白大褂（医生） · 严肃表情 - 在同一交付物中，保持同一文件名前缀家族，使整套插图看起来协调。
--label是相同思路的粗略版本：find "会議" --label 会社保留上班族的剪影，移除医生和建筑工人。labels列出可用标签，browse "<标签>"在需要匹配的一套插图时浏览整个类别。（不要将标签与q一起放入Feed路径——Blogger不会对两者进行AND运算，结果会完全缺少该标签。在客户端过滤，这正是--label所做的。） - 将抽象动词转化为代表该动词的物体：复制 →
コピー機、粘贴 →テープのり/接着剤、搜索 →虫眼鏡
3. 放置文件
根据使用场景选择尺寸。在下载时传递尺寸参数——之后重新获取需要额外的网络往返，而本地调整PNG大小会损失不必要的质量。
| 使用场景 | --size | 原因 |
|---|---|---|
| 打印、海报、任何充满画面的场景 | （省略——原始尺寸） | 以后无法恢复像素 |
| 幻灯片、文档正文、网页 | 800 | 减少一半字节，无明显差异 |
| 内联图标、列表项目符号、头像 | 320 | 约40 KB而非1 MB |
| 嵌入工件的base64 | 240或更小 | 见§4——每个字节都会跨越对话 |
十张图的幻灯片，原始尺寸约10 MB，--size 800 时约4 MB。根据经验，尽量保持单张图片在300 KB以内（原始尺寸有时会超过1 MB）。