hsol/irasutoya

いらすとや 插圖

いらすとや 是一個收錄約 25,000 張免費平面插圖的日本圖庫。此技能可搜尋該圖庫、下載透明 PNG 檔案，並將其放置於您正在建立的任何內容中。

0. 一鍵搞定所有事

搜尋、排序和下載都在單一 shell 呼叫中完成（約 1.5 秒）。請先確定腳本路徑和 shell（§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 可一次呼叫下載。切勿逐一迴圈下載。
• 下載的檔案會儲存在 ~/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）。每次工作階段開始時，請先解決這兩個問題，之後無需再次探測。

尋找腳本。 第一個存在的路徑即為使用的腳本：

1. scripts/irasutoya.py 位於此 SKILL.md 旁 — 隨套件或外掛安裝
2. ~/.claude/skills/irasutoya/scripts/irasutoya.py — 主機層級安裝
3. 兩者皆不存在 — 自行啟動，然後使用該路徑：

   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。當您需要大量使用時，請合理利用空間。