Live Listing Proof

Verifique listagens públicas de marketplaces, varejo, classificados e leilões antes que um agente dependa delas; retorne fatos apoiados por fontes ou estados explícitos de falha segura.

Ver em skowronworks.com

Documentação

Live · $0,02 USDC · Base mainnet

Verifique uma listagem pública antes que um agente dependa dela.

O Live Listing Proof inspeciona uma página de listagem pública e informa se uma afirmação fornecida é atualmente suportada. Use-o antes de um agente recomendar um produto, citar uma listagem, alertar um usuário, confiar em um resultado classificado ou de leilão, ou agir com base em um preço anunciado que pode estar desatualizado.

Chame-o depois de ter uma URL.

Fluxo típico: pesquise ou descubra uma listagem de terceiros e, em seguida, verifique essa URL antes de recomendar, citar ou agir. Confirme o preço anunciado, verifique se uma listagem de marketplace ainda está ativa e rejeite resultados de compras desatualizados.

  • Agentes de compras verificando uma URL de produto antes da recomendação
  • Monitores de classificados verificando se um anúncio ainda está atual
  • Agentes de leilão confirmando que um lote não foi vendido ou removido
  • Agentes de pesquisa citando apenas fatos de listagem suportados pela fonte
  • Agentes de compras verificando uma página de fornecedor ou produto antes de continuar

Não é um mecanismo de busca.

Não envie uma palavra-chave e espere resultados de produtos. Não envie uma página inicial, página de resultados de busca ou URL de documentação e espere fatos de listagem. Ele verifica uma página de listagem pública por chamada paga.

  • Não é um catálogo, fazenda de raspagem ou banco de dados de histórico de preços
  • Não substitui APIs de inventário de propriedade do comerciante
  • Não inventa título, preço ou localização quando a fonte não pode suportá-los

O que você envia e o que recebe.

Preço e rede

$0,02 USDC por verificação na Base mainnet (eip155:8453). Uma chamada paga é uma verificação ao vivo. Os resultados não são armazenados em cache como novos.

Entrada

url — página de listagem pública HTTP ou HTTPS, máximo de 2048 caracteres. claim — afirmação em linguagem natural de 3 a 2000 caracteres sobre disponibilidade, preço e/ou localização. Ambos são obrigatórios.

Saída

verdict, claim_supported, title, price, location, evidence, além de source_status e retrieval_method. Fatos opcionais são nulos quando não suportados.

Estados de falha fechada

source_status é verified, removed, blocked, unreachable, unsupported ou insufficient_evidence. Recomende ou cite apenas quando verificado e claim_supported for verdadeiro.

Como chamá-lo.

Sem chave de API. Sem conta. Descubra, chame, pague $0,02, receba um resultado. Chaves privadas nunca são necessárias nestes exemplos e nunca devem ser coladas neste site.

HTTP x402 direto

POST https://live-listing-proof.mattskowronis.workers.dev/v1/verify
Content-Type: application/json

{"url":"https://example.com/listing/123","claim":"This listing is still available at the advertised price."}

Unauthenticated request returns 402 + PAYMENT-REQUIRED.
Pay 20000 atomic USDC on eip155:8453, then retry with PAYMENT-SIGNATURE.

MCP

MCP HTTP transmissível: https://live-listing-proof.mattskowronis.workers.dev/mcp somente POST. Identificador oficial do Registro MCP: dev.workers.mattskowronis.live-listing-proof/verify-listing. Pesquisa no Registro. O Coinbase Bazaar MCP é https://api.cdp.coinbase.com/platform/v2/x402/discovery/mcp. search_resources deve passar curatedOnly: false. A pesquisa HTTP usa query, não q: verificar listagem antes da recomendação.

A2A

Agent Card: https://live-listing-proof.mattskowronis.workers.dev/.well-known/agent-card.json. JSON-RPC: POST https://live-listing-proof.mattskowronis.workers.dev/a2a. A verificação não paga retorna AUTH_REQUIRED até o pagamento x402.

JavaScript / TypeScript

const unpaid = await fetch("https://live-listing-proof.mattskowronis.workers.dev/v1/verify", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    url: listingUrl,
    claim: "This listing is still available at the advertised price.",
  }),
});
// unpaid.status === 402
const required = unpaid.headers.get("PAYMENT-REQUIRED");
// Paid path: @x402/fetch or CDP buyer SDK. Recommend only if
// result.source_status === "verified" && result.claim_supported

Python

import json
from urllib.request import Request, urlopen
VERIFY = "https://live-listing-proof.mattskowronis.workers.dev/v1/verify"
body = {"url": listing_url, "claim": "This listing is still available at the advertised price."}
req = Request(VERIFY, data=json.dumps(body).encode(),
              headers={"content-type": "application/json"}, method="POST")
# 402 is expected without an x402 payment signature.

Pseudocódigo de agente

urls = search_product(query)
for url in urls:
  result = verify_listing(url, "This listing is currently available at the advertised price.")
  if result.source_status == "verified" and result.claim_supported:
    recommend(result)
  else:
    reject(url, result.source_status)

Onde ele se encaixa em um loop de agente.

Agente de compras

Pesquisa → URLs candidatas → verificar listagem → recomendar apenas se suportado pela fonte.

Marketplace / classificados

Descobrir listagem → verificar se ainda está ativa e atual → alertar o usuário ou descartá-la.

Agente de leilão

Descobrir lote → verificar estado atual da fonte → continuar ou rejeitar um resultado vendido/removido.

Agente de pesquisa

Encontrar listagem de terceiros → verificar fatos suportados pela fonte → citar apenas se suportado.

Agente de compras

Encontrar URL de fornecedor/produto → verificar fatos públicos atuais → continuar o fluxo de trabalho.

Descoberta já ativa.

Precisa de um agente personalizado construído em torno de um trabalho como este? Agentes de IA personalizados e automação.