OpenGraph, Twitter Cards & JSON-LD Microdata Extractor
extract_structured_metadataExtracts OpenGraph tags, Twitter Card metadata, canonical URLs, and Schema.org JSON-LD microdata scripts from live URLs or raw HTML. Accepts either 'url' to fetch directly or raw 'html_content' from upstream scrape_readable_article; for extracting contact emails and phone numbers, use extract_contact_info instead. Stateless read-only edge call (max 32 KB, 60 RPM): accepts 'url' or 'html_content' ('metadata_targets' defaults to 'all_protocols'), supports '?demo=true' or L402 (10 sats), and returns HTTP 400 if invalid.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "extract_structured_metadata"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Optional web page URL to fetch and parse directly, bypassing an out-of-band fetch step. | |
| html_content | No | Source HTML string containing head tags, OpenGraph meta properties, or JSON-LD scripts. | |
| include_favicons | No | Whether to extract favicon links and Apple Touch icon references. | |
| metadata_targets | No | Target metadata protocol filter: all protocols, OpenGraph and Twitter, or Schema.org JSON-LD. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| open_graph | Yes | Structured OpenGraph properties including og:title, og:image, and og:description. | |
| twitter_card | Yes | Twitter Card metadata including twitter:card, twitter:creator, and twitter:image. | |
| canonical_url | Yes | Canonical canonical link target or empty string if unspecified. | |
| json_ld_schemas | Yes | Parsed Schema.org JSON-LD structured data objects. |