{"tool":"extract","title":"Web Extract","what":"Fetch any public web page and return its main content as clean Markdown (navigation, scripts and boilerplate removed) with title, description, language, canonical URL, author, publish date, headings, links and images. Built for agents that need to read or cite the web. Follows up to 5 redirects; HTML, plain text and JSON pages.","endpoint":"https://yruz.one/api/extract","methods":["GET with query parameters","POST with a JSON body (same fields)"],"price":{"model":"fixed","usdc":"0.005"},"params":[{"name":"url","required":true,"description":"page URL, e.g. https://example.com/post","example":"https://en.wikipedia.org/wiki/HTTP_402"},{"name":"links","required":false,"description":"1 to include every link on the page (default 1)","example":null},{"name":"max_chars","required":false,"description":"cap on the Markdown length, 1000-200000 (default 60000)","example":null}],"valid_request":{"get":"https://yruz.one/api/extract?url=https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FHTTP_402","post":{"url":"https://yruz.one/api/extract","body":{"url":"https://en.wikipedia.org/wiki/HTTP_402"}}},"how_to_pay":["1. Send the request without payment: the answer is HTTP 402 with the exact price (x402 v2 in the PAYMENT-REQUIRED header, x402 v1 in the JSON body).","2. Sign one offer of \"accepts\" with an x402 client (USDC on Base eip155:8453 or on Solana mainnet; the facilitator pays the network fee).","3. Resend the identical request (same method, parameters and body) with PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1).","4. The answer carries the receipt in PAYMENT-RESPONSE. Any changed parameter needs a new 402."],"response_shape":{"product":"string","result":{"url":"string","final_url":"string","status":"number","content_type":"string","redirects":"number","title":"string","description":"null","lang":"string","canonical":"string","site_name":"null","author":"string","published":"string","modified":"string","image":"string","jsonld_types":["string"],"word_count":"number","reading_minutes":"number","headings":[{"level":"number","text":"string"}],"markdown":"string","truncated":"boolean","links":[{"url":"string","text":"string"}],"images":[{"src":"string","alt":"null"}]},"payment":{"payment_id":"string","transaction":"string"}},"refusals":{"400":"invalid input: the message names the field and the expected format; nothing is charged","402":"payment required, or the payment was refused (reason in \"error\"); nothing is charged","403/404":"not your item, or the asked item does not exist; nothing is charged","409/422":"not allowed right now (state or destination safety); nothing is charged","503":"a source or the payment rail is unavailable; nothing is charged, retry after Retry-After"},"mcp":{"server":"https://yruz.one/mcp/x402","payment":"params._meta[\"x402/payment\"] = PaymentPayload"}}