archibate/dotfiles-opencode / skills/jina-ai
jina-ai
VerifiedUse Jina AI APIs for converting URLs to LLM-friendly Markdown (Reader) and searching the web (Search).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.5 KB |
| __init__.py | script | 0 B |
| requirements.txt | manifest | 23 B |
| scripts/jina_tools.py | script | 2.6 KB |
| tests/__init__.py | script | 0 B |
| tests/test_jina_tools.py | script | 7.6 KB |
SKILL.md
View on GitHub---
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`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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 implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |