URL Context Pack

Live 0.01 USDC

Give the machine one public HTTPS URL. It fetches that page under fail-closed outbound rules and returns bounded, deterministic structured context: metadata, headings, main text, JSON-LD types, freshness observations, size estimates, evidence, and limitations.

PURPOSE

Plain-English job

Agents often need a compact, inspectable reading of a public page without running a browser or an LLM. URL Context Pack does one fetch and returns a bounded JSON pack. It does not log in, crawl a site, or generate commentary.

WHEN TO CALL

Job-shaped selection

Call when you need a bounded JSON reading of one public HTTPS page without a browser, login, site crawl, or LLM. Not for private URLs, http, non-443 ports, authenticated pages, or multi-URL crawls. Sibling first-party machines are listed on GET /v1/catalog.

INPUT

Public HTTPS URL

JSON body with a single required field. Additional properties are rejected.

{
  "url": "https://example.com/"
}

The example is the OpenAPI/Bazaar contract example used in tests.

OUTPUT

Deterministic structured context

Status is OK, PARTIAL, or HOLD. Representative contract example:

{
  "status": "OK",
  "methodology_version": "url-context-0.1.0",
  "requested_url": "https://example.com/",
  "final_url": "https://example.com/",
  "metadata": {
    "title": "Example Domain",
    "description": null,
    "canonical": "https://example.com/"
  },
  "content": {
    "extraction_basis": "body-heuristic",
    "truncated": false
  },
  "limitations": []
}

OUTPUT FIELDS FROM IMPLEMENTATION

What a full result contains

HTTPstatus, content-type, redirect count

METADATAtitle, description, canonical

OUTLINEheading level + text, bounded

CONTENTtext, extraction basis, character/token estimates

STRUCTURED DATAJSON-LD @type values, including @graph

FRESHNESSobserved dates/headers only; no invented stale/fresh label

SIZEsource bytes, output JSON bytes, normalized characters

EVIDENCE / LIMITSnotes and explicit limitations travel with the result

LIMITATIONS

Known bounds

ONE URL, ONE FETCH PATHNot a crawler. No site-wide indexing.
PUBLIC HTTPS :443http, credentials-in-URL, and non-443 ports are held without fetch.
BOUNDED SIZEText, headings, JSON-LD, and response bytes are capped. Oversized pages truncate and may be PARTIAL.
SCRIPT-HEAVY PAGESSPA shells with little HTML text may return PARTIAL.
NO LOGIN / NO LLMThe pack does not authenticate and does not generate model text.
VALIDATIONIndependent commercial validation is still in progress. Founder-controlled tests are not demand, ratings, or adoption.

SECURITY BOUNDARIES // PUBLIC

What is safe to say publicly

FAIL-CLOSED OUTBOUNDTargets are checked before fetch. Unsafe destinations are held.
NO SELLER KEYS ON THE MACHINEThe runtime holds a public payTo only. It does not store a seller private key.
PAYMENT IS THE PROTOCOLUnsigned calls receive HTTP 402 with exact x402 v2 terms. A raw USDC transfer to the public payTo is not a valid machine payment and will not return the pack.
NO CERTIFICATIONNo audit badge, uptime SLA, or penetration-test claim is made here.

Public machine payTo (contract field, not a manual-pay destination): 0xdb7b2b54f80479826222749a2ea73a8acc306e1e

CONTRACT

Verified live routes

Live public API origin, verified read-only during this storefront task:

POST https://api.agentmercantile.com/v1/url-context

GET https://api.agentmercantile.com/openapi.json

Unsigned POST of the example body returns HTTP 402 with x402 v2 exact 10,000 atomic Base USDC. This page does not run that call in the browser and does not start a payment. Public contact: contact@agentmercantile.com.

DEVELOPER / API PAGE OPEN LIVE OPENAPI