---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/link-preview
---
# Link Preview

Pull structured metadata from any URL — title, description, Open Graph image, author, publisher, date, language, and logo. Faster than a full scrape when you only need key page details. Perfect for link cards, bookmark enrichment, social preview validation, or quick URL summaries.

- **Version:** 0.02
- **Categories:** data, productivity

## Skills (1)

### Preview URL (`preview_url`)

Extract metadata from a single URL. Returns title, description, image, author, publisher, language, and logo.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | The full URL to extract metadata from (e.g. "https://example.com/article") |

**Returns:** Page metadata including title, description, author, publisher, language, preview image URL, and site logo URL

**Examples:**

*Extract metadata from a blog post:*

```json
{
  "url": "https://toolrouter.com"
}
```

*Preview a GitHub repository page:*

```json
{
  "url": "https://github.com/vercel/next.js"
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call link-preview preview_url --url https://toolrouter.com

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"link-preview","skill":"preview_url","input":{"url":"https://toolrouter.com"}}' \
     https://api.toolrouter.com/v1/tools/call
```

## Frequently Asked Questions

### Do I need to pass a full URL?

Yes. `preview_url` expects a complete URL with protocol, such as `https://...`.

### What metadata does the preview return?

It returns the title, description, Open Graph image, author, publisher, language, and logo for the page.

### Is this useful for social cards or bookmarks?

Yes. It is a fast way to validate link cards, bookmark previews, and social metadata without doing a full scrape.

### Can I get article dates and author details?

When the page exposes them, the preview includes published date and author data for article-style content.

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs