JinaAI Search

Busca web eficiente otimizada para conteúdo amigável a LLMs usando a API Jina AI.

Documentação

mcp-jinaai-search

⚠️ Aviso

Este repositório não é mais mantido.

A funcionalidade desta ferramenta agora está disponível em mcp-omnisearch, que combina múltiplas ferramentas MCP em um pacote unificado.

Por favor, use mcp-omnisearch em vez disso.

Um servidor Model Context Protocol (MCP) para integrar a API de busca da Jina.ai com LLMs. Este servidor fornece capacidades de busca web eficientes e abrangentes, otimizadas para recuperar conteúdo limpo e amigável para LLMs da web.

Recursos

🔍 Busca web avançada através da API de busca da Jina.ai
🚀 Recuperação de conteúdo rápida e eficiente
📄 Extração de texto limpa com estrutura preservada
🧠 Conteúdo otimizado para LLMs
🌐 Suporte para vários tipos de conteúdo, incluindo documentação
🏗️ Construído no Model Context Protocol
🔄 Cache configurável para desempenho
🖼️ Coleta opcional de imagens e links
🌍 Suporte a localização através do idioma do navegador
🎯 Controle de orçamento de tokens para tamanho da resposta

Configuração

Este servidor requer configuração através do seu cliente MCP. Aqui estão exemplos para diferentes ambientes:

Configuração do Cline

Adicione isto às configurações MCP do seu Cline:

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

Configuração do Claude Desktop com WSL

Para ambientes WSL, adicione isto à configuração do seu Claude Desktop:

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

Variáveis de Ambiente

O servidor requer a seguinte variável de ambiente:

JINAAI_API_KEY: Sua chave de API da Jina.ai (obrigatória)

API

O servidor implementa uma única ferramenta MCP com parâmetros configuráveis:

search

Busque na web e obtenha conteúdo limpo e amigável para LLMs usando o Jina.ai Reader. Retorna os 5 principais resultados com URLs e conteúdo limpo.

Parâmetros:

query (string, obrigatório): Consulta de busca
format (string, opcional): Formato de resposta ("json" ou "text"). Padrão: "text"
no_cache (booleano, opcional): Ignorar cache para resultados atualizados. Padrão: false
token_budget (número, opcional): Número máximo de tokens para esta solicitação
browser_locale (string, opcional): Idioma do navegador para renderização de conteúdo
stream (booleano, opcional): Ativar modo de streaming para páginas grandes. Padrão: false
gather_links (booleano, opcional): Coletar todos os links no final da resposta. Padrão: false
gather_images (booleano, opcional): Coletar todas as imagens no final da resposta. Padrão: false
image_caption (booleano, opcional): Adicionar legendas às imagens no conteúdo. Padrão: false
enable_iframe (booleano, opcional): Extrair conteúdo de iframes. Padrão: false
enable_shadow_dom (booleano, opcional): Extrair conteúdo do shadow DOM. Padrão: false
resolve_redirects (booleano, opcional): Seguir cadeias de redirecionamento até a URL final. Padrão: true

Desenvolvimento

Configuração

Clone o repositório
Instale as dependências:

pnpm install

Compile o projeto:

pnpm run build

Execute em modo de desenvolvimento:

pnpm run dev

Publicação

Crie um changeset:

pnpm changeset

Versione o pacote:

pnpm version

Compile e publique:

pnpm release

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

Licença MIT - consulte o arquivo LICENSE para detalhes.

Agradecimentos

Construído no Model Context Protocol
Desenvolvido com a API de busca da Jina.ai