いらすとや MCP

支援者が日本の無料イラスト図庫「いらすとや」で画像を探すためのツール。保健指導資料、学習プリント、プレゼン資料づくりに使います。

台湾の病院・診療所の保健指導資料では、この図庫が大量に使われています。問題は、日本語のキーワードしか受け付けないこと—— 「注意力散漫」のイラストを探したいとき、サイト上では 集中 や 気が散る と入力する必要がありますが、 あなたは何を打てばいいのか分かりません。

この MCP の価値はネット接続を代行することではなく、その言語の壁を越えさせることにあります。

你說：幫我找「注意力不集中」的插圖
它做：認出「注意力」→ 展開成日文「集中」「気が散る」→ 去搜 → 回圖檔網址

5分でセットアップ完了

1. クローンする

git clone https://github.com/scatjay/kxmind-irasutoya-mcp.git

2. 依存パッケージをインストール

pip install -r requirements.txt

3. Claude に接続

Claude Desktop の設定ファイル claude_desktop_config.json に以下を追加：

{
  "mcpServers": {
    "irasutoya": {
      "command": "python",
      "args": ["C:/你的路徑/kxmind-irasutoya-mcp/server.py"]
    }
  }
}

C:/あなたのパス/ は、先ほどクローンした実際の場所に置き換えてください。

4. Claude を再起動

アカウント登録も、キー申請も、環境変数の設定も不要です。 これだけで動きます。

この図庫の規模

実測（2026-08-27）：

いつでも library_stats で最新の数字を自分で確認できます。

9つのツール

検索層

分析層

この層こそが、MCP と「自分でブラウザを開いて検索する」ことの本当の違いです。

出力層

保健指導資料を1部作る完全な流れ

1. worksheet_template("我的衛教單.html")
      → A4 骨架，列印與手機的坑都填好了

2. search("讀字會跳行")  或  suggest_for_worksheet("…")
      → 拿到圖檔網址，貼進 HTML 的 <img src>
        （這一步刻意用真實網址，檔案才是人看得懂、改得動的）

3. inline_images("我的衛教單.html")
      → 把圖就地換成內嵌，檔案變成自包含

4. 發布成 Artifact
      → 有公開網址可以傳給家長，家長按 Ctrl+P 就能印

なぜステップ2と3を分けるのか

Artifact には厳格な CSP があり、すべての外部ホストの画像をブロックします（唯一の例外は Google Fonts）。 いらすとや の画像は blogger.googleusercontent.com にあるため、直接読み込むことは絶対にできません。

では、最初から埋め込めばいいのでは？ なぜなら、400px の画像1枚を base64 に変換すると約 148 KB になり、 3枚なら 445 KB —— その文字列が会話を通過すると、大量のトークンを消費し、しかも中身はまったく読めません。

そこで：作成中は URL を使い（可読性）、最後のステップでのみ埋め込む（自己完結型）。 その数十万文字はファイル内にのみ存在し、最初から最後まで会話には入りません。

レイアウトで処理済みのこと

worksheet_template が生成する骨組みでは、これらの落とし穴はすべて埋めてあります（3種類の幅で実測済み）：

さらに：印刷時は自動で白背景に変換（濃色背景はトナーを消費し、保護者も読みにくい）、 フッターのリンクは URL も一緒に印刷されます（紙媒体を受け取っても、どこから来たのか分かるように）。

suggest_for_worksheet はこのツールの中核です。自分でキーワードを分解する必要はなく、状況をそのまま伝えるだけ：

小学3年生の子で、文字を読むと行を飛ばす、連絡帳を写し終えられない、保護者がとても不安に思っている

すると自動で「子ども／学習障害／連絡帳／不安／保護者」という複数の系統に分解し、 各系統に1枚ずつ割り当てて、レイアウトで使える組み合わせにまとめます——同じ概念を5枚詰め込むのではありません。

⚠️ あなたが説明するのは状況であって、個人事例ではありません。 氏名も、カルテも、特定可能な情報もありません——これは元々匿名化されているので、 追加のコンプライアンス対応は不要です。

🔴 ライセンス：この部分は必ず最後までお読みください

いらすとや の規定原文：

商用目的の場合、一つの作成物の中に 20点まで は無料でご利用いただけます。 それ以上の点数をご希望される場合は 有償 となります。

【中国語訳】 商業用途の場合、同一作品内では最大 20点 まで無料で利用可能。 超える場合は有料となり、1点につき 1,100円（税込）。

もう一つ、同じく重要な規定：

素材そのものの販売・再配布は禁止。

【中国語訳】 素材そのものの販売・再配布は禁止。

あなたにとっての実際の意味

「作品への埋め込み」と「再配布」は別の話

この区別は重要です。なぜなら inline_images は確かに画像をダウンロードするからです：

inline_images が行うのは前者——あなたが画像を Word に貼り付けるのと同じことで、 HTML の書き方に置き換えただけです。

このプログラムがそのために施した設計

• 検索系ツールは URL のみを返し、何もダウンロードしない

• inline_images はあなたが明示的に指示したときだけダウンロードし、しかもあなた自身の HTML ファイル内に既に存在する画像のみを処理する

• デフォルト上限は 20点。これはライセンスの無料上限とちょうど一致——技術的な制限ではなく、意図的にここで止めている

• リポジトリ自体には素材ファイルを一切同梱しない

• 検索・埋め込みの結果には、毎回残り枠のリマインダーが最後に付く

⚠️ 診療所が無料配布する保健指導資料が「商用」に当たるかは、グレーゾーンです。 作者は弁護士ではありません。 実務上の安全ライン：1枚なら問題なし、シリーズものは要注意。 本当に大量に使う場合は、直接 いらすとや 公式に問い合わせてください。

公式説明：https://www.irasutoya.com/p/terms.html

技術メモ

いらすとや は Blogger で構築されており、標準の feed API があるため、HTML をスクレイピングする必要はありません：

GET https://www.irasutoya.com/feeds/posts/default?alt=json&q=<日文關鍵字>&max-results=N

返ってくる各エントリには：

• title.$t — タイトル（日本語）

• link[rel=alternate].href — ページURL

• content.$t — 画像ファイルの <img src> を含む

• category[].term — タグ

robots.txt は空（0 bytes）で、クロール制限は一切ありません。 それでも、このツールでは 0.8秒のリクエスト間隔、直列・非並列 を入れています—— 無料リソースなので、サーバーを落とさないようにしましょう。

中日対照表

現在 167 の中国語語彙を収録。対象範囲：

感情（細分化版含む）/ 子どもと発達 / 学校 / 家族 / 心理と支援 / 医療 / 介護と高齢 / 生活と3C / レイアウト装飾 / 支援者自身の状況 / 臨床的課題 / 介入と技法

うち 65 語は 実際に API を叩いて検証済み——候補語をすべて実際に検索してみて、 ヒットしないものは除外しました。「選択性緘黙」もこの方法で除外されました：概念は存在するが、図庫に対応する素材がないのです。

思いがけない収穫：沙盤→箱庭、桌遊→ボードゲーム、繪本→絵本、 藝術治療→お絵かき、代幣→シール、耗竭→燃え尽き症候群。

1つの中国語語彙が複数の日本語語彙に対応するのは、日本語では同じ概念に 漢字・仮名・外来語 の3つの表記があることが多く、1つだけ打つと素材の大半を取りこぼすからです。

"注意力": ["集中", "気が散る"],
"諮商":   ["カウンセリング", "相談"],
"放鬆":   ["リラックス", "深呼吸", "瞑想"],

語彙が足りないと思ったら、server.py 内の ZH_TO_JA を直接編集すればいいのです——これはあなたが編集するためのものです。

ライセンス

コード：MIT（LICENSE 参照） イラスト素材：著作権は いらすとや に帰属。本プロジェクトは素材を所有・配布せず、 使用時は上記のライセンス規定を遵守してください。