Skip to main content
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

Set JINA_API_KEY in your shell or .env. JinaSearch reads it automatically — never hard-code the key.
The example slices results with tool_msg.content[:1000]. Cap the length you feed back to the agent so it stays within context limits.
Jina returns HTTP 429 under heavy use. Wrap JinaSearchTool.invoke(...) in try/except so the agent can fall back to another search tool.

Jina

Jina tools

Tavily

AI-powered search

Exa

Neural search