いらすとや 일러스트레이션
いらすとや는 약 25,000개의 무료 플랫 일러스트레이션을 제공하는 일본어 라이브러리입니다. 이 스킬은 이를 검색하고 투명 PNG를 다운로드하여 빌드 중인 모든 작업에 배치합니다.
0. 하나의 호출로 모든 것을 처리
검색, 순위 매기기, 다운로드는 단일 셸 호출(약 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으로 한 번에 다운로드합니다. 절대 하나씩 반복하지 마세요. - 다운로드 파일은
~/Downloads/irasutoya/에 저장됩니다.IRASUTOYA_OUT=/some/dir또는--out으로 변경 가능합니다. - 기본값은 원본 업로드이며, 종종 약 1100×1160, 1MB에 가깝습니다. 이것이 올바른 기본값이지만(고정된 크기로 요청하면 Blogger가 자동으로 다운스케일하므로), 실제로 적절한 크기는 거의 아닙니다. 다운로드 전에 §3에 따라 하나를 선택하세요.
- 네트워크 접근이
www.irasutoya.com과blogger.googleusercontent.com에 필요합니다. 에이전트 샌드박스는 일반적으로 둘 다 차단합니다. 사이트가 다운되었다고 가정하기 전에 §0.1을 먼저 확인하세요.
0.1 사용할 셸과 스크립트
이 스킬은 두 종류의 호스트에서 실행됩니다. 하나는 기본 셸이 인터넷에 접근 가능한 경우(Claude Code, 대부분의 로컬 설정)이고, 다른 하나는 그렇지 않은 경우(Claude Cowork와 같은 에이전트 샌드박스)입니다. 세션당 한 번, 첫 번째 호출 전에 두 질문을 모두 확인하고 이후에는 다시 확인하지 마세요.
스크립트 찾기. 존재하는 첫 번째 경로를 사용합니다:
scripts/irasutoya.py(이 SKILL.md 옆) — 번들 및 플러그인 설치~/.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 |
호스트 측 경로에 대한 두 가지 규칙이 있으며, 둘 다 건너뛰면 조용히 실패합니다:
- 절대 경로만 사용하세요(스크립트 및
--out에 대해). 호스트 셸은 샌드박스 작업 디렉터리를 공유하지 않으므로 상대 경로는 읽을 수 없는 위치에 저장됩니다. - 세션이 볼 수 있는 폴더(연결되거나 공유된 폴더)에 다운로드하고,
~/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와 함께 피드 경로에 레이블을 넣지 마세요. Blogger는 두 조건을 AND 처리하지 않아 레이블이 전혀 없는 결과가 반환됩니다.--label이 수행하는 것처럼 클라이언트 측에서 필터링하세요.) - 추상 동사를 그것을 나타내는 객체로 변환하세요: 복사 →
コピー機, 붙여넣기 →テープのり/接着剤, 검색 →虫眼鏡
3. 파일 배치
사용할 위치에 따라 크기를 선택하고 다운로드 시에 전달하세요. 나중에 다시 가져오는 것은 추가 왕복 비용이 들고, PNG를 로컬에서 리사이즈하면 불필요하게 품질이 저하됩니다.
| 용도 | --size | 이유 |
|---|---|---|
| 인쇄, 포스터, 프레임을 채우는 모든 것 | (생략 — 원본) | 나중에 픽셀을 되돌릴 수 없음 |
| 슬라이드 데크, 문서 본문, 웹 페이지 | 800 | 절반 바이트, 눈에 띄는 차이 없음 |
| 인라인 아이콘, 목록 글머리 기호, 아바타 | 320 | ~40 KB (1 MB 대비) |
| 아티팩트에 base64 포함 | 240 이하 | §4 참조 — 모든 바이트가 대화를 가로지름 |
10개 이미지 데크는 원본 기준 약 10MB, --size 800에서는 약 4MB입니다.