JinaAI Reader

Extrae contenido web utilizando la API de Jina.ai Reader.

Documentación

mcp-jinaai-reader


⚠️ Aviso

Este repositorio ya no se mantiene.

La funcionalidad de esta herramienta ahora está disponible en mcp-omnisearch, que combina múltiples herramientas MCP en un solo paquete unificado.

Por favor, use mcp-omnisearch en su lugar.


Un servidor de Model Context Protocol (MCP) para integrar la API Reader de Jina.ai con LLMs. Este servidor proporciona capacidades eficientes y completas de extracción de contenido web, optimizadas para documentación y análisis de contenido web.

Características

  • 📚 Extracción avanzada de contenido web a través de la API Reader de Jina.ai
  • 🚀 Recuperación de contenido rápida y eficiente
  • 📄 Extracción completa de texto con estructura preservada
  • 🔄 Formato limpio optimizado para LLMs
  • 🌐 Soporte para varios tipos de contenido, incluida documentación
  • 🏗️ Construido sobre el Model Context Protocol

Configuración

Este servidor requiere configuración a través de su cliente MCP. Aquí hay ejemplos para diferentes entornos:

Configuración de Cline

Agregue esto a la configuración de MCP de Cline:

{
	"mcpServers": {
		"jinaai-reader": {
			"command": "node",
			"args": ["-y", "mcp-jinaai-reader"],
			"env": {
				"JINAAI_API_KEY": "your-jinaai-api-key"
			}
		}
	}
}

Configuración de Claude Desktop con WSL

Para entornos WSL, agregue esto a la configuración de Claude Desktop:

{
	"mcpServers": {
		"jinaai-reader": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"JINAAI_API_KEY=your-jinaai-api-key npx mcp-jinaai-reader"
			]
		}
	}
}

Variables de entorno

El servidor requiere la siguiente variable de entorno:

  • JINAAI_API_KEY: Su clave de API de Jina.ai (requerida)

API

El servidor implementa una única herramienta MCP con parámetros configurables:

read_url

Convierta cualquier URL a texto amigable para LLMs usando Jina.ai Reader.

Parámetros:

  • url (cadena, requerido): URL a procesar
  • no_cache (booleano, opcional): Omitir caché para resultados frescos. El valor predeterminado es falso
  • format (cadena, opcional): Formato de respuesta ("json" o "stream"). El valor predeterminado es "json"
  • timeout (número, opcional): Tiempo máximo en segundos para esperar la carga de la página web
  • target_selector (cadena, opcional): Selector CSS para enfocarse en elementos específicos
  • wait_for_selector (cadena, opcional): Selector CSS para esperar elementos específicos
  • remove_selector (cadena, opcional): Selector CSS para excluir elementos específicos
  • with_links_summary (booleano, opcional): Recopilar todos los enlaces al final de la respuesta
  • with_images_summary (booleano, opcional): Recopilar todas las imágenes al final de la respuesta
  • with_generated_alt (booleano, opcional): Agregar texto alternativo a imágenes que carecen de subtítulos
  • with_iframe (booleano, opcional): Incluir contenido de iframes en la respuesta

Desarrollo

Configuración

  1. Clone el repositorio
  2. Instale las dependencias:
npm install
  1. Compile el proyecto:
npm run build
  1. Ejecute en modo de desarrollo:
npm run dev

Publicación

  1. Actualice la versión en package.json
  2. Compile el proyecto:
npm run build
  1. Publique en npm:
npm publish

Contribuciones

¡Las contribuciones son bienvenidas! No dude en enviar un Pull Request.

Licencia

Licencia MIT: consulte el archivo LICENSE para más detalles.

Agradecimientos