Overview
Jina Reader API converts any URL into clean, LLM-ready text. It handles JavaScript rendering, removes ads, and extracts the main content.Installation
Environment Variables
How It Works
Quick Start
Usage with Agent
Available Methods
read(url)
Read and extract content from a URL.search(query)
Search the web and get content.Configuration Options
Function-Based Usage
CLI Usage
Error Handling
Common Errors
| Error | Cause | Solution |
|---|---|---|
Connection error | Network issue | Check internet connection |
Timeout | Page took too long | Increase timeout or try later |
Rate limited | Too many requests | Add API key or add delays |
Features
- JavaScript rendering - Handles dynamic content
- Ad removal - Extracts only main content
- Clean output - LLM-ready text format
- No API key required - Works with limits
Best Practices
Add JINA_API_KEY for higher limits
Add JINA_API_KEY for higher limits
Jina Reader works without a key at low rate limits. Set
JINA_API_KEY in your shell or .env for production throughput.Trim long pages
Trim long pages
Reader output can be large. Cap or summarise the returned
content before feeding it back so the agent stays within its context window.Handle timeouts and rate limits
Handle timeouts and rate limits
JinaTool(timeout=30) sets a request timeout. Check for an error key in the result and retry or fall back to another reader when Jina rate-limits.Related Tools
Firecrawl
Web scraping API
Crawl4AI
Open-source crawler
Trafilatura
Content extraction

