{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/jina-ai",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=jina-ai",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/jina-reader.sh",
      "scripts/jina-deepsearch.sh",
      "scripts/jina-search.sh",
      "scripts/jina-reader.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/jina-ai",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Jina AI — Reader, Search & DeepSearch",
        "body": "Web reading and search powered by Jina AI. Requires JINA_API_KEY environment variable.\n\nTrust & Privacy: By using this skill, URLs and queries are transmitted to Jina AI (jina.ai). Only install if you trust Jina with your data.\n\nModel 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.\n\nGet your API key: https://jina.ai/ → Dashboard → API Keys"
      },
      {
        "title": "External Endpoints",
        "body": "This skill makes HTTP requests to the following external endpoints only:\n\nEndpointURL 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\n\nNo other external network calls are made by this skill."
      },
      {
        "title": "Security & Privacy",
        "body": "Authentication: Only your JINA_API_KEY is transmitted to Jina's servers (via Authorization header)\nData sent: URLs and search queries you provide are sent to Jina's servers for processing\nLocal files: No local files are read or transmitted by this skill\nLocal storage: No data is stored locally beyond stdout output\nEnvironment access: Scripts only access the JINA_API_KEY environment variable; no other env vars are read\nCookies: Cookies are not forwarded by default; the X-Set-Cookie header is available for authenticated content but is opt-in only"
      },
      {
        "title": "Endpoints",
        "body": "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\n\nAll endpoints accept Authorization: Bearer $JINA_API_KEY."
      },
      {
        "title": "Reader API (r.jina.ai)",
        "body": "Fetches any URL and returns clean, LLM-friendly content. Works with web pages, PDFs, and JS-heavy sites."
      },
      {
        "title": "Basic Usage",
        "body": "# Plain text output\ncurl -s \"https://r.jina.ai/https://example.com\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"Accept: text/plain\"\n\n# JSON output (includes url, title, content, timestamp)\ncurl -s \"https://r.jina.ai/https://example.com\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"Accept: application/json\"\n\nOr use the helper script: scripts/jina-reader.sh <url> [--json]"
      },
      {
        "title": "Parameters (via headers or query params)",
        "body": "Content Control\n\nHeaderQuery 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\n\nCSS Selectors\n\nHeaderQuery ParamDescriptionX-Target-SelectortargetSelectorOnly extract matching elementsX-Wait-For-SelectorwaitForSelectorWait for elements before extractingX-Remove-SelectorremoveSelectorRemove elements before extraction\n\nBrowser & Network\n\nHeaderQuery 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"
      },
      {
        "title": "Common Patterns",
        "body": "# Extract main content, remove navigation elements\ncurl -s \"https://r.jina.ai/https://example.com/article\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"X-Retain-Images: none\" \\\n  -H \"X-Remove-Selector: nav, footer, .sidebar, .ads\" \\\n  -H \"Accept: text/plain\"\n\n# Extract specific section\ncurl -s \"https://r.jina.ai/https://example.com\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"X-Target-Selector: article.main-content\"\n\n# Parse a PDF\ncurl -s \"https://r.jina.ai/https://example.com/paper.pdf\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"Accept: text/plain\"\n\n# Wait for dynamic content\ncurl -s \"https://r.jina.ai/https://spa-app.com\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"X-Wait-For-Selector: .loaded-content\" \\\n  -H \"X-Respond-Timing: network-idle\""
      },
      {
        "title": "Search API (s.jina.ai)",
        "body": "Web search returning LLM-friendly results with full page content."
      },
      {
        "title": "Basic Usage",
        "body": "# Plain text\ncurl -s \"https://s.jina.ai/your+search+query\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"Accept: text/plain\"\n\n# JSON\ncurl -s \"https://s.jina.ai/your+search+query\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"Accept: application/json\"\n\nOr use the helper script: scripts/jina-search.sh \"<query>\" [--json]"
      },
      {
        "title": "Search Parameters",
        "body": "ParamValuesDescriptionsitedomainLimit to specific sitetypeweb, images, newsSearch typenum / count0-20Number of resultsglcountry codeGeo-location (e.g. us, in)filetypeextensionFilter by file typeintitlestringMust appear in title\n\nAll Reader parameters also work on search results."
      },
      {
        "title": "Common Patterns",
        "body": "# Site-scoped search\ncurl -s \"https://s.jina.ai/OpenAI+GPT-5?site=reddit.com\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"Accept: text/plain\"\n\n# News search\ncurl -s \"https://s.jina.ai/latest+AI+news?type=news&num=5\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"Accept: application/json\"\n\n# Search for PDFs\ncurl -s \"https://s.jina.ai/machine+learning+survey?filetype=pdf&num=5\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\""
      },
      {
        "title": "DeepSearch",
        "body": "Multi-step research agent that combines search + reading + reasoning. OpenAI-compatible chat completions API.\n\ncurl -s \"https://deepsearch.jina.ai/v1/chat/completions\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"model\": \"jina-deepsearch-v1\",\n    \"messages\": [{\"role\": \"user\", \"content\": \"Your research question here\"}],\n    \"stream\": false\n  }'\n\nOr use the helper script: scripts/jina-deepsearch.sh \"<question>\"\n\nUse for complex research requiring multiple sources and reasoning chains."
      },
      {
        "title": "Helper Scripts",
        "body": "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)"
      },
      {
        "title": "Rate Limits",
        "body": "Free (no key): 20 RPM\nWith API key: Higher limits, token-based pricing"
      },
      {
        "title": "API Docs",
        "body": "Reader: https://jina.ai/reader\nSearch: https://s.jina.ai/docs\nOpenAPI specs: https://r.jina.ai/openapi.json | https://s.jina.ai/openapi.json"
      },
      {
        "title": "When to Use",
        "body": "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"
      }
    ],
    "body": "Jina AI — Reader, Search & DeepSearch\n\nWeb reading and search powered by Jina AI. Requires JINA_API_KEY environment variable.\n\nTrust & Privacy: By using this skill, URLs and queries are transmitted to Jina AI (jina.ai). Only install if you trust Jina with your data.\n\nModel 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.\n\nGet your API key: https://jina.ai/ → Dashboard → API Keys\n\nExternal Endpoints\n\nThis skill makes HTTP requests to the following external endpoints only:\n\nEndpoint\tURL Pattern\tPurpose\nReader API\thttps://r.jina.ai/{url}\tSends URL content request to Jina for conversion to markdown\nSearch API\thttps://s.jina.ai/{query}\tSends search query to Jina for web search results\nDeepSearch API\thttps://deepsearch.jina.ai/v1/chat/completions\tSends research question to Jina for multi-step research\n\nNo other external network calls are made by this skill.\n\nSecurity & Privacy\nAuthentication: Only your JINA_API_KEY is transmitted to Jina's servers (via Authorization header)\nData sent: URLs and search queries you provide are sent to Jina's servers for processing\nLocal files: No local files are read or transmitted by this skill\nLocal storage: No data is stored locally beyond stdout output\nEnvironment access: Scripts only access the JINA_API_KEY environment variable; no other env vars are read\nCookies: Cookies are not forwarded by default; the X-Set-Cookie header is available for authenticated content but is opt-in only\nEndpoints\nEndpoint\tBase URL\tPurpose\nReader\thttps://r.jina.ai/{url}\tConvert any URL → clean markdown\nSearch\thttps://s.jina.ai/{query}\tWeb search with LLM-friendly results\nDeepSearch\thttps://deepsearch.jina.ai/v1/chat/completions\tMulti-step research agent\n\nAll endpoints accept Authorization: Bearer $JINA_API_KEY.\n\nReader API (r.jina.ai)\n\nFetches any URL and returns clean, LLM-friendly content. Works with web pages, PDFs, and JS-heavy sites.\n\nBasic Usage\n# Plain text output\ncurl -s \"https://r.jina.ai/https://example.com\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"Accept: text/plain\"\n\n# JSON output (includes url, title, content, timestamp)\ncurl -s \"https://r.jina.ai/https://example.com\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"Accept: application/json\"\n\n\nOr use the helper script: scripts/jina-reader.sh <url> [--json]\n\nParameters (via headers or query params)\nContent Control\nHeader\tQuery Param\tValues\tDefault\tDescription\nX-Respond-With\trespondWith\tcontent, markdown, html, text, screenshot, pageshot, vlm, readerlm-v2\tcontent\tOutput format\nX-Retain-Images\tretainImages\tnone, all, alt, all_p, alt_p\tall\tImage handling\nX-Retain-Links\tretainLinks\tnone, all, text, gpt-oss\tall\tLink handling\nX-With-Generated-Alt\twithGeneratedAlt\ttrue/false\tfalse\tAuto-caption images\nX-With-Links-Summary\twithLinksSummary\ttrue\t-\tAppend links section\nX-With-Images-Summary\twithImagesSummary\ttrue/false\tfalse\tAppend images section\nX-Token-Budget\ttokenBudget\tnumber\t-\tMax tokens for response\nCSS Selectors\nHeader\tQuery Param\tDescription\nX-Target-Selector\ttargetSelector\tOnly extract matching elements\nX-Wait-For-Selector\twaitForSelector\tWait for elements before extracting\nX-Remove-Selector\tremoveSelector\tRemove elements before extraction\nBrowser & Network\nHeader\tQuery Param\tDescription\nX-Timeout\ttimeout\tPage load timeout (1-180s)\nX-Respond-Timing\trespondTiming\tWhen page is \"ready\" (html, network-idle, etc.)\nX-No-Cache\tnoCache\tBypass cached content\nX-Proxy\tproxy\tCountry code or auto for proxy\nX-Set-Cookie\tsetCookies\tForward cookies for authenticated content\nCommon Patterns\n# Extract main content, remove navigation elements\ncurl -s \"https://r.jina.ai/https://example.com/article\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"X-Retain-Images: none\" \\\n  -H \"X-Remove-Selector: nav, footer, .sidebar, .ads\" \\\n  -H \"Accept: text/plain\"\n\n# Extract specific section\ncurl -s \"https://r.jina.ai/https://example.com\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"X-Target-Selector: article.main-content\"\n\n# Parse a PDF\ncurl -s \"https://r.jina.ai/https://example.com/paper.pdf\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"Accept: text/plain\"\n\n# Wait for dynamic content\ncurl -s \"https://r.jina.ai/https://spa-app.com\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"X-Wait-For-Selector: .loaded-content\" \\\n  -H \"X-Respond-Timing: network-idle\"\n\nSearch API (s.jina.ai)\n\nWeb search returning LLM-friendly results with full page content.\n\nBasic Usage\n# Plain text\ncurl -s \"https://s.jina.ai/your+search+query\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"Accept: text/plain\"\n\n# JSON\ncurl -s \"https://s.jina.ai/your+search+query\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"Accept: application/json\"\n\n\nOr use the helper script: scripts/jina-search.sh \"<query>\" [--json]\n\nSearch Parameters\nParam\tValues\tDescription\nsite\tdomain\tLimit to specific site\ntype\tweb, images, news\tSearch type\nnum / count\t0-20\tNumber of results\ngl\tcountry code\tGeo-location (e.g. us, in)\nfiletype\textension\tFilter by file type\nintitle\tstring\tMust appear in title\n\nAll Reader parameters also work on search results.\n\nCommon Patterns\n# Site-scoped search\ncurl -s \"https://s.jina.ai/OpenAI+GPT-5?site=reddit.com\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"Accept: text/plain\"\n\n# News search\ncurl -s \"https://s.jina.ai/latest+AI+news?type=news&num=5\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"Accept: application/json\"\n\n# Search for PDFs\ncurl -s \"https://s.jina.ai/machine+learning+survey?filetype=pdf&num=5\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\"\n\nDeepSearch\n\nMulti-step research agent that combines search + reading + reasoning. OpenAI-compatible chat completions API.\n\ncurl -s \"https://deepsearch.jina.ai/v1/chat/completions\" \\\n  -H \"Authorization: Bearer $JINA_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"model\": \"jina-deepsearch-v1\",\n    \"messages\": [{\"role\": \"user\", \"content\": \"Your research question here\"}],\n    \"stream\": false\n  }'\n\n\nOr use the helper script: scripts/jina-deepsearch.sh \"<question>\"\n\nUse for complex research requiring multiple sources and reasoning chains.\n\nHelper Scripts\nScript\tPurpose\nscripts/jina-reader.sh\tRead any URL as markdown\nscripts/jina-search.sh\tWeb search\nscripts/jina-deepsearch.sh\tDeep multi-step research\nscripts/jina-reader.py\tPython reader (no deps beyond stdlib)\nRate Limits\nFree (no key): 20 RPM\nWith API key: Higher limits, token-based pricing\nAPI Docs\nReader: https://jina.ai/reader\nSearch: https://s.jina.ai/docs\nOpenAPI specs: https://r.jina.ai/openapi.json | https://s.jina.ai/openapi.json\nWhen to Use\nNeed\tUse\nFetch a URL as markdown\tReader — better than web_fetch for JS-heavy sites\nWeb search\tSearch — LLM-friendly results\nComplex multi-source research\tDeepSearch\nParse a PDF from URL\tReader — pass PDF URL directly\nScreenshot a page\tReader with X-Respond-With: screenshot\nExtract structured data\tReader with jsonSchema param"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/adhishthite/jina-ai",
    "publisherUrl": "https://clawhub.ai/adhishthite/jina-ai",
    "owner": "adhishthite",
    "version": "1.0.6",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}