Extract Links

Overview

You send HTML or Markdown and we gather the links out of it: anchors, images, and head link elements from HTML, and inline links, images, and autolinks from Markdown. Relative URLs resolve against the baseUrl you give us, hosts and default ports get tidied, repeats collapse, and anything using a javascript:, vbscript:, data:, or file: scheme is flagged so you can drop it before display. Nothing is fetched, so reach for web.check_url_status when you need to know a link actually works. Accepts file input via file_ref — no need to extract file content first.

Guessing URLs out of prose with a pattern goes wrong on real documents, and you want the same tidy list every time so you can compare two runs.

When to use it

Scope

Non-goals

• Does not fetch a link, or check that one resolves
• Does not render the document
• Does not follow Markdown reference-style definitions
• Does not strip an unsafe link, only marks it for you

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

File limits

Constraints this skill applies to your input and generated files. The “Limited by” column shows the static source of each cap; none of these can be raised by upgrading your plan.

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"web.extract_links","input":{"content":"See [Example](https://example.com/page)","format":"markdown"}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("web.extract_links", {"format":"html","content":"<a href=\"https://Example.com\" rel=\"noopener\">Our site</a>"});

Errors

Other limits

Limitations

• Does not fetch a link, or check that one resolves
• Does not render the document
• Does not follow Markdown reference-style definitions
• Does not strip an unsafe link, only marks it for you
• Confirming a link responds — reach for web.check_url_status
• Reading page metadata, which web.extract_html_metadata covers

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "web.extract_links",
  "input": {
    "format": "html",
    "content": "<a href=\"https://Example.com\" rel=\"noopener\">Our site</a>"
  }
}

Examples

{
  "format": "html",
  "content": "<a href=\"https://Example.com\" rel=\"noopener\">Our site</a>"
}

{
  "ok": true,
  "links": [
    {
      "normalizedUrl": "https://example.com/",
      "url": "https://Example.com",
      "source": "anchor",
      "text": "Our site",
      "rel": "noopener"
    }
  ]
}

{
  "format": "markdown",
  "content": "See [Example](https://example.com/page)"
}

{
  "ok": true,
  "links": [
    {
      "normalizedUrl": "https://example.com/page",
      "url": "https://example.com/page",
      "start": 4,
      "source": "anchor",
      "end": 39
    }
  ]
}

Recommended use cases

• Plan a crawl or a link audit from HTML or Markdown you saved
• Collect the citation and reference URLs out of a document
• Spot javascript: and data: links before you render them

Avoid for

• Confirming a link responds — reach for web.check_url_status
• Reading page metadata, which web.extract_html_metadata covers

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags