hsol/irasutoya

Ilustraciones de いらすとや

いらすとや es una biblioteca japonesa con aproximadamente 25,000 ilustraciones planas gratuitas. Este skill las busca, descarga los PNG transparentes y los coloca en lo que estés construyendo.

0. Una sola llamada lo hace todo

La búsqueda, clasificación y descarga ocurren en una sola llamada de shell (~1.5 s). Resuelve la ruta del script y el shell una vez por sesión primero (§0.1), luego:

python3 scripts/irasutoya.py get "バナナを持ったサル"

probado: バナナを持ったサル | バナナ サル | ばなな 猿 | バナナ   (10 resultados)
 1* バナナを持った猿のイラスト（申年・干支） | eto_saru_banana2.png | 動物キャラ,干支
     guardado ~/Downloads/irasutoya/eto_saru_banana2.png (389KB 776x800)  src https://...
 2  頭にバナナを乗せた猿のイラスト | eto_saru_banana.png | 動物キャラ,干支

Comando	Qué hace
find "<japonés>" [n]	solo buscar, 10 candidatos
get "<japonés>" [n]	buscar + descargar los primeros n (por defecto 1)
browse "<etiqueta>" [n]	listar todo bajo una etiqueta
random [n]	n ilustraciones aleatorias de ~25,000
labels ["<substr>"]	listar las 239 etiquetas del sitio
`b64 <consulta	ruta> [px]`
Banderas	--label "<nombre>" conservar solo resultados con esa etiqueta / --get también descargar lo listado / --open --urls --json

• ¿Necesitas varias? get "..." 3 las descarga en una sola llamada. Nunca iteres una por una.
• Las descargas van a ~/Downloads/irasutoya/. Sobrescribe con IRASUTOYA_OUT=/algún/directorio o --out.
• El valor predeterminado es la subida original — a menudo ~1100×1160 y cerca de 1 MB. Esa es la opción correcta por defecto (pedir un tamaño fijo hace que Blogger reduzca la escala silenciosamente), pero rara vez es el tamaño adecuado. Elige uno según §3 antes de descargar.
• Requiere acceso de red a www.irasutoya.com y blogger.googleusercontent.com. Los sandboxes de agentes comúnmente deniegan ambos — §0.1 antes de asumir que el sitio está caído.

0.1 Qué shell, qué script

Este skill se ejecuta en dos tipos de anfitrión: uno donde el shell predeterminado llega a internet (Claude Code, la mayoría de configuraciones locales) y otro donde no (sandboxes de agente como Claude Cowork). Resuelve ambas preguntas una vez por sesión, antes de la primera llamada, y no vuelvas a probar después.

Encuentra el script. La primera ruta que exista gana:

1. scripts/irasutoya.py junto a este SKILL.md — instalaciones empaquetadas y de plugin
2. ~/.claude/skills/irasutoya/scripts/irasutoya.py — instalación en todo el anfitrión
3. ninguna — inícialo, luego usa esa ruta:

   curl -fsSL https://raw.githubusercontent.com/hsol/irasutoya/main/scripts/irasutoya.py \
     -o /tmp/irasutoya.py
   

Elige el shell. El sitio debe ser accesible desde el shell que realmente ejecuta el comando. Un sandbox denegado falla con curl: (56) CONNECT tunnel failed, response 403 o un simple 000, que parece que el sitio está caído y no lo está. Prueba una vez:

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"

Resultado de la prueba	Ruta
200	Usa el shell predeterminado. Nada más que hacer
403 / 000 / tiempo de espera, y existe una herramienta de proceso del lado del anfitrión	Ejecuta cada llamada a través de esa herramienta. En Claude Cowork es start_process de Desktop Commander, que se ejecuta en la máquina real fuera del sandbox
403 / 000, no hay herramienta del lado del anfitrión	§7

Dos reglas en la ruta del lado del anfitrión, ambas fallan silenciosamente si las omites:

• Solo rutas absolutas, para el script y para --out. El shell del anfitrión no comparte el directorio de trabajo del sandbox, y una ruta relativa termina en algún lugar que no puedes leer.
• Descarga en una carpeta que la sesión pueda ver — una carpeta conectada o compartida — no ~/Downloads. La sesión no puede abrir rutas del anfitrión fuera de ella. §4 cubre el resto.

1. Cuándo usarlo

Agrega una ilustración sin que te lo pidan al construir:

• lienzos de diseño y mesas de trabajo, páginas web del artefacto, páginas de aterrizaje, pósters
• presentaciones de diapositivas (diapositivas HTML, .pptx)
• informes, guías, manuales (.docx, PDF)
• publicaciones de blog, boletines, publicaciones en redes sociales

Saltarlo para archivos de código y configuración, salida solo de tablas de datos, cuando el usuario dijo "sin imágenes", y para documentos solemnes o legalmente vinculantes (contratos, presentaciones oficiales, alegatos legales). Si el tono es ambiguo, agrégalo y dilo en una línea.

Densidad: 0–1 por diapositiva, como máximo 1 por sección de documento, aproximadamente 1 por subtítulo de blog. Nunca agregues una solo para llenar espacio.

2. Elegir la consulta

Las consultas deben ser en japonés, pero el script prueba las variantes ortográficas por ti, en paralelo:

• eliminación de partículas (をのがにはでへと) — solo después de un sustantivo, así que のり conserva su の
• katakana ↔ hiragana (リンゴ ↔ りんご)
• sinónimos kanji ↔ katakana (猿↔サル, 眼鏡↔メガネ, 卵↔タマゴ) — los títulos usan solo uno de los dos, y cuál es impredecible
• eliminación de sufijos verbales (持ったサル → サル)

La clasificación degrada las coincidencias de subcadenas, por lo que buscar サル ya no muestra アンドリューサルクス (un mamífero prehistórico).

Así que simplemente elige la palabra del concepto. Si obtienes 0 resultados, no vuelvas a intentar con ortografías diferentes: llama una vez más con un solo sustantivo más amplio.

Concepto	Consulta	Concepto	Consulta
reunión	会議 / ミーティング	preocupación, problema	悩む / 困る / トラブル
videollamada	ビデオ会議 / オンライン	advertencia	注意 / 警告 / びっくり
presentar	プレゼン / 発表	pregunta	質問 / はてな
trabajo de escritorio, remoto	パソコン / テレワーク	éxito, celebración	喜ぶ / 成功 / 万歳
programación	プログラマー / プログラミング	error, disculpa	ミス / 謝る
IA, robots	AI / 人工知能 / ロボット	fecha límite, tiempo	締め切り / 時計 / 急ぐ
datos, gráficos	グラフ / データ / 分析	lista de verificación, hecho	チェック / リスト
crecimiento, declive	上昇 / 成長 / 下降	explicar, guiar	説明 / 案内 / 指差し
dinero, presupuesto	お金 / 予算 / 費用	compras, pago	買い物 / キャッシュレス
contratos, papeleo	契約 / 書類 / サイン	entrega	宅配
ley	弁護士 / 裁判 / 法律	salud, hospital	病院 / 医者 / 健康 / 運動
seguridad	セキュリティ / ハッカー	estudio, escuela	勉強 / 学校 / 学生
ventas, soporte	営業 / 接客 / 相談 / 電話	agotamiento	疲れる / 過労
correo, notificación	メール / 通知	estaciones, días festivos	桜 / 花火 / 紅葉 / 雪 / 正月
trabajo en equipo	協力 / チームワーク / 握手	marcos, decoración	枠 / 吹き出し / 矢印 / 飾り罫線
contratación, entrevistas	採用 / 面接 / 就職	ideas	ひらめき / アイデア

• Identifica a la persona agregando una palabra: 会議 会社員, 勉強 女性, プレゼン 子供
• Elige la expresión del sufijo en el título del resultado: （笑顔） （真剣） （困った顔）
• El nombre del archivo es la descripción. kaigi_hakui_shinken.png = reunión · bata blanca (médico) · cara seria
• Dentro de un mismo entregable, quédate en una familia de prefijo de nombre de archivo para que el conjunto se vea coherente. --label es la versión directa de la misma idea: find "会議" --label 会社 mantiene el recorte de oficinista y elimina a los médicos y trabajadores de construcción. labels lista lo que está disponible, browse "<etiqueta>" recorre una categoría completa cuando necesitas un conjunto que combine. (No pongas la etiqueta en la ruta del feed junto con q — Blogger no hace AND entre los dos, y obtienes resultados que carecen de la etiqueta por completo. Filtra del lado del cliente, que es lo que hace --label.)
• Convierte verbos abstractos en el objeto que los representa: copiar → コピー機, pegar → テープのり / 接着剤, buscar → 虫眼鏡

3. Colocar el archivo

Elige el tamaño según dónde vaya. Pásalo en el momento de la descarga — volver a obtenerlo después cuesta otro viaje de ida y vuelta, y redimensionar un PNG localmente cuesta calidad que no necesitabas perder.

Destino	--size	Por qué
Impresión, póster, cualquier cosa que llene el marco	(omitir — original)	No puedes recuperar los píxeles después
Presentación de diapositivas, cuerpo de documento, página web	800	La mitad de los bytes, sin diferencia visible
Icono en línea, viñeta de lista, avatar	320	~40 KB en lugar de ~1 MB
base64 en un artefacto	240 o menos	Ver §4 — cada byte cruza la conversación

Una presentación de diez imágenes es ~10 MB en original y ~4 MB con --size 800. Cuando se