Extract HTML Metadata

Overview

You send HTML you already have and we read the head for you: title, meta description, canonical link, language, robots directive, every Open Graph and Twitter Card field, and the icon links. Give us a baseUrl and relative canonical and icon hrefs come back absolute. Nothing is fetched and no script runs, so what you get reflects the markup exactly as you sent it. Accepts file input via file_ref — no need to extract file content first.

Pulling head tags out with string matching breaks on real-world markup, and you would rather not render a whole page just to read six fields.

When to use it

Scope

Non-goals

• Does not fetch the page, its icons, or any other linked resource
• Does not render the page or run its scripts
• Does not check that a canonical URL or icon actually resolves
• Does not read metadata that only appears after JavaScript runs

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_html_metadata","input":{"html":"<html><head><title>Pricing</title></head></html>"}}'

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

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

const { output } = await sq.execute("web.extract_html_metadata", {"html":"<html lang=\"en\"><head><title>Pricing — Acme</title><meta name=\"description\" content=\"Plans and pricing for Acme.\"></head></html>"});

Errors

Other limits

Limitations

• Does not fetch the page, its icons, or any other linked resource
• Does not render the page or run its scripts
• Does not check that a canonical URL or icon actually resolves
• Does not read metadata that only appears after JavaScript runs
• Rendering a page or taking a screenshot of it
• Fetching a live page — bring the markup with you
• Reading structured data blocks, which web.extract_json_ld handles

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "web.extract_html_metadata",
  "input": {
    "html": "<html lang=\"en\"><head><title>Pricing — Acme</title><meta name=\"description\" content=\"Plans and pricing for Acme.\"></head></html>"
  }
}

Examples

{
  "html": "<html lang=\"en\"><head><title>Pricing — Acme</title><meta name=\"description\" content=\"Plans and pricing for Acme.\"></head></html>"
}

{
  "metadata": {
    "title": "Pricing — Acme",
    "description": "Plans and pricing for Acme.",
    "language": "en"
  },
  "ok": true
}

{
  "baseUrl": "https://example.com",
  "html": "<html><head><link rel=\"canonical\" href=\"/pricing\"><meta property=\"og:title\" content=\"Acme Pricing\"><meta property=\"og:type\" content=\"website\"></head></html>"
}

{
  "metadata": {
    "canonical": "https://example.com/pricing",
    "openGraph": {
      "type": "website",
      "title": "Acme Pricing"
    }
  },
  "ok": true
}

Recommended use cases

• Build a link preview or social card from HTML you saved
• Audit the title, description, and Open Graph tags before you publish
• Catalogue crawled pages by their declared metadata

Avoid for

• Rendering a page or taking a screenshot of it
• Fetching a live page — bring the markup with you
• Reading structured data blocks, which web.extract_json_ld handles

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