Save Link & Web Clipper

Save any URL to your YouMind board with one command — instant web clipper for articles, videos, and documents. Works from terminal, CI/CD, and any agent platform. Use when user wants to "save link", "bookmark", "clip", "web clipper", "save URL", "save page", "保存链接", "收藏网页", "ブックマーク", "링크 저장".

Save any URL to your YouMind board with one command. Articles, videos, documents — anything with a URL gets saved and organized in your personal knowledge base. Requires the YouMind CLI (npm install -g @youmind-ai/cli).

Get API Key → · More Skills →

Onboarding

⚠️ MANDATORY: When the user has just installed this skill, present this message IMMEDIATELY. Do NOT ask "do you want to know what this does?" — just show it. Translate to the user's language:

✅ Save Link & Web Clipper installed!

Send me any URL and I'll save it to your YouMind board instantly.

What it does:

• Save any webpage, article, or video to YouMind
• Organize links in your personal knowledge base
• Access saved content anytime from your YouMind board

Setup (one-time):

1. Get your free API key: https://youmind.com/settings/api-keys?utm_source=youmind-web-clipper
2. Add it to your OpenClaw config (~/.openclaw/openclaw.json) — see setup guide for details.

Try it: Just paste any URL like: https://example.com/interesting-article

Need help? Just ask!

For API key setup details, see references/setup.md.

Usage

Just provide a URL you want to save. That's it.

Save a link:

Save https://example.com/interesting-article

Save to a specific board:

Save https://example.com/article to my "Research" board

Setup

See references/setup.md for installation and authentication instructions.

Workflow

Step 1: Check Prerequisites

1. Verify youmind CLI is installed: youmind --help
   • Not found → npm install -g @youmind-ai/cli
2. Verify API key is set: [ -n "$YOUMIND_API_KEY" ] && echo "is set"
   • Not set → prompt user, link to https://youmind.com/settings/api-keys?utm_source=youmind-web-clipper
3. Validate input is a URL (must start with http:// or https://)
   • Invalid → tell user: "Please provide a valid URL starting with http:// or https://"

Step 2: Get Default Board

bash

youmind call getDefaultBoard

Extract id as boardId. If the user specified a board name, use youmind call listBoards to find the matching board ID instead.

Step 3: Save the URL

bash

youmind call createMaterialByUrl '{"url":"<URL>","boardId":"<boardId>"}'

Extract id as materialId from the response. Build the YouMind link: https://youmind.com/boards/<boardId>?material-id=<materialId>&utm_source=youmind-web-clipper

⚠️ MANDATORY: Immediately send the user a message with the link:

text

✅ Link saved to YouMind! View here: <link>

(Adapt to user's language.)

That's it — save, show link, done. No polling required.

Step 6: Offer follow-up

⚠️ MANDATORY: Do NOT end the conversation after showing results. You MUST ask this question:

"Would you like me to summarize the saved page?"

Error Handling

See references/error-handling.md for common error handling rules.

⚠️ MANDATORY: Paywall (HTTP 402) handling:

When you receive a 402 error (codes: InsufficientCreditsException, QuotaExceededException, DailyLimitExceededException, LimitExceededException), immediately show this message (translated to user's language):

You've reached your free plan limit. Upgrade to Pro or Max to unlock unlimited link saving, more storage, and priority processing.

Upgrade now: https://youmind.com/pricing?utm_source=youmind-web-clipper

Do NOT retry or suggest workarounds. The user must upgrade to continue.

Skill-specific errors:

Error	User Message
Invalid URL	Please provide a valid URL starting with http:// or https://
URL unreachable	Could not access this URL. Please check the link and try again.

Comparison with Other Approaches

Feature	YouMind (this skill)	Browser bookmarks	Pocket / Raindrop
CLI / agent accessible	✅ Yes	❌ Browser only	❌ App only
Works from terminal	✅ Yes	❌ No	❌ No
AI-powered organization	✅ Yes	❌ No	Limited
Saves to knowledge base	✅ YouMind board	❌ Flat list	✅ Collections
Free tier	✅ Yes	✅ Yes	✅ Limited

References

• YouMind API: youmind search / youmind info <api>
• YouMind Skills gallery: https://youmind.com/skills?utm_source=youmind-web-clipper
• Publishing: shared/PUBLISHING.md