JinaSearch Tool

Guide for using the JinaSearch tool with PraisonAI agents.

The JinaSearch tool lets an agent search the web through the Jina Search API.

Overview

The JinaSearch tool is a tool that allows you to search the web using the JinaSearch API.

pip install langchain-community

export JINA_API_KEY="${JINA_API_KEY:?Set JINA_API_KEY in your shell}"

from praisonaiagents import Agent, AgentTeam
from langchain_community.tools import JinaSearch
import os 

def invoke_jina_search(query: str):
    JinaSearchTool = JinaSearch()
    model_generated_tool_call = {
        "args": {"query": query},
        "id": "1",
        "name": JinaSearchTool.name,
        "type": "tool_call",
    }
    tool_msg = JinaSearchTool.invoke(model_generated_tool_call)
    return(tool_msg.content[:1000])

data_agent = Agent(instructions="Find 10 websites where I can learn coding for free", tools=[invoke_jina_search])
editor_agent = Agent(instructions="write a listicle blog ranking the best websites. The blog should contain a proper intro and conclusion")
agents = AgentTeam(agents=[data_agent, editor_agent], process='hierarchical')
agents.start()

Register on Jina Generate your JinaSearch API key from Jina Platform

How It Works

Getting Started

1. Simple Usage

   1. Install dependencies (see Overview above)
   2. Set required API keys in your environment
   3. Run the agent example in Overview
2. With Configuration

   Use the same tool with an agent — see the Overview example, or pass env vars from the sections above.

Best Practices

Keep JINA_API_KEY in the environment

Set JINA_API_KEY in your shell or .env. JinaSearch reads it automatically — never hard-code the key.

Trim the returned content

The example slices results with tool_msg.content[:1000]. Cap the length you feed back to the agent so it stays within context limits.

Handle rate limits

Jina returns HTTP 429 under heavy use. Wrap JinaSearchTool.invoke(...) in try/except so the agent can fall back to another search tool.

Related Tools

Jina

Jina tools

Tavily

AI-powered search

Exa

Neural search