return_links
Extract and categorize all URLs from a webpage into pages and assets, enabling link analysis and sitemap generation.
Instructions
Extract and categorize all URLs from a webpage.
Best for:
Discovering all links on a page
Building sitemaps
Finding all assets (images, scripts, stylesheets)
Web crawling and link analysis
Identifying internal vs external links
What it extracts:
Links from , tags
Images from ,
Scripts from
Stylesheets from
Media from , ,
Embedded content from , ,
URLs from CSS url() functions
Meta refresh redirects
Open Graph and meta image URLs
URL Processing:
Converts relative URLs to absolute
Removes duplicates
Filters out mailto:, tel:, javascript:, data: URLs
Categorizes into pages vs assets
Returns: JSON with two arrays:
pages: HTML documents and navigational URLs
assets: Static resources (js, css, images, fonts, media)
Usage Examples:
Basic URL extraction:
{
"name": "return_links",
"arguments": {
"url": "https://example.com"
}
}Extract URLs from protected site:
{
"name": "return_links",
"arguments": {
"url": "https://protected-site.com",
"bypass_level": "generic_level_1"
}
}Geo-targeted extraction:
{
"name": "return_links",
"arguments": {
"url": "https://example.de",
"country": "de"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| mobile | No | ||
| country | No | ||
| premium | No | ||
| residential | No | ||
| bypass_level | No | ||
| session_number | No | ||
| max_request_cost | No | ||
| optimize_request | No |