VerifiedPricing

VerifiedPricing Agent 客户端

用于价格快照、来源引用、比较和明确研究请求的 Python REST 客户端、命令行工具和 MCP 工具。

v0.3.2 套件将 verifiedpricing-client 0.1.3 与 verifiedpricing-mcp 0.3.2 配套使用。命令行工具和本地 stdio 支持 Linux 和 macOS 上的 Python 3.10+。可自托管的 HTTP 扩展要求 Python 3.11+。 连接托管端点无需安装 Python。

开始使用

在 VerifiedPricing 账户创建自己的密钥。 账户表单最初会选择 prices:read 和 comparisons:read； 创建 API 密钥时如果未指定作用域，默认仅使用 prices:read。如果要提交定价研究请求，请添加可选的 coverage:request 作用域。 请将密钥保存在私密的环境变量或凭据存储中；不要将其放入命令参数、URL、工具参数或公开配置中。

套件 v0.3.2 使用以下 wheel 文件名：

• verifiedpricing_client-0.1.3-py3-none-any.whl
• verifiedpricing_mcp-0.3.2-py3-none-any.whl

从发布资源中下载这两个 wheel 和 SHA256SUMS，验证其校验和，然后在隔离环境中安装：

sha256sum -c SHA256SUMS
python3 -m venv ~/.venvs/verifiedpricing-agent
~/.venvs/verifiedpricing-agent/bin/python -m pip install \
  ./verifiedpricing_client-0.1.3-py3-none-any.whl \
  ./verifiedpricing_mcp-0.3.2-py3-none-any.whl

在 macOS 上，使用 shasum -a 256 -c SHA256SUMS。REST 客户端使用 Python 标准库；MCP 软件包会安装固定版本的官方 SDK mcp==2.3.0 及其依赖项。使用 verifiedpricing 或将 verifiedpricing-mcp 配置为本地 stdio 服务之前，请先激活该环境。

托管 MCP

连接支持 Streamable HTTP 的客户端，访问 **https://verifiedpricing.com/mcp**。 在 Authorization: Bearer YOUR_VERIFIEDPRICING_API_KEY 中发送个人读取密钥。 请将真实密钥保存在客户端的私密密钥或环境设置中；切勿将其放入 URL 或公开配置文件。以下 JSON 展示了接受 mcpServers HTTP 配置的客户端所用的格式；不同客户端对密钥替换的支持各异。

{
  "mcpServers": {
    "verifiedpricing": {
      "type": "http",
      "url": "https://verifiedpricing.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_VERIFIEDPRICING_API_KEY"
      }
    }
  }
}

托管端点使用同一个人账户的额度。其 MCP Registry 条目，元数据版本 0.3.2 记录了服务端点。连接时，请使用正在运行的服务返回的工具列表。本地 0.3.2 软件包提供以下 11 个工具。

十一个 MCP 工具

search_products、get_prices、get_price、compare_prices、 get_competitor_prices、get_price_history、get_sources、 get_reviewed_records、get_usage、request_price_coverage、 get_price_coverage_request。

覆盖范围工具要求 API 已启用覆盖请求功能。 request_price_coverage 是可选的写入工具。它要求 coverage:request、明确设置 consent: true，以及产品 ID 或规范域名。新的域名还需要指定受支持的类别。重复提交相同请求会返回原始 ID；请使用 get_price_coverage_request 跟踪其状态。 即使缺少覆盖范围，价格查询仍然是读取操作。

REST、命令行工具和 MCP 共用同一账户额度：免费额度为每天 1,000 个加权单位、每月 10,000 个。 get_usage 会返回账户限额和剩余额度。新密钥或 MCP 会话不会重置额度。

有来源支持的结果

客户端 0.1.3 和 MCP 0.3.2 会在人类可读的输出中保留目录来源、金额支持情况、比较资格、条件、计费信息和提供方检索日期。 目录条目带有“自动定价来源”标签。

响应会保留快照 ID、来源 URL、观察和审核日期、新鲜度、完整性及比较资格。当自动观察记录与人工审核记录时，会分别使用不同标签。如果输入需要更多上下文，比较结果会保留 not_comparable 及其原因。

许可证和数据条款

客户端和网关代码采用 MIT 许可证。版权所有 (c) 2026 VerifiedPricing 贡献者。复制或大段使用本软件时，请附上 LICENSE 中的版权声明和许可声明。

代码许可证不涵盖服务数据或引用的供应商内容。 服务条款规定了 API 的使用和数据再利用；请保留引用、快照 ID、原始日期和返回的信任字段。