いらすとや MCP

Помогает специалистам помогающих профессий искать картинки в бесплатной японской библиотеке иллюстраций «いらすとや» — для раздаточных материалов по санитарному просвещению, учебных листов, презентаций.

Тайваньские больницы и клиники массово используют эту библиотеку в своих материалах. Проблема в том, что она понимает только японские ключевые слова — хочешь найти иллюстрацию «нарушение концентрации внимания» — на сайте нужно вводить 集中 или 気が散る, а ты не знаешь, что именно вводить.

Ценность этого MCP не в том, что он подключается к сети, а в том, что он помогает перешагнуть языковой барьер.

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

Установка за пять минут

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.

Девять инструментов

Слой поиска

Слой анализа

Именно этот слой и есть настоящее отличие MCP от «открыть браузер и искать самому».

Слой вывода

Полный процесс создания раздаточного листа

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 в base64 — это примерно 148 КБ, а три — уже 445 КБ — если эти символы пройдут через диалог, они сожрут огромный объём квоты, и ты при этом ничего в них не поймёшь.

Поэтому: при написании используем URL (читаемо), и только на последнем шаге встраиваем (самодостаточно). Эти сотни тысяч символов существуют только в файле и ни разу не попадают в диалог.

Что уже решено в вёрстке

В каркасе, который генерирует worksheet_template, все эти грабли уже обойдены (проверено на трёх ширинах):

Ещё: при печати фон автоматически становится белым (тёмный фон съедает тонер, да и родителям плохо видно), а ссылки в подвале печатаются вместе с URL (чтобы по бумажной версии было видно, куда идти).

suggest_for_worksheet — ядро этого инструмента. Не нужно самому разбивать на ключевые слова, просто опиши ситуацию:

Ребёнок в третьем классе, при чтении перескакивает через строки, не успевает переписать домашнее задание из дневника, родители очень тревожатся

Он сам разобьёт на линии «ребёнок / нарушение обучаемости / дневник / тревога / родители», и для каждой линии подберёт по одной картинке, собрав комбинацию, которая реально ложится в вёрстку, — а не пять картинок на одно и то же понятие.

⚠️ Ты описываешь ситуацию, а не клинический случай. Ни имён, ни историй болезни, ни идентифицируемой информации — это уже деидентифицировано по своей сути, никаких дополнительных действий по соответствию нормам не требуется.

🔴 Лицензия: этот раздел, пожалуйста, дочитайте до конца

Оригинальный текст правил いらすとや:

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

【На традиционном китайском】 При коммерческом использовании в одном произведении можно бесплатно использовать до 20 изображений; свыше — платно, 1 100 иен за штуку (с налогом).

Есть ещё одно не менее важное правило:

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

【На традиционном китайском】 Сами материалы продавать и распространять повторно запрещено.

Что это значит для тебя на практике

«Встроить в произведение» и «распространять повторно» — это разные вещи

Это различие важно, потому что inline_images действительно скачивает картинки:

inline_images делает первое — то же самое, что вставить картинку в Word, просто в виде HTML.

Какие решения заложены в программу для этого

• Инструменты поиска возвращают только URL и ничего не скачивают

• inline_images скачивает только тогда, когда ты явно об этом просишь, и обрабатывает только те картинки, которые уже есть в твоём собственном HTML-файле

• Лимит по умолчанию — 20 изображений, ровно столько же, сколько бесплатный лимит лицензии — это не техническое ограничение, а осознанная заглушка

• В самом репозитории нет ни одного файла материалов

• После каждого поиска и встраивания в конце выводится напоминание об остатке лимита

⚠️ Считаются ли раздаточные листы, которые клиника раздаёт бесплатно, «коммерческим использованием», — серая зона. Автор не юрист. Практическая безопасная линия: один лист — без проблем, серия — будь осторожен. При действительно масштабном использовании обращайтесь напрямую в いらすとや.

Официальное описание: 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 байт), никаких ограничений на обход нет. Несмотря на это, в инструмент всё равно заложены интервал между запросами 0,8 секунды, последовательно, без параллелизма — это бесплатный ресурс, не надо класть его на лопатки.

Таблица соответствия китайского и японского

Сейчас собрано 167 китайских слов, охватывающих:

эмоции (включая тонкие оттенки) / дети и развитие / школа / семья / психология и помогающая практика / медицина / долговременный уход и пожилые / быт и 3C / оформительские элементы / ситуации самих помогающих специалистов / клинические темы / интервенции и техники

Из них 65 слов проверены реальными запросами к API — все слова-кандидаты действительно прогонялись через поиск, чего не нашлось — вычёркивалось. Именно так был вычеркнут «селективный мутизм»: понятие существует, но в библиотеке нет соответствующего материала.

Неожиданно ценные находки: 沙盤→箱庭 (песочница→箱庭), 桌遊→ボードゲーム (настольные игры→ボードゲーム), 繪本→絵本 (книжка с картинками→絵本), 藝術治療→お絵かき (арт-терапия→お絵かき), 代幣→シール (жетоны→シール), 耗竭→燃え尽き症候群 (выгорание→燃え尽き症候群).

Одно китайское слово может соответствовать нескольким японским, потому что одно и то же понятие в японском часто имеет три варианта написания: кандзи, кана и заимствование из иностранного языка — если вводить только один вариант, потеряешь добрую половину материалов.

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

Если кажется, что какого-то слова не хватает, просто правь ZH_TO_JA в server.py — он для того и существует.

Лицензия

Код: MIT (см. LICENSE) Иллюстрации: авторские права принадлежат いらすとや, данный проект не владеет и не распространяет никакие материалы, при использовании соблюдайте лицензионные правила выше.