MCP documentation menu

datapulse_domain_overview

OtherScope: datapulse:scrapeRead-only

Domain research in one call: the root URL’s web scrape, a live DNS lookup and RDAP registration data, combined. The starting point for …

Description

Domain research in one call: the root URL’s web scrape, a live DNS lookup and RDAP registration data, combined. The starting point for investigating a domain.

Submits whatever is missing and waits: a first call waits up to 45 s (a scrape typically takes 5-30 s) and returns a part not ready in time as null (the scrape with a note); later calls answer from storage unless force=true. The domain is looked up as given (www. kept); a single label and an underscore in the registrable domain (exa_mple.com, not _dmarc.example.com) are refused.

Returns summary (resolves, dnssec and registrar_name are always present; registrar_iana_id, registration_date, expiration_date, entity_name, entity_type, nature and country when their source had a value, the extractor’s “unknown” and “other” placeholders included), scrape (the root URL’s row with redirect_chain; null, with a note, when no scrape row exists yet), other_scrapes (when any), dns (the datapulse_live_dns summary), rdap (the RDAP envelope) with rdap_status and rdap_error, and domain_hash.

dnssec “unknown” with resolves false means the DNS lookup failed: no finding about the name. The entity fields describe what the site’s web content claims, not registrant data. link_data selects link_domains (the default) or the links array (first 300 records); include_dom adds the first 40 KB part of the DOM; a note names the datapulse_scrape_result call for further parts.

Reference: datapulse_help(topic="scraping")

Parameters

ParameterTypeDescription
domain
required
string
The domain to investigate (e.g. “osu.edu”), IDN accepted. Looked up as given (www. kept); submitted_domain echoes an input that canonicalizing changed.
Min length: 1Max length: 253
forceboolean
Fetch everything again even when stored results exist. Default false.
Default: false
include_domboolean
Include the first 40 KB part of the cleaned HTML DOM in the scrape result (cleaned_dom_total and next_text_offset when there is more). Default false.
Default: false
link_datastring
Which link structures the scrape carries: none, domains (link_domains, ~500 bytes; the default), links (the links array, first page of 300 records, up to ~37 KB) or both. An unrecognised value is refused.
Default: "domains"Max length: 7
nonedomainslinksboth
Input schema (JSON)
{
  "additionalProperties": false,
  "properties": {
    "domain": {
      "description": "The domain to investigate (e.g. \"osu.edu\"), IDN accepted. Looked up as given (www. kept); submitted_domain echoes an input that canonicalizing changed.",
      "maxLength": 253,
      "minLength": 1,
      "type": "string"
    },
    "force": {
      "default": false,
      "description": "Fetch everything again even when stored results exist. Default false.",
      "type": "boolean"
    },
    "include_dom": {
      "default": false,
      "description": "Include the first 40 KB part of the cleaned HTML DOM in the scrape result (cleaned_dom_total and next_text_offset when there is more). Default false.",
      "type": "boolean"
    },
    "link_data": {
      "default": "domains",
      "description": "Which link structures the scrape carries: none, domains (link_domains, ~500 bytes; the default), links (the links array, first page of 300 records, up to ~37 KB) or both. An unrecognised value is refused.",
      "enum": [
        "none",
        "domains",
        "links",
        "both"
      ],
      "maxLength": 7,
      "type": "string"
    }
  },
  "required": [
    "domain"
  ],
  "type": "object"
}

Generated from the live server (DataPulse MCP v0.9-341-g27163c2) on October 20, 2026.