Jina Reader & Search Skill

Two APIs, zero API key required (optional key for higher rate limits).

Reader — Fetch a URL as Markdown

Simple (shell):

curl -s "https://r.jina.ai/<URL>"

With script:

python3 skills/jina-reader/scripts/jina_read.py <URL>
python3 skills/jina-reader/scripts/jina_read.py <URL> --no-images   # strip images
python3 skills/jina-reader/scripts/jina_read.py <URL> --json        # structured JSON response

With API key (set in .env):

JINA_API_KEY=your_key python3 skills/jina-reader/scripts/jina_read.py <URL>

Useful request headers (for direct curl): | Header | Purpose | |--------|---------| | Authorization: Bearer <key> | Higher rate limits | | X-Return-Format: markdown | Force markdown output | | X-Remove-Selector: img | Strip images | | Accept: application/json | JSON response with title, url, content |

Search — Web Search via Jina

Simple (shell):

curl -s "https://s.jina.ai/<URL-encoded-query>"

With script:

python3 skills/jina-reader/scripts/jina_search.py "your query"
python3 skills/jina-reader/scripts/jina_search.py "your query" --json
python3 skills/jina-reader/scripts/jina_search.py "your query" --json --results 3

API Key

| API | Without Key | With Key | |-----|-------------|----------| | Reader (r.jina.ai) | ✅ Works (rate-limited) | Higher limits | | Search (s.jina.ai) | ❌ Requires key | ✅ Works |

Store as JINA_API_KEY in .env. Get a free key at: https://jina.ai/api-dashboard

No key for search? Use the duckduckgo-search skill as a fallback.

Notes

• Reader works on most pages including JS-heavy sites
• Search returns up to 5 results by default, each with title, URL, and content summary
• For very long pages, use --no-images to reduce token usage