jina-cli

Q: How do I install jina-cli?

Run npx skills add https://github.com/geekjourneyx/jina-cli --skill jina-cli in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/jina-cli/ (personal) or .claude/skills/jina-cli/ (project).

by geekjourneyxMarketing & SEO

Reads web content and searches the web using Jina AI Reader API. Use when extracting content from URLs, reading social media posts (X/Twitter), or web searching for current information.

Installs: 255
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/geekjourneyx/jina-cli --skill jina-cli

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads jina-cli automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

jina - Web Content Reader & Search

CLI tool for reading web content and performing AI-powered web searches.

Quick start

Install:

curl -fsSL https://raw.githubusercontent.com/geekjourneyx/jina-cli/main/scripts/install.sh | bash

Basic usage:

# Read a URL
jina read --url "https://example.com"

# Search the web
jina search --query "golang latest news"

Commands

Command	Purpose
`read`	Extract and convert content from URLs to LLM-friendly format
`search`	Search the web with AI-powered result processing
`config`	Manage settings (set/get/list/path)

Read command

Extract content from any URL:

# Basic read
jina read --url "https://example.com"

# Read with image captioning
jina read -u "https://x.com/user/status/123" --with-alt

# Batch process from file
jina read --file urls.txt

# Output as Markdown
jina read -u "https://example.com" --output markdown

# Save to file
jina read -u "https://example.com" --output-file result.md

Response formats

The API can return content in different formats via --format:

markdown - Default, LLM-friendly Markdown
html - Raw HTML
text - Plain text
screenshot - URL to a screenshot

Advanced options

# Bypass cache
jina read -u "https://example.com" --no-cache

# Use proxy
jina read -u "https://example.com" --proxy "http://proxy.com:8080"

# CSS selector extraction
jina read -u "https://example.com" --target-selector "article.main"

# Wait for element to load
jina read -u "https://example.com" --wait-for-selector "#content"

# Forward cookies
jina read -u "https://example.com" --cookie "session=abc123"

# POST method for SPA with hash routing
jina read -u "https://example.com/#/route" --post

Search command

Search the web with automatic content fetching from top results:

# Basic search
jina search --query "golang latest news"

# Restrict to specific sites
jina search -q "AI developments" --site techcrunch.com --site theverge.com

# Limit results
jina search -q "climate change" --limit 10

# Output format
jina search -q "news" --output markdown

Site filtering

Use multiple --site flags to restrict search to specific domains:

jina search -q "startup funding" --site techcrunch.com --site theverge.com --site wired.com

Configuration

Config file: ~/.jina-reader/config.yaml

Priority: Command args > Environment vars > Config file > Defaults

Environment variables:

JINA_API_BASE_URL - Read API URL (default: https://r.jina.ai/)
JINA_SEARCH_API_URL - Search API URL (default: https://s.jina.ai/)
JINA_TIMEOUT - Request timeout in seconds (default: 30)
JINA_WITH_GENERATED_ALT - Enable image captioning (default: false)
JINA_OUTPUT_FORMAT - Output format: json/markdown (default: json)
JINA_PROXY_URL - Proxy server URL

Config commands:

# Set configuration
jina config set timeout 60
jina config set with-generated-alt true

# View configuration
jina config list
jina config get timeout
jina config path

Output formats

JSON format (default, machine-readable):

{
  "success": true,
  "data": {
    "url": "https://example.com",
    "content": "# Extracted Content\n\n...",
    "title": "Page Title"
  }
}

Markdown format (human-readable):

jina read -u "https://example.com" --output markdown

Common use cases

Reading social media posts

# X (Twitter) posts
jina read -u "https://x.com/elonmusk/status/123456" --with-alt

# The --with-alt flag enables VLM image captioning for embedded images

Reading articles/blogs

# Standard article
jina read -u "https://blog.example.com/article"

# With specific format
jina read -u "https://example.com" --format text --output markdown

Research workflows

# 1. Search for topic
jina search -q "quantum computing 2025" --limit 10

# 2. Read specific results
jina read --file search_results.txt

Batch processing

Create a file with one URL per line:

cat > urls.txt << EOF
https://example.com/page1
https://example.com/page2
https://x.com/user/status/123
EOF

jina read --file urls.txt --output markdown

Project structure

cli/
├── main.go              # Root command
├── read.go              # read command
├── search.go            # search command
├── config.go            # config command
└── pkg/
    ├── api/client.go    # Jina API HTTP client
    ├── config/          # Config file management
    └── output/          # JSON/Markdown formatter

Implementation notes

Go 1.24+ required
Zero dependencies except Cobra
Single binary distribution
Config stored as simple key=value format (no YAML library dependency)

For API details: See cli/pkg/api/client.go

FAQ

What does the jina-cli skill do?

Reads web content and searches the web using Jina AI Reader API. Use when extracting content from URLs, reading social media posts (X/Twitter), or web searching for current information.

How do I install jina-cli?

Run npx skills add https://github.com/geekjourneyx/jina-cli --skill jina-cli in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/jina-cli/ (personal) or .claude/skills/jina-cli/ (project).

Which AI agents can use jina-cli?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is jina-cli safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains jina-cli?

It is published by geekjourneyx in geekjourneyx/jina-cli. It has 255 recorded installs.

Popular marketing & seo skills

View category →

reddit-automation

flowkit-labs/skills

Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.

Marketing & SEO1.1M installs

twitter-automation

101-skills/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO880K installs

twitter-automation

magentosh/superpowers

Marketing & SEO771.7K installs

twitter-automation

qu-skills/superpowers

Marketing & SEO564.3K installs

product-launch-video

heygen-com/hyperframes

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

Marketing & SEO538.7K installs

twitter-automation

skills-shell/superpowers

Marketing & SEO453.7K installs

jina-cli

Install

Install

Describe the task

Review the result

SKILL.md

jina - Web Content Reader & Search

Quick start

Commands

Read command

Response formats

Advanced options

Search command

Site filtering

Configuration

Output formats

Common use cases

Reading social media posts

Reading articles/blogs

Research workflows

Batch processing

Project structure

Implementation notes

FAQ

Popular marketing & seo skills

reddit-automation

twitter-automation

twitter-automation

twitter-automation

product-launch-video

twitter-automation