jina-cli
by geekjourneyx
A lightweight CLI tool wrapping Jina AI Reader API for AI Agents. Fetch and parse any URL into LLM-friendly formats (Markdown/Text/HTML). Perfect for reading X(Twitter), blogs, and news sites.
304stars
29forks
Go
Added 3/2/2026
Installation
# Add to your Claude Code skills
git clone https://github.com/geekjourneyx/jina-cliGetting Started
Guides for using ai agents skills like jina-cli.
- Caveman: Cut Claude Token Use by 65%How agent-side prompt compression works, when to use it, and when not to.
- What is an AI Skills Marketplace?Definitions, how marketplaces work, and how to choose between them in 2026.
- Getting Started with AI SkillsFirst-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
Security ReportVerified
Last scanned: 5/30/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-30T15:05:57.199Z",
"npmAuditRan": true,
"pipAuditRan": true
}jina
为 AI Agent 打造的网页阅读 CLI 工具
中文
简介
jina 是一个轻量级的命令行工具，封装了 Jina AI Reader API，可以将任意 URL 转换为 LLM 友好的输入格式。特别适合阅读 X (Twitter)、博客、新闻网站等复杂网页。
核心功能：
- read - 读取 URL 内容，输出 Markdown/Text/HTML 格式
- search - 网络搜索，自动获取并处理搜索结果
安装指南
jina 有三种独立的安装方式，根据你的使用场景选择：
方式一：OpenClaw Skill（推荐本地 AI 助理）
什么是 OpenClaw？
OpenClaw 是一个本地 AI 助理（可以理解为"有终端权限的 Claude"），运行在你的机器上。它通过 Skills 插件扩展能力，支持 9000+ 个技能插件。
适用场景：本地 AI 助理、自动化工作流、文件系统操作
安装方式 - 直接复制 skill 文件：
# 创建 jina-cli skill 目录并下载
mkdir -p ~/.openclaw/workspace/skills/jina-cli
curl -o ~/.openclaw/workspace/skills/jina-cli/SKILL.md \
https://raw.githubusercontent.com/geekjourneyx/jina-cli/main/skills/jina-cli/SKILL.md
验证安装：
# 启动 OpenClaw
openclaw
# 在 OpenClaw 中直接使用 jina 命令
# skill 会自动从 ~/.openclaw/workspace/skills/jina-cli/ 加载
你将获得：
- ✅ 本地 AI 助理直接调用
jina read和jina search - ✅ 无需安装 CLI 二进制
- ✅ 可以处理本地文件、执行脚本等
方式二：Claude Code Skill（推荐用于 AI 辅助开发）
适用场景：在 Claude Code 中使用 AI 协助你处理网页内容
安装步骤：
# 1. 确保已安装 Node.js 和 Claude Code
node --version
# v18.0.0 或更高版本
# 2. 安装 jina skill
npx skills add https://github.com/geekjourneyx/jina-cli --skill jina-cli
安装后验证：
# 在 Claude Code 中可以直接使用
# 无需额外操作，skill 会自动加载
你将获得：
- ✅ 在 Claude Code 中直接调用
jina read和jina search命令 - ✅ AI 会自动理解 jina 的功能和使用方式
- ✅ 无需手动安装 CLI 二进制文件
方式三：CLI 二进制文件（推荐用于终端使用）
适用场景：在终端/脚本中使用，或与其他工具集成
一键安装（Linux/macOS）
curl -fsSL https://raw.githubusercontent.com/geekjourneyx/jina-cli/main/scripts/install.sh | bash
安装脚本会自动：
- 检测你的系统架构（Linux/macOS，amd64/arm64）
- 下载对应平台的二进制文件
- 安装到
~/.local/bin/jina或~/bin/jina - 提示如何添加到 PATH（如需要）
验证安装
# 检查是否安装成功
jina --version
# 预期输出: jina version 1.0.0 (构建时间: ..., 提交: ...)
# 测试基本功能
jina read --url "https://example.com"
手动安装
如果自动安装失败，可以手动下载：
# 1. 下载对应平台的二进制
# Linux amd64:
wget https://github.com/geekjourneyx/jina-cli/releases/latest/download/jina-linux-amd64 -O jina
chmod +x jina
sudo mv jina /usr/local/bin/
# macOS ARM64 (Apple Silicon):
wget https://github.com/geekjourneyx/jina-cli/releases/latest/download/jina-darwin-arm64 -O jina
chmod +x jina
sudo mv jina /usr/local/bin/
# 2. 验证安装
jina --version
从源码构建
git clone https://github.com/geekjourneyx/jina-cli.git
cd jina-cli
go build -o jina ./cli
sudo mv jina /usr/local/bin/
三种安装方式对比
| 特性 | OpenClaw Skill | Claude Code Skill | CLI 二进制 |
|---|---|---|---|
| 安装位置 | ~/.openclaw/workspace/skills/jina-cli/ |
~/.claude/skills/ |
~/.local/bin/jina |
| 使用环境 | OpenClaw 本地 AI 助理 | Claude Code | 任何终端/脚本 |
| AI 集成 | AI 自动理解功能 | AI 自动理解功能 | 需要手动调用 |
| 文件权限 | ✅ 可访问本地文件系统 | ❌ 受限 | ✅ 完整权限 |
| 脚本执行 | ✅ 可执行脚本 | ❌ 受限 | ✅ 完整权限 |
| 更新方式 | 重新下载/npx skills update |
npx skills update |
重新运行安装脚本 |
| 适用场景 | 本地 AI 助理、自动化 | AI 辅助开发 | 脚本集成、日常使用 |
推荐选择：
- OpenClaw → 最强能力，本地运行，可操作文件系统
- Claude Code → 开发体验好，AI 辅助编码
- CLI 二进制 → 最轻量，适合脚本集成
注意：三种方式完全独立，可以同时安装，互不干扰。
快速开始
读取网页内容
# 读取单个 URL
jina read --url "https://example.com"
# 读取 X (Twitter) 帖子
jina read -u "https://x.com/user/status/123456789" --with-alt
# 输出 Markdown 格式
jina read -u "https://example.com" --output markdown
# 保存到文件
jina read -u "https://example.com" --output-file result.md
批量处理
# 从文件读取 URL 列表
cat > urls.txt << EOF
https://example.com/page1
https://example.com/page2
https://x.com/user/status/123
EOF
jina read --file urls.txt
网络搜索
# 搜索关键词
jina search --query "golang latest news"
# 限定搜索站点
jina search -q "AI developments" --site techcrunch.com --site theverge.com
# 限制结果数量
jina search -q "climate change" --limit 10
配置管理
配置文件位于 ~/.jina-reader/config.yaml：
# 查看所有配置
jina config list
# 设置配置项
jina config set timeout 60
jina config set with-generated-alt true
# 获取单个配置
jina config get timeout
# 查看配置文件路径
jina config path
配置项说明
| 配置项 | 环境变量 | 默认值 | 说明 |
|---|---|---|---|
api_base_url |
JINA_API_BASE_URL |
https://r.jina.ai/ |
Read API 地址 |
search_api_url |
JINA_SEARCH_API_URL |
https://s.jina.ai/ |
Search API 地址 |
default_response_format |
JINA_RESPONSE_FORMAT |
markdown |
响应格式 |
default_output_format |
JINA_OUTPUT_FORMAT |
json |
输出格式 |
timeout |
JINA_TIMEOUT |
30 |
请求超时（秒） |
with_generated_alt |
JINA_WITH_GENERATED_ALT |
false |
启用图片描述 |
proxy_url |
JINA_PROXY_URL |
"" |
代理服务器 |
api_key |
JINA_API_KEY |
"" |
API 密钥（用于更高速率限制） |
优先级： 命令行参数 > 环境变量 > 配置文件 > 默认值
API Key 使用
添加 API Key 可以获得更高的速率限制：
# 方式 1：配置文件设置
jina config set api_key jina_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# 方式 2：环境变量
export JINA_API_KEY=jina_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# 方式 3：命令行参数
jina read -u "https://example.com" -k jina_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
获取 API Key：访问 Jina AI Reader 注册并获取。
输出格式
JSON 格式（默认）
{
"success": true,
"data": {
"url": "https://example.com",
"title": "Example Domain",
"content": "# Example Domain\n\nThis domain is..."
}
}
Markdown 格式
jina read -u "https://example.com" --output markdown
输出：
# Example Domain
**Source**: https://example.com
---
# Example Domain
This domain is for use in illustrative examples...
高级用法
禁用缓存
jina read -u "https://example.com" --no-cache
使用代理
jina read -u "https://example.com" --proxy "http://proxy.com:8080"
CSS 选择器提取
# 只提取指定元素
jina read -u "https://example.com" --target-selector "article.main"
# 等待元素加载
jina read -u "https://example.com" --wait-for-selector "#content"
处理 SPA 应用
# 对于带 hash 路由的 SPA，使用 POST 方法
jina read -u "https://example.com/#/route" --post
设置 Cookie
jina read -u "https://example.com" --cookie "session=abc123"
与 AI Agent 集成
# 在 Claude Code 或其他 AI 工具中使用
jina read -u "https://x.com/elonmusk/status/123456" --output json
# 搜索最新信息
jina search -q "golang 1.24 release notes" --output json
命令参考
jina - CLI tool for Jina AI Reader and Search APIs
Usage:
jina [command]
Available Commands:
read Extract and convert content from URLs
search Search the web with AI-powered results
config Manage configuration
completion Generate shell completion
help Help about any command
Flags:
-a, --api-base string API base URL (overrides config)
-k, --api-key string API key (overrides config)
-o, --output string Output format: json, markdown (default "json")
-v, --verbose Verbose output
-h, --help help for jina
--version version for jina
开发
# 运行测试
go test ./...
# 运行测试并计算覆盖率
go test -cover ./...
# 构建
go build -o jina ./cli
# 交叉编译
GOOS=linux GOARCH=amd64 go build -o jina-linux-amd64 ./cli
GOOS=darwin GOARCH=arm64 go build -o jina-darwin-arm64 ./cli
GOOS=windows GOARCH=amd64 go build -o jina-windows-amd64.exe ./cli
项目结构
jina-cli/
├── cli/
│ ├── main.go # 入口
│ ├── read.go # read 命令
│ ├── search.go # search 命令
│ ├── config.go # config 命令
│ └── pkg/
│ ├── api/ # HTTP 客户端
│ ├── config/ # 配置管理
│ └── output/ # 输出格式化
└── scripts/
└── install.sh # 安装脚本
许可证
致谢
- Jina AI Reader API - 核心 API 服务
- md2wechat-lite - 项目架构参考
💰 打赏
如果该项目帮助了您，欢迎请作者喝杯咖啡 ☕️
微信打赏
🧑💻 作者
- X (Twitter): https://x.com/seekjourney
- 公众号: 极客杰尼
关注公众号，获取更多 AI 编程、AI 工具与 AI 出海建站的实战分享：
English
Overview
jina is a lightweight CLI tool that wraps the Jina AI Reader API to convert any URL into LLM-friendly input. Perfect for reading X (Twitter), blogs, news sites, and other complex web pages.
Features:
- read - Extract content from URLs in Markdown/Text/HTML format
- search - Search the web with AI-powered result processing
Installation Guide
jina offers two independent installation methods. Choose based on your use case:
Method 1: Claude Code Skill (Recommended for AI-Assisted Development)
Use case: Using jina within Claude Code with AI assistance
Installation steps:
# 1. Ensure Node.js and Claude Code are installed
node --version
# v18.0.0 or higher
# 2. Install jina skill
npx skills add https://github.com/geekjourneyx/jina-cli --skill jina-cli
Verify installation:
# You can now use jina commands directly in Claude Code
# No additional steps needed, skill loads automatically
You get:
-
✅ Direct access to
jina readandjina searchcommands in Claude Code -
✅ AI automatically understands jina's functionality
-
✅ No manual CLI binary installation required
Frequently Asked Questions
What is jina-cli?
jina-cli is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by geekjourneyx. A lightweight CLI tool wrapping Jina AI Reader API for AI Agents. Fetch and parse any URL into LLM-friendly formats (Markdown/Text/HTML). Perfect for reading X(Twitter), blogs, and news sites. It has 304 GitHub stars.
Is jina-cli safe to use?
Yes. jina-cli passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
How do I install jina-cli?
Clone the repository with "git clone https://github.com/geekjourneyx/jina-cli" and add it to your Claude Code skills directory (see the Installation section above).
What programming language is jina-cli written in?
jina-cli is primarily written in Go. It is open-source under geekjourneyx on GitHub, so you can review or fork the full source.
Are there alternatives to jina-cli?
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh jina-cli against similar tools.
Comments (0)
to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills
An agentic skills framework & software development methodology that works.
234,966
20,863
Shell
AI Agentsaibrainstorming
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
230,427
35,165
JavaScript
AI Agentsai-agentsanthropic
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
196,740
59,390
TypeScript
MCP Serversaiapis
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
185,940
28,768
JavaScript
AI Agentsai-agentsanthropic
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.
120,031
19,897
Shell
AI Agents