What do you want to do?
3 use cases
-
Turn any URL into LLM-ready markdown
Prefix a URL with r.jina.ai to get clean markdown, with front matter or JSON when your pipeline needs structure.
View prompt
Using jina-ai/reader, fetch each URL in <my list> through r.jina.ai with the X-Respond-With frontmatter header and save the markdown files for my RAG index.
-
Search the web and read the top results
Call s.jina.ai with a query to get the top 5 results already fetched and converted, optionally limited to certain sites.
View prompt
With jina-ai/reader, query s.jina.ai for <my research question> limited to <two sites>, and summarize the results with their source URLs.
-
Self-host Reader with Docker
Run the open source image locally so internal or high volume conversions do not go through the hosted service.
- REPO
jina-ai/reader - Claude Code
- Codex
- Cursor
- Gemini CLI
- Research
- Intermediate
View prompt
Using jina-ai/reader, run the oss Docker image on port 3000, convert <an internal URL> to markdown with curl, and tell me how to stop the container.
- REPO
Quick start with Reader
- Check you have what it needs: curl or any HTTP client for the hosted r.jina.ai and s.jina.ai endpoints; Docker to self-host with `docker pull ghcr.io/jina-ai/reader:oss`; An optional Jina API key for higher rate limits on the hosted service.
- Open jina-ai/reader on GitHub and read the README and license.
- Prepend https://r.jina.ai/ to the page URL and fetch it with curl
- For YAML front matter run
curl -H 'X-Respond-With: frontmatter' 'https://r.jina.ai/https://example.com' - For JSON output run
curl -H "Accept: application/json" https://r.jina.ai/https://en.m.wikipedia.org/wiki/Main_Page - Add x-max-tokens to cap the size or x-retain-images none to drop images
These steps come from our top use case, Turn any URL into LLM-ready markdown, which also has a copy-paste agent prompt.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for jina-ai/reader
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forDevelopers building RAG, research agents or summarizers who need clean text from web pages.
- Why it is hot12k stars, talked about in 2 AI sources we track
- Sourcegithub.com/jina-ai/reader ยท Back to Hot repos
Requirements
- curl or any HTTP client for the hosted r.jina.ai and s.jina.ai endpoints
- Docker to self-host with `docker pull ghcr.io/jina-ai/reader:oss`
- An optional Jina API key for higher rate limits on the hosted service
Add this badge to your README
Maintain Reader? Show readers where to find these use cases.
Markdown
[](https://dedupedai.com/use-cases/jina-ai-reader/?utm_source=github&utm_medium=badge&utm_campaign=jina-ai-reader)
HTML
<a href="https://dedupedai.com/use-cases/jina-ai-reader/?utm_source=github&utm_medium=badge&utm_campaign=jina-ai-reader"><img src="https://dedupedai.com/badge/jina-ai/reader.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about Reader
What is Reader?
Reader converts any URL into LLM-friendly markdown by prepending https://r.jina.ai/, and searches the web with https://s.jina.ai/, fetching the top results as markdown. It handles PDFs, Office documents and JavaScript heavy pages, has request headers for output format, waiting and token limits, and this repo is the open source branch you can self-host with Docker. It is an open-source project on GitHub: https://github.com/jina-ai/reader.
How do I use Reader?
Prepend https://r.jina.ai/ to the page URL and fetch it with curl; then For YAML front matter run curl -H 'X-Respond-With: frontmatter' 'https://r.jina.ai/https://example.com'; For JSON output run curl -H "Accept: application/json" https://r.jina.ai/https://en.m.wikipedia.org/wiki/Main_Page. The use cases on this page give the full steps and a copy-paste agent prompt for each job.
Who is Reader for?
Developers building RAG, research agents or summarizers who need clean text from web pages.
What can I do with Reader?
3 use cases so far, for example: Turn any URL into LLM-ready markdown; Search the web and read the top results; Self-host Reader with Docker. Each has steps and a copy-paste agent prompt.
What do I need to run Reader?
curl or any HTTP client for the hosted r.jina.ai and s.jina.ai endpoints; Docker to self-host with `docker pull ghcr.io/jina-ai/reader:oss`; An optional Jina API key for higher rate limits on the hosted service.
What are alternatives to Reader?
Other hot AI repos in Research: Deep Tutor, Local Deep Research, Project Nomad, Nanochat, We Knora.
Is Reader safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.