jinafetch 0.3.1

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

JinaFetch

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:

1. Run any command (e.g. jinafetch fetch https://example.com)
2. You'll be prompted to enter your Jina API key
3. 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.