Skip to content

archibate/dotfiles-opencode / skills/jina-ai

jina-ai

Verified

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

FileKindSize
SKILL.mdskill md1.5 KB
__init__.pyscript0 B
requirements.txtmanifest23 B
scripts/jina_tools.pyscript2.6 KB
tests/__init__.pyscript0 B
tests/test_jina_tools.pyscript7.6 KB
---
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`.

    ```bash
    pip install requests python-dotenv
    ```

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

    ```bash
    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.

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

**Example:**

```bash
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.

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

**Example:**

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

## Output

The script outputs results in JSON format, containing title, URL, and `content_markdown`.
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall