功能描述

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.

使用说明 (SKILL.md)

Linkding Bookmark Manager

Name: Linkding
Author: jmagar

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

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.

安全使用建议

This skill appears to be a straightforward Linkding REST client, but pay attention to these points before installing: (1) The metadata omitted required runtime items — you must provide an API token and Linkding URL (either in ~/.clawdbot/credentials/linkding/config.json or via LINKDING_URL/LINKDING_API_KEY env vars). (2) The included script depends on curl and jq; install those or the script will fail. (3) Verify the LINKDING_URL you configure is the intended server (don't point it at an unknown third-party), since the script will send your API token to that URL. (4) Inspect scripts/linkding-api.sh yourself (it is plain shell) to confirm you are comfortable with its behavior. If you want to proceed, create the config file manually and only grant the API token minimal permissions; if the metadata or registry page cannot explain why credentials/config requirements were omitted, consider contacting the skill author or using an alternative with correct metadata.

功能分析

Type: OpenClaw Skill Name: linkding Version: 1.0.1 The skill is designed to manage bookmarks via the Linkding REST API. It correctly loads API credentials (URL and API Key) from the designated secure location (`~/.clawdbot/credentials/linkding/config.json`) or environment variables. All network interactions are performed using `curl` against the user-configured Linkding instance, and input parameters are properly sanitized using `jq` for URL encoding and JSON payload construction. There is no evidence of data exfiltration to unauthorized endpoints, malicious execution, persistence mechanisms, or prompt injection attempts against the agent beyond its stated purpose. The functionality is entirely aligned with its description.

能力评估

✓ Purpose & Capability

The name/description (Linkding bookmark management) matches the included files: SKILL.md, README, and a shell API helper that implements listing, creating, updating, tagging, bundles, etc. The functionality described is coherent with a Linkding REST client.

✓ Instruction Scope

SKILL.md directs the agent to use the provided scripts/linkding-api.sh and to store a Linkding URL/API token in ~/.clawdbot/credentials/linkding/config.json (or provide env vars). The instructions do not request unrelated files, system-wide secrets, or external endpoints beyond the Linkding server URL the user supplies.

ℹ Install Mechanism

There is no install spec (instruction-only), which is low risk. However, the shipped script requires runtime tools (curl and jq) but the skill metadata declares no required binaries. That mismatch could cause runtime failures or surprise dependency assumptions.

⚠ Credentials

Registry metadata lists no required environment variables or config paths, but the script expects LINKDING_URL and LINKDING_API_KEY (or a config file at ~/.clawdbot/credentials/linkding/config.json) and optionally LINKDING_CONFIG. These are appropriate for the skill's purpose, but the metadata omission is a notable inconsistency: the skill will need an API token (sensitive secret) and a server URL which the registry did not declare.

✓ Persistence & Privilege

The skill does not request always: true and does not modify other skills or system-wide settings. It reads a user-provided config file in the user's home directory and does not appear to persist additional credentials or perform privileged system changes.

版本历史

v1.0.1

- Added README.md file. - Added explicit version field (1.0.1) to SKILL.md.

v1.0.0

Initial release: full API wrapper for bookmarks, tags, and bundles

元数据

Slug linkding

版本 1.0.1

许可证 —

累计安装 2

当前安装数 2

历史版本数 2

常见问题

Linkding 是什么？

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. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2098 次。

如何安装 Linkding？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install linkding」即可一键安装，无需额外配置。

Linkding 是免费的吗？

是的，Linkding 完全免费（开源免费），可自由下载、安装和使用。

Linkding 支持哪些平台？

Linkding 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Linkding？

由 jmagar（@jmagar）开发并维护，当前版本 v1.0.1。

Linkding