# URL Metadata Scraper MCP

> URL Metadata Scraper instantly pulls clean OpenGraph and SEO metadata (title, description, image) from any link without wasting tokens on full HTML scraping. Stop loading entire webpages just to get a title or an image. This MCP gives your AI client the exact structured data it needs for social previews, SEO audits, or content summaries.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** opengraph, metadata-extraction, seo-optimization, token-optimization, html-parsing, link-preview

## Description

When your agent needs to summarize a web page—maybe for a Twitter thread or a blog preview—you don't want it dumping gigabytes of raw HTML into the context window. That's slow, expensive, and often inaccurate. This MCP fixes that by natively fetching only the essential OpenGraph and SEO tags from any URL. It uses fast parsing to return four specific pieces of data: the title, description, image, and more. You can connect this via Vinkius, giving your AI client immediate access to rich link context. Instead of asking your agent to read an entire page just for a thumbnail, you simply ask it to pull the metadata using this MCP's tools.

## Tools

### scrape_url
Pass any URL and get structured OpenGraph and SEO metadata, including the title, description, and image, without loading a full web page.

## Prompt Examples

**Prompt:** 
```
Extract the OpenGraph metadata from `https://vinkius.com`.
```

**Response:** 
```
Metadata: {"title": "Vinkius", "description": "The Agentic Platform", "image": "url.jpg"}
```

**Prompt:** 
```
Get the main image for this news article so I can post it on Twitter.
```

**Response:** 
```
Extracted: `https://news.com/cover.jpg`.
```

**Prompt:** 
```
Check the SEO description for this landing page URL.
```

**Response:** 
```
SEO Description: The best platform for AI automation.
```

## Capabilities

### Generate Link Previews
Your AI client pulls structured title and description data from any URL instantly.

### Extract Visual Assets
You retrieve the main image URL for a web page, perfect for social media posts or reports.

### Perform SEO Audits
The agent collects structured SEO tags from a link to validate landing page performance.

### Optimize Content Summaries
You provide clean, targeted metadata instead of large blocks of raw text for better AI summarization.

## Use Cases

### Building a Link Preview Widget
A developer needs to show users how a linked article will look on Twitter. Instead of writing complex scraping code, the agent simply uses `scrape_url` to grab the OpenGraph image and title, generating a perfect preview instantly.

### Campaign Content Batching
A marketing team needs 50 social posts linking to different articles. They feed all 50 URLs into their agent, which uses `scrape_url` for each one to collect the title and image URL, saving hours of manual copy-pasting.

### Competitive SEO Analysis
An SEO specialist wants to check if a competitor's landing page has proper metadata. They run `scrape_url` on several target URLs to quickly gather title and description data points for their audit report.

### Summarizing External Content
Your agent receives a link but needs to summarize it for an executive brief. Using the MCP, it extracts just the clean metadata via `scrape_url`, keeping the context window small and highly focused on the most important details.

## Benefits

- Stop wasting tokens on full HTML scrapes. This MCP uses fast parsing to pull only the title, description, and image data you need.
- Perfect for social media workflows. If your agent is building Twitter threads or LinkedIn summaries, it gets the exact metadata needed to make them look professional.
- Reduces processing time dramatically. Instead of waiting on a full headless browser render, this MCP extracts core tags instantly.
- Supports SEO validation. You can run audits across multiple links and get structured data for title or description length checks with minimal effort.
- Works across all client applications. Connect it to your preferred AI agent via Vinkius, making link metadata retrieval a standard function of your workflow.

## How It Works

The bottom line is you get precise, actionable link data without paying for or waiting on full-page content loading.

1. Give your agent the full URL you want to analyze.
2. Your AI client calls the `scrape_url` tool, which bypasses standard web scraping by reading only the specific metadata tags.
3. You receive a structured JSON payload containing clean title, description, and image URLs.

## Frequently Asked Questions

**What exactly does the scrape_url tool extract?**
scrape_url extracts OpenGraph and SEO tags from a URL. This includes the title, description, and main image, which are used by social platforms for link previews.

**Does URL Metadata Scraper load the entire webpage content?**
No, it doesn't. It uses fast parsing techniques to grab only the specific metadata tags (like title or description) without loading the full HTML body of the page.

**Can I use scrape_url for SEO audits?**
Yes. You can run structured checks on multiple URLs using `scrape_url` to validate if target pages have correctly implemented OpenGraph and SEO tags.

**Is this better than just asking the AI client to summarize a link?**
Absolutely. Asking the agent to summarize first forces it to load all content, which is slow and expensive. Using `scrape_url` gives your agent clean metadata context immediately.

**What formats does scrape_url return the data in?**
It returns a structured JSON format containing key-value pairs for the extracted title, description, and image URL. This makes it easy for your agent to parse.