いらすとやイラスト
いらすとや は、約25,000点の無料フラットイラストが揃った日本のライブラリです。このスキルはそれを検索し、透明PNGをダウンロードして、あなたが構築しているものに配置します。
0. すべてを一度の呼び出しで
検索、ランキング、ダウンロードは1回のシェル呼び出し（約1.5秒）で行われます。最初にスクリプトのパスとシェルを解決し（§0.1）、その後以下のように実行します：
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で1回の呼び出しでダウンロード。1つずつループしないでください。 - ダウンロード先は
~/Downloads/irasutoya/。IRASUTOYA_OUT=/some/dirまたは--outで上書き可能。 - デフォルトはアップロードされたオリジナルで、多くの場合約1100×1160、約1MBです。それが適切なデフォルトですが（固定サイズを指定するとBloggerが静かにダウンスケールします）、適切なサイズではありません。ダウンロード前に**§3ごとに1つ選択**してください。
- ネットワークアクセスには
www.irasutoya.comとblogger.googleusercontent.comが必要です。エージェントサンドボックスでは通常両方が拒否されるため、サイトダウンと判断する前に§0.1を確認してください。
0.1 どのシェル、どのスクリプト
このスキルは2種類のホストで動作します。デフォルトシェルがインターネットに到達できるもの（Claude Code、ほとんどのローカル環境）と、できないもの（Claude Coworkなどのエージェントサンドボックス）です。両方の質問をセッションごとに1回解決し、最初の呼び出しの前に行い、その後再調査しないでください。
スクリプトを見つける。最初に存在するパスが採用されます：
- この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
シェルを選ぶ。コマンドを実際に実行するシェルからサイトに到達可能でなければなりません。拒否されたサンドボックスは 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 | デフォルトシェルを使用。他にすることはありません |
403 / 000 / タイムアウト、かつ ホスト側のプロセスツールが存在する場合 | すべての呼び出しをそのツール経由で実行。Claude Coworkでは Desktop Commander start_process を使用し、サンドボックス外の実際のマシンで実行されます |
403 / 000、ホスト側ツールなし | §7 |
ホスト側経路の2つのルール。スキップすると静かに失敗します：
- 絶対パスのみ使用（スクリプトと
--outに対して）。ホストシェルはサンドボックスのワーキングディレクトリを共有しないため、相対パスは読み取れない場所に配置されます。 - セッションが見えるフォルダにダウンロード — 接続または共有フォルダ —
~/Downloadsではありません。セッションは外部のホストパスを開けません。残りは§4で説明します。
1. いつ使うか
依頼されなくてもイラストを追加してください。以下のようなものを作成する場合：
- デザインキャンバス、アートボード、アーティファクトWebページ、ランディングページ、ポスター
- スライドデッキ（HTMLスライド、
.pptx） - レポート、ガイド、マニュアル（
.docx、PDF） - ブログ記事、ニュースレター、ソーシャル投稿
スキップするのは、コードや設定ファイル、データテーブルのみの出力、ユーザーが「画像なし」と言った場合、および厳粛または法的文書（契約書、公式提出書類、法的概要）の場合。トーンが曖昧な場合は追加し、その旨を一文で伝えてください。
密度： スライドあたり0〜1枚、ドキュメントセクションあたり最大1枚、ブログ小見出しあたり約1枚。スペースを埋めるためだけに追加しないでください。
2. クエリの選択
クエリは日本語である必要がありますが、スクリプトが並行して表記揺れを試行します：
- 助詞除去（
をのがにはでへと）— 名詞の後のみ、そのためのりはのを保持 - カタカナ ↔ ひらがな（
リンゴ↔りんご） - 漢字 ↔ カタカナの同義語（
猿↔サル、眼鏡↔メガネ、卵↔タマゴ）— タイトルはどちらか一方のみを使用し、どちらかは予測不能 - 動詞語尾除去（
持ったサル→サル）
ランキングは部分文字列一致を下げるため、サル で検索しても アンドリューサルクス（先史時代の哺乳類）は表示されなくなります。
したがって、概念語を選んでください。0件ヒットの場合、異なるスペルで再試行しないでください — より広い単一名詞で1回だけ呼び出してください。
| 概念 | クエリ | 概念 | クエリ |
|---|---|---|---|
| 会議 | 会議 / ミーティング | 悩み、トラブル | 悩む / 困る / トラブル |
| ビデオ通話 | ビデオ会議 / オンライン | 警告 | 注意 / 警告 / びっくり |
| プレゼン | プレゼン / 発表 | 質問 | 質問 / はてな |
| デスクワーク、リモート | パソコン / テレワーク | 成功、お祝い | 喜ぶ / 成功 / 万歳 |
| プログラミング | プログラマー / プログラミング | ミス、謝罪 | ミス / 謝る |
| AI、ロボット | AI / 人工知能 / ロボット | 締め切り、時間 | 締め切り / 時計 / 急ぐ |
| データ、グラフ | グラフ / データ / 分析 | チェックリスト、完了 | チェック / リスト |
| 成長、下降 | 上昇 / 成長 / 下降 | 説明、案内 | 説明 / 案内 / 指差し |
| お金、予算 | お金 / 予算 / 費用 | 買い物、支払い | 買い物 / キャッシュレス |
| 契約、書類 | 契約 / 書類 / サイン | 配送 | 宅配 |
| 法律 | 弁護士 / 裁判 / 法律 | 健康、病院 | 病院 / 医者 / 健康 / 運動 |
| セキュリティ | セキュリティ / ハッカー | 勉強、学校 | 勉強 / 学校 / 学生 |
| 営業、サポート | 営業 / 接客 / 相談 / 電話 | バーンアウト | 疲れる / 過労 |
| メール、通知 | メール / 通知 | 季節、休日 | 桜 / 花火 / 紅葉 / 雪 / 正月 |
| チームワーク | 協力 / チームワーク / 握手 | フレーム、装飾 | 枠 / 吹き出し / 矢印 / 飾り罫線 |
| 採用、面接 | 採用 / 面接 / 就職 | アイデア | ひらめき / アイデア |
- 単語を追加して人物を特定：
会議 会社員、勉強 女性、プレゼン 子供 - 結果タイトルの接尾辞から表情を選択：
（笑顔）（真剣）（困った顔） - ファイル名が説明です。
kaigi_hakui_shinken.png= 会議・白衣（医者）・真剣な表情 - 1つの成果物内では、同じファイル名プレフィックスのファミリーに留めて、セットに一貫性を持たせてください。
--labelは同じアイデアの大まかなバージョン：find "会議" --label 会社で会社員のイラストのみに絞り、医者や建設作業員を除外します。labelsで利用可能なラベルを一覧表示し、browse "<ラベル>"でマッチングセットが必要な場合にカテゴリ全体を閲覧します。（ラベルをフィードパスにqと一緒に入れないでください — BloggerはAND検索せず、ラベルが完全に欠落した結果が返ります。--labelでクライアント側でフィルタリングします。） - 抽象的な動詞をそれを表すオブジェクトに変換：コピー →
コピー機、貼り付け →テープのり/接着剤、検索 →虫眼鏡
3. ファイルの配置
配置先からサイズを選択し、ダウンロード時に指定してください。後で再取得すると追加のラウンドトリップが発生し、ローカルでPNGをリサイズすると不必要な品質低下が起こります。
| 配置先 | --size | 理由 |
|---|---|---|
| 印刷、ポスター、フレームを埋めるもの | （省略 — オリジナル） | 後でピクセルを取り戻せないため |
| スライドデッキ、ドキュメント本文、Webページ | 800 | 半分のバイト数で、見た目の差はなし |
| インラインアイコン、リスト箇条書き、アバター | 320 | 約40KBで、約1MBの代わり |
| アーティファクトへのbase64埋め込み | 240以下 | §4参照 — すべてのバイトが会話を跨ぐため |
10枚の画像デッキは、オリジナルで約10MB、--size 800 で約4MBです。