You're Invited:Meet the Socket Team at BlackHat and DEF CON in Las Vegas, Aug 4-6.RSVP
Socket
Book a DemoInstallSign in
Socket

jinafetch

Package Overview
Dependencies
Maintainers
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

jinafetch

CLI tool to fetch and save web content as Markdown files using Jina Reader API. Handles authentication and provides rich terminal output.

0.3.1
pipPyPI
Maintainers
1

JinaFetch

License: MIT Python 3.12+

A CLI tool to fetch web content and save it as Markdown using the Jina Reader API (get API key).

Features

  • 🚀 Fast web content conversion to Markdown
  • 🔑 Secure API key management via .env
  • 🎨 Rich terminal output with success/error formatting
  • 📂 Automatic filename generation with fallback

Installation

pipx install jinafetch  # Recommended
# or
pip install jinafetch

Usage

Configure API Key

jinafetch configure  # Update stored API key
jinafetch show-config  # See where credentials are stored

Basic fetching

jinafetch fetch https://example.com

Specify output file

jinafetch fetch https://example.com --output my_document.md

Pipe output to other commands

jinafetch fetch https://example.com --stdout | pbcopy  # Example: pipe to clipboard

Environment Configuration

The CLI will guide you through first-time setup:

  • Run any command (e.g. jinafetch fetch https://example.com)
  • You'll be prompted to enter your Jina API key
  • Your key will be securely stored in:
    • Linux: ~/.config/jinafetch/config.ini
    • macOS: ~/Library/Application Support/jinafetch/config.ini
    • Windows: C:\Users\<user>\AppData\Local\jinafetch\config.ini

For CI/CD use cases, you can still set via environment variable:

export JINA_API_KEY=your_key_here
# or
JINA_API_KEY=your_key_here jinafetch fetch...

Error Handling

The CLI returns these exit codes:

  • 0: Success
  • 1: General error (network issues, invalid API key)
  • 2: File system error (permission issues, path problems)

Common error scenarios include:

  • 🔒 Missing API key
  • 🌐 Network errors
  • 💾 File write permissions
  • 🔗 Invalid URLs

Errors display clear messages in red with details.

Troubleshooting

🔧 Where's my API key actually stored? Run jinafetch show-config to see the config file location

🌐 Network errors Check your internet connection and firewall settings for HTTPS access

🔑 Invalid API key errors Update your key with jinafetch configure or via environment variable

Requirements

  • Python 3.12+
  • Valid Jina Reader API key

📝 Note: Requires valid authentication via Jina Reader API

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

FAQs

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts