{"uid":"cap_JlRX29zGJMfCib6b2JaU3","slug":"product-offers-extractor-for-shopping-agents-124bb455","name":"Product Offers Extractor for Shopping Agents","description":"Choose whole-pack quantities under supplied stock limits, compare product offers and keep unknown checkout costs visible. Free examples; paid HTTP and hosted MCP tools.","url":"https://agent-utilities.agent-utilities.workers.dev/v1/reports/product-offers?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["html"],"properties":{"html":{"type":"string"},"baseUrl":{"type":"string"},"maxOffers":{"type":"integer"}}},"responseSchema":{"type":"object","properties":{"result":{"type":"object","required":["sourceUrl","metadata","productOffers","scope"],"properties":{"scope":{"type":"string","const":"Source metadata and declared Product/Offer JSON-LD from the same supplied HTML. No page fetch, script execution, merchant verification or live price/stock check. Inspect offer warnings, source pointers, missing fields and truncation. Canonical URLs are page assertions; retain your original source URL."},"metadata":{"type":"object","required":["title","description","language","canonicalUrl","robots","social"],"properties":{"title":{"type":"string"},"robots":{"type":"string"},"social":{"type":"array","items":{"type":"object","required":["name","content"],"properties":{"name":{"type":"string"},"content":{"type":"string"}},"additionalProperties":false}},"language":{"type":"string"},"description":{"type":"string"},"canonicalUrl":{"type":["string","null"]}},"additionalProperties":false},"sourceUrl":{"type":["string","null"]},"productOffers":{"type":"object","required":["offers","productsFound","productsWithoutOffers","invalidBlocks","unresolvedReferences","unsupportedOffers","truncated","scope"],"properties":{"scope":{"type":"string"},"offers":{"type":"array","items":{"type":"object","required":["productName","sku","gtin","offerType","price","currency","lowPrice","highPrice","url","availability","itemCondition","priceValidUntil","source","warnings"],"properties":{"sku":{"type":["string","null"]},"url":{"type":["string","null"]},"gtin":{"type":["string","null"]},"price":{"type":["string","null"]},"source":{"type":"object","required":["productBlock","productPointer","offerBlock","offerPointer"],"properties":{"offerBlock":{"type":"number"},"offerPointer":{"type":"string"},"productBlock":{"type":"number"},"productPointer":{"type":"string"}},"additionalProperties":false},"currency":{"type":["string","null"]},"lowPrice":{"type":["string","null"]},"warnings":{"type":"array","items":{"type":"string"}},"highPrice":{"type":["string","null"]},"offerType":{"type":"string"},"productName":{"type":["string","null"]},"availability":{"type":["string","null"]},"itemCondition":{"type":["string","null"]},"priceValidUntil":{"type":["string","null"]}},"additionalProperties":false}},"truncated":{"type":"boolean"},"invalidBlocks":{"type":"number"},"productsFound":{"type":"number"},"unsupportedOffers":{"type":"number"},"unresolvedReferences":{"type":"number"},"productsWithoutOffers":{"type":"number"}},"additionalProperties":false}},"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"const":"facilitator-confirmed"},"recoveryExpiresAt":{"type":"string"},"finalOnchainSettlementIndependentlyVerified":{"const":false}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_I12xDdjXHplidOznnxJyj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts and structures Product/Offer JSON-LD data from raw HTML to help agents compare product offers, prices, and availability with explicit scope warnings","exampleAgentPrompt":"I just scraped the HTML from this product page — can you pull out all the product offers including prices, availability, SKUs, and any warnings about missing or invalid fields? Here's the HTML, and the base URL is https://example.com/product/123.","exampleUseCases":[{"title":"Comparing offers across product variants","prompt":"I have the raw HTML from a sneaker listing page at https://shop.example.com/nike-air-max. Can you extract all the product offers from it — prices, sizes, availability, and any warnings about incomplete data — so I can compare what's actually in stock?"},{"title":"Validating structured data before indexing","prompt":"Before I index this product page, I need to check the quality of its JSON-LD markup. Here's the full HTML — extract all Product and Offer blocks and flag any missing fields, invalid values, or unresolved references so I know what to fix."},{"title":"Price monitoring agent setup","prompt":"Pull the product offer data out of this HTML from a retailer page — I want the price, currency, price valid until date, and availability for each offer so I can track whether prices change over time. Base URL is https://retailer.example.com/item/456."}],"resultDescription":"Returns structured product offer objects extracted from JSON-LD in the supplied HTML, each with product name, SKU, GTIN, offer type, price, currency, price range, URL, availability, item condition, price valid until, source block pointers, and an array of warnings. Also returns page metadata (title, description, canonical URL, language, robots, social tags), counts of products found without offers, invalid blocks, unresolved references, unsupported offers, and a truncation flag. A scope string clarifies that no live page fetch, script execution, or real-time price/stock verification is performed.","failureModes":["HTML field missing or empty — returns error requiring html input","No JSON-LD Product/Offer blocks found in HTML — returns empty offers array with productsFound=0","Malformed JSON-LD blocks — counted as invalidBlocks with warnings","Offers exceed maxOffers limit — result is truncated with truncated flag set to true","Base URL not resolvable for relative URL resolution — canonical URLs may remain relative","HTML too large — may cause timeout or truncation","Unresolved offer references — counted in unresolvedReferences field","Unsupported offer types — counted in unsupportedOffers field"],"whenToPreferThis":"Choose this endpoint when you have raw HTML from a product or shopping page and need to extract structured Product/Offer JSON-LD data without making additional HTTP requests. It is ideal for agents that scrape pages themselves and need to parse pricing, availability, SKUs, and GTINs from structured markup in a single call. Prefer it over generic HTML parsers when you specifically need JSON-LD e-commerce schema extraction with built-in validation warnings and source pointers. It is not suitable for fetching live prices, verifying stock in real time, or executing purchases.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:32:20.407Z","isFirstParty":false,"canonicalSlug":"product-offers-extractor-for-shopping-agents-124bb455"}