Save and Search Bookmarks from Raycast

Three commands: save a bookmark with tags, search your bookmarks, and quick-save from clipboard.

Setup

You need your API token. In the web app sidebar, click the key icon, then Generate Token and Copy.

The extension is not in the Raycast Store yet. Install it locally:

1. Clone the repo, navigate to apps/extension
2. Run npm install && npm run dev
3. Open Raycast, search for Save Bookmark
4. Enter your API Base URL and API Token when prompted

Commands

Save Bookmark

Copy a URL, open Raycast, type Save Bookmark. The URL auto-fills from your clipboard. Pick tags, press Enter.

Save from Clipboard

Zero UI. Copy a URL, open Raycast, type Save from Clipboard, press Enter. Done.

Assign a global hotkey in Raycast preferences for one-keystroke saving.

Search Bookmarks

Open Raycast, type Search Bookmarks. Fuzzy search, filter by tag, browse archived items.

Actions on each result:

• Enter opens in browser
• Cmd+C copies the URL
• Cmd+E archives/unarchives
• Cmd+D deletes (with confirmation)

Alternative: Script Command

If you want something lighter (save only, no search or tags), create ~/.config/raycast/scripts/save-bookmark.sh:

#!/bin/bash

# Required parameters:
# @raycast.schemaVersion 1
# @raycast.title Save Bookmark
# @raycast.mode silent

# Optional parameters:
# @raycast.icon 🔖
# @raycast.argument1 { "type": "text", "placeholder": "URL (leave empty for current tab)", "optional": true }

API_URL="https://app.savethisone.com/api/bookmarks"
API_TOKEN="YOUR_API_TOKEN"

url="$1"

if [ -z "$url" ]; then
  url=$(osascript -e '
    tell application "System Events"
      set frontApp to name of first process whose frontmost is true
    end tell
    if frontApp is "Safari" then
      tell application "Safari" to return URL of current tab of front window
    else if frontApp is "Google Chrome" then
      tell application "Google Chrome" to return URL of active tab of front window
    else if frontApp is "Arc" then
      tell application "Arc" to return URL of active tab of front window
    else
      return ""
    end if
  ')
fi

if [ -z "$url" ]; then
  echo "No URL found"
  exit 1
fi

response=$(curl -s -w "\n%{http_code}" -X POST "$API_URL" \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"url\": \"$url\"}")

http_code=$(echo "$response" | tail -1)

if [ "$http_code" = "201" ]; then
  echo "Saved!"
else
  echo "Failed (HTTP $http_code)"
fi

Make it executable: chmod +x ~/.config/raycast/scripts/save-bookmark.sh

Then add the scripts directory in Raycast > Script Commands preferences.

Troubleshooting

• "Request failed: 401": API token is wrong. Regenerate from the web app.
• Commands not showing: Make sure npm run dev is running in the extension directory.
• Clipboard not auto-filling: Clipboard must contain a valid http:// or https:// URL.