Raindrop Root Domain Autotag

PowerShell scripts for automatically tagging Raindrop bookmarks by root domain.

This project:

• reads all bookmarks from the Raindrop API
• extracts a root-domain tag such as github.io, pages.dev, or blogspot.com
• applies a fallback tag such as unprocessed-domain when a root domain cannot be safely determined
• skips bookmarks that are already correctly tagged
• supports Windows Task Scheduler for daily automation
• includes retry, timeout, and malformed-tag cleanup logic

This is a third-party automation script and is not affiliated with Raindrop.io.

Files

• Invoke-RaindropRootDomainAutotag.ps1
  • main script
  • fetches bookmarks, calculates tags, and updates Raindrop
• Save-RaindropToken.ps1
  • securely stores a Raindrop API token for the current Windows user
• Install-RaindropDailyTask.ps1
  • installs a daily Windows scheduled task
• Run-RaindropAutotagHidden.example.ps1
  • optional wrapper script template with logging

Requirements

• Windows PowerShell 5.1 or later
• A Raindrop API token
• Internet access when the script runs

1. Save your token

Run:

powershell -ExecutionPolicy Bypass -File ".\Save-RaindropToken.ps1"

This stores your token at:

%LOCALAPPDATA%\RaindropRootDomainAutotag\token.secure.txt

2. Test with a dry run

Run:

powershell -ExecutionPolicy Bypass -File ".\Invoke-RaindropRootDomainAutotag.ps1" -DryRun -FallbackTag "unprocessed-domain" -RequestTimeoutSec 45 -MaxRetries 4 -RetryDelaySec 3

This will scan bookmarks and show what would be changed, without writing anything.

3. Run for real

Run:

powershell -ExecutionPolicy Bypass -File ".\Invoke-RaindropRootDomainAutotag.ps1" -FallbackTag "unprocessed-domain" -RequestTimeoutSec 45 -MaxRetries 4 -RetryDelaySec 3

4. Install a daily scheduled task

Run:

powershell -ExecutionPolicy Bypass -File ".\Install-RaindropDailyTask.ps1" -TaskName "Raindrop Root Domain Autotag" -Time "04:00" -FallbackTag "unprocessed-domain" -Force

This installs a daily task that directly runs the main script.

Optional: Use the logging wrapper

If you want a separate wrapper script with log output, copy:

• Run-RaindropAutotagHidden.example.ps1

Rename it to:

• Run-RaindropAutotagHidden.ps1

Then edit the $mainScript path inside it to match your local script path.

Log files are stored at:

%LOCALAPPDATA%\RaindropRootDomainAutotag\Logs

What counts as a fallback tag

The script uses the fallback tag when it cannot safely produce a normal root-domain tag, for example:

• IP-based links
• localhost
• malformed hosts
• unsupported host formats

Safety notes

• Do not commit your token file.
• Do not commit personal logs.
• Do not commit your own bookmark export data unless you intentionally want it public.

License

MIT