いらすとや MCP

Ayuda a profesionales de la ayuda a buscar imágenes en la biblioteca gratuita de ilustraciones japonesa «いらすとや», para hacer folletos de educación sanitaria, fichas de aprendizaje y presentaciones.

Los folletos de educación sanitaria de hospitales y clínicas de Taiwán usan mucho esta biblioteca. El problema es que solo acepta palabras clave en japonés — si quieres buscar una ilustración de «falta de atención», en el sitio tienes que escribir 集中 o 気が散る, y no vas a saber qué escribir.

El valor de este MCP no está en conectarte a internet, sino en ayudarte a cruzar esa barrera del idioma.

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

Instalación en cinco minutos

1. Clónalo

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

2. Instala las dependencias

pip install -r requirements.txt

3. Conéctalo a Claude

En el archivo de configuración claude_desktop_config.json de Claude Desktop, añade:

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

Cambia C:/你的路徑/ por la ubicación real donde acabas de clonar el repositorio.

4. Reinicia Claude

No hay que registrarse, no hay que solicitar claves, no hay que configurar variables de entorno. Así de simple.

¿Qué tamaño tiene esta biblioteca?

Medición real (2026-08-27):

Puedes consultar las cifras más recientes en cualquier momento con library_stats.

Nueve herramientas

Capa de búsqueda

Capa de análisis

Esta capa es la verdadera diferencia entre el MCP y «abrir el navegador y buscar por tu cuenta».

Capa de generación

Flujo completo para hacer un folleto de educación sanitaria

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

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

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

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

Por qué separar los pasos 2 y 3

Artifact tiene una CSP estricta que bloquea todas las imágenes de hosts externos (la única excepción es Google Fonts). Las imágenes de いらすとや están en blogger.googleusercontent.com, así que conectarse directamente no las cargará.

¿Y por qué no incrustar desde el principio? Porque una imagen de 400px convertida a base64 ocupa unos 148 KB, y tres serían 445 KB — si esos caracteres pasan por la conversación, consumirían una gran cantidad de crédito, y además no podrías leerlos.

Por eso: al escribir se usan las URL (legibles), y solo en el último paso se incrusta (autocontenido). Esos cientos de miles de caracteres solo existen en el archivo y nunca entran en la conversación.

Lo que el diseño ya tiene resuelto

El esqueleto que genera worksheet_template ya tiene resueltos estos problemas (probado con tres anchos):

Además: al imprimir se convierte automáticamente a fondo blanco (el fondo oscuro gasta tóner y los padres tampoco lo verían bien), y los enlaces del pie de página imprimen también la URL (para que quien reciba el papel sepa a dónde ir).

suggest_for_worksheet es el núcleo de esta herramienta. No tienes que desglosar las palabras clave tú mismo; describe la situación directamente:

Un niño de tercero de primaria que se salta líneas al leer, no termina de copiar la agenda, y los padres están muy angustiados

Él mismo desglosa las líneas «infancia / dificultades de aprendizaje / agenda / ansiedad / padres», y asigna una imagen a cada línea, formando una combinación que aprovecha el diseño — en lugar de meter cinco imágenes del mismo concepto.

⚠️ Lo que describes es una situación, no un caso clínico. No hay nombres, ni historiales médicos, ni información identificable — ya está desidentificado por naturaleza, no requiere ninguna acción adicional de cumplimiento.

🔴 Licencia: lee esta sección completa

Texto original de las condiciones de いらすとや:

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

【Chino tradicional】 Para uso comercial, se pueden usar gratis hasta 20 imágenes en una misma obra; por encima de eso hay que pagar, 1 100 yenes por imagen (impuestos incluidos).

Hay otra condición igual de importante:

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

【Chino tradicional】 Los materiales en sí no se pueden vender ni redistribuir.

Qué significa esto en la práctica

«Incrustar en una obra» y «redistribuir» son dos cosas distintas

Esta distinción es importante porque inline_images sí descarga imágenes:

inline_images hace lo primero — es lo mismo que pegar la imagen en Word, solo que con la sintaxis de HTML.

El diseño de este programa para ello

• Las herramientas de búsqueda solo devuelven URL, no descargan nada

• inline_images solo descarga cuando lo pides explícitamente, y solo procesa las imágenes que ya aparecen en tu propio archivo HTML

• Límite predeterminado de 20 imágenes, justo el límite gratuito de la licencia — no es una limitación técnica, es una barrera deliberada

• El repo no incluye ningún archivo de materiales

• Cada resultado de búsqueda e incrustación incluye al final un recordatorio del saldo restante

⚠️ Si un folleto de educación sanitaria que una clínica distribuye gratis cuenta como «uso comercial» es una zona gris. El autor no es abogado. La línea segura en la práctica: una sola hoja no es problema; una serie completa requiere atención. Si de verdad necesitas usarlo a gran escala, contacta directamente con いらすとや.

Explicación oficial: https://www.irasutoya.com/p/terms.html

Notas técnicas

いらすとや está montado sobre Blogger y tiene la API de feed estándar, no hace falta hacer scraping del HTML:

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

Cada resultado devuelto incluye:

• title.$t — título (en japonés)

• link[rel=alternate].href — URL de la página

• content.$t — contiene el <img src> del archivo de imagen

• category[].term — etiquetas

robots.txt está vacío (0 bytes), sin ninguna restricción de rastreo. Aun así, esta herramienta añade un intervalo de 0,8 segundos entre peticiones, en serie y sin concurrencia — es un recurso gratuito, no lo tumbes.

Tabla de correspondencia chino-japonés

Actualmente incluye 167 términos en chino, que abarcan:

Emociones (incluida la versión detallada) / infancia y desarrollo / escuela / familia / psicología y ayuda / medicina / cuidados de larga duración y personas mayores / vida cotidiana y 3C / decoración de maquetación / la propia situación del profesional de la ayuda / cuestiones clínicas / intervenciones y técnicas

De ellos, 65 términos están verificados probando la API de verdad — todos los candidatos se buscan realmente una vez, y los que no aparecen se descartan directamente. «Mutismo selectivo» se descartó así: el concepto existe, pero no hay material correspondiente en la biblioteca.

Hallazgos inesperados: 沙盤→箱庭, 桌遊→ボードゲーム, 繪本→絵本, 藝術治療→お絵かき, 代幣→シール, 耗竭→燃え尽き症候群.

Un término chino puede corresponder a varios términos japoneses, porque en japonés el mismo concepto suele tener tres formas de escribirse: kanji, kana y palabras de origen extranjero; si solo escribes una, te pierdes gran parte del material.

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

Si crees que falta algún término, basta con editar ZH_TO_JA en server.py — está ahí para que lo modifiques.

Licencia

Código: MIT (ver LICENSE) Material de ilustraciones: los derechos de autor pertenecen a いらすとや; este proyecto no posee ni distribuye ningún material. Al usarlo, respeta las condiciones de licencia indicadas arriba.