youmind-web-clipper

# Save Link & Web Clipper

Save any URL to your [YouMind](https://youmind.com?utm_source=youmind-web-clipper) board with one command. Articles, videos, documents — anything with a URL gets saved and organized in your personal knowledge base. Requires the [YouMind CLI](https://www.npmjs.com/package/@youmind-ai/cli) (`npm install -g @youmind-ai/cli`).

> [Get API Key →](https://youmind.com/settings/api-keys?utm_source=youmind-web-clipper) · [More Skills →](https://youmind.com/skills?utm_source=youmind-web-clipper)

## 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](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](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:**

```
✅ 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](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](../../shared/PUBLISHING.md)