{"uid":"cap_7KVozmnNtbP2MyHjeugpj","slug":"ysaere-agent-compare-documents-26974afd","name":"Ysaere Agent Compare Documents","description":"Ysaere Agent Compare Documents — $0.05 USDC. Input: {\"a\":{\"url\"|\"text\"},\"b\":{\"url\"|\"text\"}}. Returns section-level added / removed / changed items, a short summary, the SHA-512 of each input and output_sha512. Identical or unreadable inputs are refused before payment.","url":"https://api.ysaere.com/v1/intel/compare-docs?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"a":{"type":"object","properties":{"url":{"type":"string","description":"Public https URL to read (fetched with SSRF checks)."},"text":{"type":"string","maxLength":8000,"description":"Text to use instead of a URL (max 8,000 characters)."}}},"b":{"type":"object","properties":{"url":{"type":"string","description":"Public https URL to read (fetched with SSRF checks)."},"text":{"type":"string","maxLength":8000,"description":"Text to use instead of a URL (max 8,000 characters)."}}},"stamp":{"type":"boolean","description":"Optional. When true, mint a hash_only Notary receipt over output_sha512 (integrity, not factual truth)."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0TWviT1oiJOINdwDE6tYR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares two documents (by URL or text) and returns section-level diffs (added, removed, changed), a summary, and SHA-512 hashes of each input and the output.","exampleAgentPrompt":"Can you compare these two contract drafts and tell me what sections were added, removed, or changed? Here's the old version: https://example.com/contract-v1.pdf and the new version: https://example.com/contract-v2.pdf","exampleUseCases":[{"title":"Contract revision audit","prompt":"Compare the old vendor contract at https://legal.example.com/vendor-contract-2023.pdf with the new one at https://legal.example.com/vendor-contract-2024.pdf and tell me exactly what sections changed, what was added, and what was removed."},{"title":"Terms of service change detection","prompt":"I need to know what changed between our old terms of service and the new draft — here's the old text: 'Users agree to...' and the new one at https://example.com/tos-new.html. Can you give me a section-by-section breakdown of the differences?"},{"title":"Policy document diff with integrity stamp","prompt":"Compare these two policy documents — https://docs.example.com/policy-v1.txt and https://docs.example.com/policy-v2.txt — and also mint a notary receipt over the output so I have a tamper-proof record of the comparison."}],"resultDescription":"A structured diff containing section-level lists of added, removed, and changed items between the two input documents; a short natural-language summary of the differences; SHA-512 hashes of each input document; and a SHA-512 hash of the output itself. If the stamp flag is true, a hash_only Notary receipt over the output hash is also included. Identical or unreadable inputs are rejected before payment is processed.","failureModes":["Identical inputs rejected before payment — returns an error indicating documents are the same","Unreadable or inaccessible URLs rejected before payment","URL fetch blocked by SSRF checks if internal/private addresses are targeted","Text input exceeding 8,000 characters rejected","Missing both url and text for either document a or b","Network errors fetching remote URLs returning a fetch failure response"],"whenToPreferThis":"Use this endpoint when an AI agent needs to perform a structured, section-level comparison of two documents (legal contracts, policy docs, terms of service, reports) provided either as URLs or raw text, and needs a machine-readable diff rather than a simple similarity score. It is especially valuable when you also need cryptographic integrity verification (SHA-512 hashes) or a notary stamp on the result. Prefer this over generic LLM summarization when auditability, determinism, and structured diff output matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-20T12:30:10.758Z","isFirstParty":false,"canonicalSlug":"ysaere-agent-compare-documents-26974afd"}