LinkAce to Karakeep Import Tool

This tool imports bookmarks from a LinkAce CSV export to Karakeep.

Setup

1. Install dependencies:

   bun install
   

2. Copy .env.example to .env and configure your Karakeep instance:

   cp .env.example .env
   

3. Edit .env and add your Karakeep API URL and API key:

   KARAKEEP_API=https://your-karakeep-instance.app
   KARAKEEP_API_KEY=your_api_key_here
   

4. Place your LinkAce_export.csv file in the project directory.

Usage

Run the import script:

bun run import

Or run directly:

bun run import-to-karakeep.ts

The script will:

• Read all bookmarks from LinkAce_export.csv
• Import each bookmark to Karakeep via the API
• Wait 1 second between each request to avoid overloading the server
• Display progress and summary statistics

Notes

• The script converts LinkAce fields to Karakeep fields:
  • url → url
  • title → title
  • description → note
  • created_at → createdAt
  • tags → parsed from comma-separated string
• Failed imports are logged with error details
• The script sets source: "api" for all imported bookmarks