orange 🍊 (vibecoded by clod)

Fetches the top stories from Hacker News and saves them as bookmarks in Karakeep, tagged #hackernews. Most everything done by Clod.

Requirements

• bash
• curl
• jq

Setup

cp .env.example .env
# Edit .env with your Karakeep URL and API token

Get your API token from Karakeep: Settings → API Keys.

Usage

# Import top 100 stories (default)
./orange.sh

# Import top 25 stories
./orange.sh -n 25

What it does

1. Fetches the top N story IDs from the HN Firebase API
2. For each story, creates a bookmark in Karakeep with the title and URL
3. Tags each bookmark with hackernews
4. Sleeps 2 seconds between requests to be polite to the HN API