hsol/irasutoya

いらすとや Illustrationen

いらすとや ist eine japanische Bibliothek mit rund 25.000 kostenlosen flachen Illustrationen. Diese Fertigkeit durchsucht sie, lädt die transparenten PNGs herunter und platziert sie in dem, was du gerade baust.

0. Ein Aufruf für alles

Suche, Bewertung und Download erfolgen in einem einzigen Shell-Aufruf (~1,5 s). Löse zuerst den Skript-Pfad und die Shell einmal pro Sitzung auf (§0.1), dann:

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

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

Befehl	Funktionsweise
find "<japanisch>" [n]	Nur suchen, 10 Kandidaten
get "<japanisch>" [n]	Suchen + die Top n herunterladen (Standard 1)
browse "<label>" [n]	Alle Einträge unter einem Label auflisten
random [n]	n zufällige Illustrationen aus ~25.000
labels ["<substr>"]	Die 239 Labels der Website auflisten
`b64 <anfrage	pfad> [px]`
Flags	--label "<name>" Nur Ergebnisse mit diesem Label behalten / --get Auch herunterladen, was aufgelistet wurde / --open --urls --json

• Brauchst du mehrere? get "..." 3 lädt sie in einem Aufruf herunter. Niemals einzeln in einer Schleife.
• Downloads landen in ~/Downloads/irasutoya/. Überschreibe mit IRASUTOYA_OUT=/irgendein/verz oder --out.
• Die Voreinstellung ist das Original-Upload – oft ~1100×1160 und nahe 1 MB. Das ist die richtige Voreinstellung (nach einer festen Größe zu fragen, skaliert Blogger stillschweigend herunter), aber es ist selten die richtige Größe. Wähle eine aus §3 vor dem Herunterladen.
• Erfordert Netzwerkzugriff auf www.irasutoya.com und blogger.googleusercontent.com. Agent-Sandboxes verweigern dies häufig – §0.1, bevor du annimmst, die Website sei down.

0.1 Welche Shell, welches Skript

Diese Fertigkeit läuft in zwei Arten von Hosts: einem, bei dem die Standard-Shell Internet erreicht (Claude Code, die meisten lokalen Setups) und einem, bei dem sie es nicht tut (Agent-Sandboxes wie Claude Cowork). Kläre beide Fragen einmal pro Sitzung, vor dem ersten Aufruf, und frage nicht erneut nach.

Finde das Skript. Der erste Pfad, der existiert, gewinnt:

1. scripts/irasutoya.py neben dieser SKILL.md – gebündelte und Plugin-Installationen
2. ~/.claude/skills/irasutoya/scripts/irasutoya.py – hostweite Installation
3. keiner – bootstrappe es, dann verwende diesen Pfad:

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

Wähle die Shell. Die Website muss von der Shell aus erreichbar sein, die tatsächlich den Befehl ausführt. Eine verweigerte Sandbox schlägt fehl mit curl: (56) CONNECT tunnel failed, response 403 oder einem bloßen 000, was sich so anhört, als sei die Website down, ist es aber nicht. Teste einmal:

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"

Testergebnis	Route
200	Verwende die Standard-Shell. Nichts weiter zu tun
403 / 000 / Timeout, und ein hostseitiges Prozess-Tool existiert	Führe jeden Aufruf über dieses Tool aus. In Claude Cowork ist es Desktop Commander start_process, das auf dem echten Rechner außerhalb der Sandbox ausgeführt wird
403 / 000, kein hostseitiges Tool	§7

Zwei Regeln für die hostseitige Route, die beide stillschweigend fehlschlagen, wenn du sie überspringst:

• Nur absolute Pfade, für das Skript und für --out. Die Host-Shell teilt nicht das Sandbox-Arbeitsverzeichnis, und ein relativer Pfad landet irgendwo, wo du nicht lesen kannst.
• Lade in einen Ordner herunter, den die Sitzung sehen kann – einen verbundenen oder freigegebenen Ordner – nicht ~/Downloads. Die Sitzung kann keine Host-Pfade außerhalb davon öffnen. §4 behandelt den Rest.

1. Wann man es verwenden sollte

Füge eine Illustration ohne Aufforderung hinzu, wenn du baust:

• Design-Canvases und Artboards, Artefakt-Webseiten, Landingpages, Poster
• Präsentationsfolien (HTML-Folien, .pptx)
• Berichte, Anleitungen, Handbücher (.docx, PDF)
• Blogbeiträge, Newsletter, Social-Media-Beiträge

Überspringe es bei Code- und Konfigurationsdateien, Ausgaben nur mit Datentabellen, wenn der Benutzer "keine Bilder" gesagt hat, und bei ernsten oder rechtsverbindlichen Dokumenten (Verträge, offizielle Einreichungen, juristische Schriftsätze). Wenn der Ton mehrdeutig ist, füge es hinzu und erwähne es in einer Zeile.

Dichte: 0–1 pro Folie, höchstens 1 pro Dokumentenabschnitt, ungefähr 1 pro Blog-Unterüberschrift. Füge niemals eines nur hinzu, um Platz zu füllen.

2. Die Suchanfrage auswählen

Suchanfragen müssen japanisch sein, aber das Skript versucht die orthografischen Varianten für dich parallel:

• Partikelentfernung (をのがにはでへと) – nur nach einem Nomen, also behält のり sein の
• Katakana ↔ Hiragana (リンゴ ↔ りんご)
• Kanji ↔ Katakana-Synonyme (猿↔サル, 眼鏡↔メガネ, 卵↔タマゴ) – Titel verwenden nur eine der beiden, und welche ist unvorhersehbar
• Verb-Schwanz-Entfernung (持ったサル → サル)

Die Rangfolge stuft Teilstring-Treffer herab, sodass die Suche nach サル nicht mehr アンドリューサルクス (ein prähistorisches Säugetier) anzeigt.

Wähle also einfach das Konzeptwort. Wenn du 0 Treffer bekommst, versuche es nicht mit anderen Schreibweisen – rufe ein weiteres Mal mit einem breiteren einzelnen Nomen auf.

Konzept	Suchanfrage	Konzept	Suchanfrage
Meeting	会議 / ミーティング	Sorge, Problem	悩む / 困る / トラブル
Videoanruf	ビデオ会議 / オンライン	Warnung	注意 / 警告 / びっくり
Präsentieren	プレゼン / 発表	Frage	質問 / はてな
Schreibtischarbeit, Remote	パソコン / テレワーク	Erfolg, Feier	喜ぶ / 成功 / 万歳
Programmieren	プログラマー / プログラミング	Fehler, Entschuldigung	ミス / 謝る
KI, Roboter	AI / 人工知能 / ロボット	Frist, Zeit	締め切り / 時計 / 急ぐ
Daten, Diagramme	グラフ / データ / 分析	Checkliste, erledigt	チェック / リスト
Wachstum, Rückgang	上昇 / 成長 / 下降	Erklären, Führen	説明 / 案内 / 指差し
Geld, Budget	お金 / 予算 / 費用	Einkaufen, Bezahlen	買い物 / キャッシュレス
Verträge, Papierkram	契約 / 書類 / サイン	Lieferung	宅配
Recht	弁護士 / 裁判 / 法律	Gesundheit, Krankenhaus	病院 / 医者 / 健康 / 運動
Sicherheit	セキュリティ / ハッカー	Lernen, Schule	勉強 / 学校 / 学生
Verkauf, Support	営業 / 接客 / 相談 / 電話	Burnout	疲れる / 過労
E-Mail, Benachrichtigung	メール / 通知	Jahreszeiten, Feiertage	桜 / 花火 / 紅葉 / 雪 / 正月
Teamarbeit	協力 / チームワーク / 握手	Rahmen, Dekoration	枠 / 吹き出し / 矢印 / 飾り罫線
Einstellung, Vorstellungsgespräche	採用 / 面接 / 就職	Ideen	ひらめき / アイデア

• Lege die Person fest, indem du ein Wort anhängst: 会議 会社員, 勉強 女性, プレゼン 子供
• Wähle den Ausdruck aus dem Suffix im Ergebnis-Titel: （笑顔） （真剣） （困った顔）
• Der Dateiname ist die Beschreibung. kaigi_hakui_shinken.png = Meeting · weißer Kittel (Arzt) · ernstes Gesicht
• Bleibe innerhalb eines Ergebnisses in einer Dateinamenspräfix-Familie, damit das Set zusammenhängend aussieht. --label ist die plumpe Version derselben Idee: find "会議" --label 会社 behält den Büroangestellten-Schnitt und lässt die Ärzte und Bauarbeiter weg. labels listet auf, was verfügbar ist, browse "<label>" durchläuft eine ganze Kategorie, wenn du ein passendes Set brauchst. (Setze das Label nicht zusammen mit q in den Feed-Pfad – Blogger verknüpft die beiden nicht mit UND, und du erhältst Ergebnisse, denen das Label vollständig fehlt. Filtere clientseitig, was --label tut.)
• Wandle abstrakte Verben in das Objekt, das sie repräsentiert: Kopieren → コピー機, Einfügen → テープのり / 接着剤, Suchen → 虫眼鏡

3. Die Datei platzieren

Wähle die Größe basierend darauf, wo sie hinkommt. Gib sie beim Download an – später erneut abrufen kostet eine weitere Runde, und das lokale Verkleinern eines PNG kostet Qualität, die du nicht verlieren musst.

Verwendet in	--size	Warum
Druck, Poster, alles, was den Rahmen füllt	(weglassen – Original)	Du kannst die Pixel später nicht zurückbekommen
Präsentationsfolien, Dokumententext, Webseite	800	Halbe Bytes, kein sichtbarer Unterschied
Inline-Icon, Listenpunkt, Avatar	320	~40 KB statt ~1 MB
base64 in einem Artefakt	240 oder weniger	Siehe §4 – jedes Byte überquert die Konversation

Ein Zehn-Folien-Deck ist ~10 MB im Original und ~4 MB bei --size 800. Wenn du