jina-ai

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

⭐2stars🔀0forks📁View on GitHub🕐Updated Nov 26, 2025⬇️1downloads

When & Why to Use This Skill

This Jina AI skill empowers Claude agents to perform real-time web searches and convert complex URLs into clean, LLM-friendly Markdown. By leveraging Jina AI's Reader and Search APIs, it bridges the gap between static AI knowledge and the dynamic web, ensuring high-quality data extraction for accurate research, summarization, and analysis.

Use Cases

  • Real-time Information Retrieval: Search the live web to provide Claude with the latest news, technical documentation, and up-to-date facts beyond its training data.
  • Web Content Ingestion: Convert long-form articles, blog posts, or Wikipedia pages into structured Markdown for efficient summarization and key insight extraction.
  • Competitive Intelligence: Automatically fetch and format data from competitor websites to perform market analysis and track industry trends.
  • RAG Pipeline Support: Extract clean, noise-free text from online resources to feed into Retrieval-Augmented Generation systems for enhanced context.
namejina-ai
descriptionUse 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"

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.