商户披露信号查询服务

一个用于查询商户通过Disclose协议发布的运营信号(如退货率、履行准确率、拒付比率等)的MCP服务器,支持AI代理直接查询数据。

  • by disclose-framework
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 disclose-framework/disclose-mcp-server

使用说明

披露MCP服务器

MCP服务器,用于查询通过以下方式发布的商家披露信号 披露.

它的作用

商家发布运营信号——退货率、履约准确性、退款率——以及允许的使用条款。此MCP服务器允许任何AI代理直接查询该数据。

服务器按顺序检查四条发现路径:

  1. /.well-known/disclose --规范路径
  2. /.well-known/disclose.json --具有显式扩展的规范路径
  3. /disclose.json --不支持Shopify等托管平台的回退 /.well-known/ 目录
  4. 页面中的JSON-LD块 <head> --适用于使用脚本标签注入的商家

来源于Shopify API并由Sure Signal计算的信号返回完整的出处元数据: source, reported_by, computed_by, attestation_level,以及 attestation.证明是 null 直到第三方签名者(如循环返回)对信号进行加密签名。

可用工具

get_merchant_disclosure(domain)

从商家的域名中获取其发布的披露信号。返回商家选择发布的所有信号,包括来源元数据,如果没有发现披露,则返回错误。

例子: get_merchant_disclosure("example.com")

check_signal_coverage(domain)

返回七个Sure Signal V1信号的结构化覆盖报告:哪些存在,哪些缺失,是否有携带证明,以及总体覆盖百分比。对于代理商在做出购买决策之前评估商家数据的完整性非常有用。

七个V1信号:

  • product_return_rate
  • on_time_shipment_rate
  • refund_processing_time_median_days
  • chargeback_rate
  • dispute_win_rate
  • platform_seller_tenure_days
  • order_accuracy_rate

例子: check_signal_coverage("example.com")

设置

先决条件

  • Python 3.10或更高版本
  • 紫外线 包管理器

安装

  1. 克隆此存储库: