> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 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.
```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
graph LR
subgraph "Jina Search"
User[User] --> Agent[Agent]
Agent --> Tool[invoke_jina_search]
Tool --> API[Jina Search API]
API --> Result[Results]
end
classDef input fill:#8B0000,stroke:#7C90A0,color:#fff
classDef process fill:#189AB4,stroke:#7C90A0,color:#fff
classDef output fill:#10B981,stroke:#7C90A0,color:#fff
class User,Agent input
class Tool,API process
class Result output
```
## Overview
The JinaSearch tool is a tool that allows you to search the web using the JinaSearch API.
```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
pip install langchain-community
```
```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
export JINA_API_KEY="${JINA_API_KEY:?Set JINA_API_KEY in your shell}"
```
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
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](https://jina.ai/api-dashboard/key-manager)
## How It Works
```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
sequenceDiagram
participant User
participant Agent
participant Jina as invoke_jina_search
participant API as Jina Search API
User->>Agent: "Search for X"
Agent->>Jina: invoke_jina_search(query)
Jina->>API: HTTPS request
API-->>Jina: results
Jina-->>Agent: parsed result
Agent-->>User: final answer
```
## Getting Started
1. Install dependencies (see **Overview** above)
2. Set required API keys in your environment
3. Run the agent example in **Overview**
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.
## Related Tools
Jina tools
AI-powered search
Neural search