Jina Reader

SKILL.md

---
name: jina-reader
description: "Web content extraction via Jina AI Reader API. Three modes: read (URL to markdown), search (web search + full content), ground (fact-checking). Extracts clean content without exposing server IP."
homepage: https://jina.ai/reader
metadata: {"clawdbot":{"emoji":"📖","requires":{"bins":["curl","jq"]},"primaryEnv":"JINA_API_KEY"}}
---

# Jina Reader

Extract clean web content via Jina AI — without exposing your server IP.

## Read a URL

```bash
{baseDir}/scripts/reader.sh "https://example.com/article"
```

## Search the web (top 5 results with full content)

```bash
{baseDir}/scripts/reader.sh --mode search "latest AI news 2025"
```

## Fact-check a statement

```bash
{baseDir}/scripts/reader.sh --mode ground "OpenAI was founded in 2015"
```

## Options

| Flag | Description | Default |
|------|-------------|---------|
| `--mode` | `read`, `search`, `ground` | `read` |
| `--selector` | CSS selector to extract specific region | — |
| `--wait` | CSS selector to wait for before extraction | — |
| `--remove` | CSS selectors to remove (comma-separated) | — |
| `--proxy` | Country code for geo-proxy (`br`, `us`, etc.) | — |
| `--nocache` | Force fresh content (skip cache) | off |
| `--format` | `markdown`, `html`, `text`, `screenshot` | `markdown` |
| `--json` | Raw JSON output | off |

## Examples

```bash
# Extract article content
{baseDir}/scripts/reader.sh "https://blog.example.com/post"

# Extract specific section via CSS selector
{baseDir}/scripts/reader.sh --selector "article.main" "https://example.com"

# Remove nav and ads before extraction
{baseDir}/scripts/reader.sh --remove "nav,footer,.ads" "https://example.com"

# Search with JSON output
{baseDir}/scripts/reader.sh --mode search --json "AI enterprise trends"

# Read via Brazil proxy
{baseDir}/scripts/reader.sh --proxy br "https://example.com.br"

# Fact-check a claim
{baseDir}/scripts/reader.sh --mode ground "Tesla is the most valuable car company"
```

## API Key

Resolution order:

1. `$JINA_API_KEY` env var
2. `~/.config/jina/api_key` file (canonical local path)

Either is fine. Pick one:

```bash
# Option A: env var
export JINA_API_KEY="jina_..."

# Option B: config file (preferred for local installs)
mkdir -p ~/.config/jina && echo "jina_..." > ~/.config/jina/api_key
chmod 600 ~/.config/jina/api_key
```

Free tier: 10M tokens (no signup needed). Get key at https://jina.ai/reader/

## Pricing

- **Read:** ~$0.005/page (standard) | 3x for ReaderLM-v2
- **Search:** 10K tokens fixed + variable per result
- **Ground:** ~300K tokens/request (~30s latency)

## Why Jina Reader?

- **IP protection** — requests route through Jina's infra, not your server
- **Clean markdown** — readability extraction + optional ReaderLM-v2
- **Dynamic content** — headless Chrome renders JavaScript
- **Structured extraction** — JSON schema support for data extraction