/jina-ai

name: jina-ai
description: Use Jina AI APIs for converting URLs to LLM-friendly Markdown (Reader) and searching the web (Search).

Jina AI Skill

This skill integrates Jina AI's Reader (r.jina.ai) and Search (s.jina.ai) APIs to convert URLs and web search results into clean, LLM-friendly Markdown.

Setup

1. **Dependencies:** Requires `requests`.

    pip install requests python-dotenv

2. **API Key Configuration (Recommended):** Jina APIs offer higher limits with an API key (JINA_API_KEY).

    read -p "Enter your Jina API key (optional, press Enter to skip): " JINA_KEY
    if [ ! -z "$JINA_KEY" ]; then
        echo "JINA_API_KEY=$JINA_KEY" >> .env
        if [ -f .gitignore ] && ! grep -q ".env" .gitignore; then echo ".env" >> .gitignore; fi
        echo "API key saved to .env."
    fi

Usage

The script `scripts/jina_tools.py` supports `read` and `search` operations.

1. Read URL (Jina Reader)

Convert a URL into clean Markdown.

python3 scripts/jina_tools.py read "<url>"

**Example:**

python3 scripts/jina_tools.py read "https://en.wikipedia.org/wiki/Large_language_model"

2. Search Web (Jina Search)

Search the web and return the top results converted to Markdown.

python3 scripts/jina_tools.py search "<query>"

**Example:**

python3 scripts/jina_tools.py search "What is Jina AI?"

Output

The script outputs results in JSON format, containing title, URL, and `content_markdown`.