# Send Jina AI - Web Reader, Search and Deep Search to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "jina-ai",
    "name": "Jina AI - Web Reader, Search and Deep Search",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/adhishthite/jina-ai",
    "canonicalUrl": "https://clawhub.ai/adhishthite/jina-ai",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/jina-ai",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=jina-ai",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/jina-reader.sh",
      "scripts/jina-deepsearch.sh",
      "scripts/jina-search.sh",
      "scripts/jina-reader.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "jina-ai",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T13:35:40.204Z",
      "expiresAt": "2026-05-11T13:35:40.204Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=jina-ai",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=jina-ai",
        "contentDisposition": "attachment; filename=\"jina-ai-1.0.6.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "jina-ai"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/jina-ai"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/jina-ai",
    "downloadUrl": "https://openagent3.xyz/downloads/jina-ai",
    "agentUrl": "https://openagent3.xyz/skills/jina-ai/agent",
    "manifestUrl": "https://openagent3.xyz/skills/jina-ai/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/jina-ai/agent.md"
  }
}
```
## Documentation

### Jina AI — Reader, Search & DeepSearch

Web reading and search powered by Jina AI. Requires JINA_API_KEY environment variable.

Trust & Privacy: By using this skill, URLs and queries are transmitted to Jina AI (jina.ai). Only install if you trust Jina with your data.

Model Invocation: This skill may be invoked autonomously by the model without explicit user trigger (standard for integration skills). If you prefer manual-only invocation, disable model invocation in your OpenClaw skill settings.

Get your API key: https://jina.ai/ → Dashboard → API Keys

### External Endpoints

This skill makes HTTP requests to the following external endpoints only:

EndpointURL PatternPurposeReader APIhttps://r.jina.ai/{url}Sends URL content request to Jina for conversion to markdownSearch APIhttps://s.jina.ai/{query}Sends search query to Jina for web search resultsDeepSearch APIhttps://deepsearch.jina.ai/v1/chat/completionsSends research question to Jina for multi-step research

No other external network calls are made by this skill.

### Security & Privacy

Authentication: Only your JINA_API_KEY is transmitted to Jina's servers (via Authorization header)
Data sent: URLs and search queries you provide are sent to Jina's servers for processing
Local files: No local files are read or transmitted by this skill
Local storage: No data is stored locally beyond stdout output
Environment access: Scripts only access the JINA_API_KEY environment variable; no other env vars are read
Cookies: Cookies are not forwarded by default; the X-Set-Cookie header is available for authenticated content but is opt-in only

### Endpoints

EndpointBase URLPurposeReaderhttps://r.jina.ai/{url}Convert any URL → clean markdownSearchhttps://s.jina.ai/{query}Web search with LLM-friendly resultsDeepSearchhttps://deepsearch.jina.ai/v1/chat/completionsMulti-step research agent

All endpoints accept Authorization: Bearer $JINA_API_KEY.

### Reader API (r.jina.ai)

Fetches any URL and returns clean, LLM-friendly content. Works with web pages, PDFs, and JS-heavy sites.

### Basic Usage

# Plain text output
curl -s "https://r.jina.ai/https://example.com" \\
  -H "Authorization: Bearer $JINA_API_KEY" \\
  -H "Accept: text/plain"

# JSON output (includes url, title, content, timestamp)
curl -s "https://r.jina.ai/https://example.com" \\
  -H "Authorization: Bearer $JINA_API_KEY" \\
  -H "Accept: application/json"

Or use the helper script: scripts/jina-reader.sh <url> [--json]

### Parameters (via headers or query params)

Content Control

HeaderQuery ParamValuesDefaultDescriptionX-Respond-WithrespondWithcontent, markdown, html, text, screenshot, pageshot, vlm, readerlm-v2contentOutput formatX-Retain-ImagesretainImagesnone, all, alt, all_p, alt_pallImage handlingX-Retain-LinksretainLinksnone, all, text, gpt-ossallLink handlingX-With-Generated-AltwithGeneratedAlttrue/falsefalseAuto-caption imagesX-With-Links-SummarywithLinksSummarytrue-Append links sectionX-With-Images-SummarywithImagesSummarytrue/falsefalseAppend images sectionX-Token-BudgettokenBudgetnumber-Max tokens for response

CSS Selectors

HeaderQuery ParamDescriptionX-Target-SelectortargetSelectorOnly extract matching elementsX-Wait-For-SelectorwaitForSelectorWait for elements before extractingX-Remove-SelectorremoveSelectorRemove elements before extraction

Browser & Network

HeaderQuery ParamDescriptionX-TimeouttimeoutPage load timeout (1-180s)X-Respond-TimingrespondTimingWhen page is "ready" (html, network-idle, etc.)X-No-CachenoCacheBypass cached contentX-ProxyproxyCountry code or auto for proxyX-Set-CookiesetCookiesForward cookies for authenticated content

### Common Patterns

# Extract main content, remove navigation elements
curl -s "https://r.jina.ai/https://example.com/article" \\
  -H "Authorization: Bearer $JINA_API_KEY" \\
  -H "X-Retain-Images: none" \\
  -H "X-Remove-Selector: nav, footer, .sidebar, .ads" \\
  -H "Accept: text/plain"

# Extract specific section
curl -s "https://r.jina.ai/https://example.com" \\
  -H "Authorization: Bearer $JINA_API_KEY" \\
  -H "X-Target-Selector: article.main-content"

# Parse a PDF
curl -s "https://r.jina.ai/https://example.com/paper.pdf" \\
  -H "Authorization: Bearer $JINA_API_KEY" \\
  -H "Accept: text/plain"

# Wait for dynamic content
curl -s "https://r.jina.ai/https://spa-app.com" \\
  -H "Authorization: Bearer $JINA_API_KEY" \\
  -H "X-Wait-For-Selector: .loaded-content" \\
  -H "X-Respond-Timing: network-idle"

### Search API (s.jina.ai)

Web search returning LLM-friendly results with full page content.

### Basic Usage

# Plain text
curl -s "https://s.jina.ai/your+search+query" \\
  -H "Authorization: Bearer $JINA_API_KEY" \\
  -H "Accept: text/plain"

# JSON
curl -s "https://s.jina.ai/your+search+query" \\
  -H "Authorization: Bearer $JINA_API_KEY" \\
  -H "Accept: application/json"

Or use the helper script: scripts/jina-search.sh "<query>" [--json]

### Search Parameters

ParamValuesDescriptionsitedomainLimit to specific sitetypeweb, images, newsSearch typenum / count0-20Number of resultsglcountry codeGeo-location (e.g. us, in)filetypeextensionFilter by file typeintitlestringMust appear in title

All Reader parameters also work on search results.

### Common Patterns

# Site-scoped search
curl -s "https://s.jina.ai/OpenAI+GPT-5?site=reddit.com" \\
  -H "Authorization: Bearer $JINA_API_KEY" \\
  -H "Accept: text/plain"

# News search
curl -s "https://s.jina.ai/latest+AI+news?type=news&num=5" \\
  -H "Authorization: Bearer $JINA_API_KEY" \\
  -H "Accept: application/json"

# Search for PDFs
curl -s "https://s.jina.ai/machine+learning+survey?filetype=pdf&num=5" \\
  -H "Authorization: Bearer $JINA_API_KEY"

### DeepSearch

Multi-step research agent that combines search + reading + reasoning. OpenAI-compatible chat completions API.

curl -s "https://deepsearch.jina.ai/v1/chat/completions" \\
  -H "Authorization: Bearer $JINA_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "model": "jina-deepsearch-v1",
    "messages": [{"role": "user", "content": "Your research question here"}],
    "stream": false
  }'

Or use the helper script: scripts/jina-deepsearch.sh "<question>"

Use for complex research requiring multiple sources and reasoning chains.

### Helper Scripts

ScriptPurposescripts/jina-reader.shRead any URL as markdownscripts/jina-search.shWeb searchscripts/jina-deepsearch.shDeep multi-step researchscripts/jina-reader.pyPython reader (no deps beyond stdlib)

### Rate Limits

Free (no key): 20 RPM
With API key: Higher limits, token-based pricing

### API Docs

Reader: https://jina.ai/reader
Search: https://s.jina.ai/docs
OpenAPI specs: https://r.jina.ai/openapi.json | https://s.jina.ai/openapi.json

### When to Use

NeedUseFetch a URL as markdownReader — better than web_fetch for JS-heavy sitesWeb searchSearch — LLM-friendly resultsComplex multi-source researchDeepSearchParse a PDF from URLReader — pass PDF URL directlyScreenshot a pageReader with X-Respond-With: screenshotExtract structured dataReader with jsonSchema param
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: adhishthite
- Version: 1.0.6
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-04T13:35:40.204Z
- Expires at: 2026-05-11T13:35:40.204Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/jina-ai)
- [Send to Agent page](https://openagent3.xyz/skills/jina-ai/agent)
- [JSON manifest](https://openagent3.xyz/skills/jina-ai/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/jina-ai/agent.md)
- [Download page](https://openagent3.xyz/downloads/jina-ai)