linkding – OpenClaw Skill

---

name: linkding version: 1.0.1 description: Manage bookmarks with Linkding. Use when the user asks to "save a bookmark", "add link", "search bookmarks", "list my bookmarks", "find saved links", "tag a bookmark", "archive bookmark", "check if URL is saved", "list tags", "create bundle", or mentions Linkding bookmark management.

Linkding Bookmark Manager

Query and manage bookmarks via the Linkding REST API.

Setup

Config: ~/.clawdbot/credentials/linkding/config.json

{
  "url": "https://linkding.example.com",
  "apiKey": "your-api-token"
}

Get your API token from Linkding Settings page.

Quick Reference

List/Search Bookmarks

# List recent bookmarks
./scripts/linkding-api.sh bookmarks

# Search bookmarks
./scripts/linkding-api.sh bookmarks --query "python tutorial"

# List archived
./scripts/linkding-api.sh bookmarks --archived

# Filter by date
./scripts/linkding-api.sh bookmarks --modified-since "2025-01-01T00:00:00Z"

Create Bookmark

# Basic
./scripts/linkding-api.sh create "https://example.com"

# With metadata
./scripts/linkding-api.sh create "https://example.com" \
  --title "Example Site" \
  --description "A great resource" \
  --tags "reference,docs"

# Archive immediately
./scripts/linkding-api.sh create "https://example.com" --archived

Check if URL Exists

./scripts/linkding-api.sh check "https://example.com"

Returns existing bookmark data if found, plus scraped metadata.

Update Bookmark

./scripts/linkding-api.sh update 123 --title "New Title" --tags "newtag1,newtag2"

Archive/Unarchive

./scripts/linkding-api.sh archive 123
./scripts/linkding-api.sh unarchive 123

Delete

./scripts/linkding-api.sh delete 123

Tags

# List all tags
./scripts/linkding-api.sh tags

# Create tag
./scripts/linkding-api.sh tag-create "mytag"

Bundles (saved searches)

# List bundles
./scripts/linkding-api.sh bundles

# Create bundle
./scripts/linkding-api.sh bundle-create "Work Resources" \
  --search "productivity" \
  --any-tags "work,tools" \
  --excluded-tags "personal"

Response Format

All responses are JSON. Bookmark object:

{
  "id": 1,
  "url": "https://example.com",
  "title": "Example",
  "description": "Description",
  "notes": "Personal notes",
  "is_archived": false,
  "unread": false,
  "shared": false,
  "tag_names": ["tag1", "tag2"],
  "date_added": "2020-09-26T09:46:23.006313Z",
  "date_modified": "2020-09-26T16:01:14.275335Z"
}

Common Patterns

Save current page for later:

./scripts/linkding-api.sh create "$URL" --tags "toread" --unread

Quick search and display:

./scripts/linkding-api.sh bookmarks --query "keyword" --limit 10 | jq -r '.results[] | "\(.title) - \(.url)"'

Bulk tag update: Update via API PATCH with new tag_names array.

Linkding Skill

Manage bookmarks via Linkding REST API from Clawdbot.

What It Does

• Bookmarks — list, search, create, update, archive, delete
• Tags — list and create tags
• Bundles — saved searches with filters
• Check URLs — see if a link is already bookmarked

Setup

1. Get Your API Token

1. Open your Linkding web UI
2. Go to Settings
3. Find the REST API section
4. Copy your API Token

2. Create Credentials File

mkdir -p ~/.clawdbot/credentials/linkding
cp config.json.example ~/.clawdbot/credentials/linkding/config.json
# Edit with your actual values

Or create manually:

{
  "url": "https://linkding.example.com",
  "apiKey": "your-api-token-here"
}

3. Test It

./scripts/linkding-api.sh bookmarks --limit 5

Usage Examples

List and search bookmarks

# Recent bookmarks
linkding-api.sh bookmarks

# Search by keyword
linkding-api.sh bookmarks --query "python tutorial"

# Archived bookmarks
linkding-api.sh bookmarks --archived

# With pagination
linkding-api.sh bookmarks --limit 20 --offset 40

Create bookmark

# Basic
linkding-api.sh create "https://example.com"

# With metadata
linkding-api.sh create "https://example.com" \
  --title "Example Site" \
  --description "A great resource" \
  --tags "reference,docs"

# Create and archive immediately
linkding-api.sh create "https://example.com" --archived

Check if URL exists

linkding-api.sh check "https://example.com"

Manage bookmarks

# Update
linkding-api.sh update 123 --title "New Title" --tags "newtag"

# Archive/unarchive
linkding-api.sh archive 123
linkding-api.sh unarchive 123

# Delete
linkding-api.sh delete 123

Tags

linkding-api.sh tags           # List all tags
linkding-api.sh tag-create "mytag"

Bundles (saved searches)

linkding-api.sh bundles        # List bundles

linkding-api.sh bundle-create "Work Resources" \
  --search "productivity" \
  --any-tags "work,tools"

Environment Variables (Alternative)

export LINKDING_URL="https://linkding.example.com"
export LINKDING_API_KEY="your-api-token"

Troubleshooting

"LINKDING_URL and LINKDING_API_KEY must be set"
→ Check your config file exists at ~/.clawdbot/credentials/linkding/config.json

401 Unauthorized
→ Your API token is invalid — regenerate it in Linkding settings

License

MIT