Govauctions

GovAuctions MCP 服务

GovAuctions.app 是一个免费的公共网站，可用于查找政府剩余物资拍卖：不仅有来自 GSA 和其他政府卖家的在售商品，还能查看同类拍品的实际成交价。本仓库是该网站的 MCP 服务，为 Agent 和代码提供另一个访问相同数据的入口。

面向 政府剩余物资拍卖数据 的 Agent 可调用工具：搜索在售商品、查询美国、英国、加拿大和澳大利亚 170,000 多场已结束政府拍卖的真实成交价对比，并获取 0–100 分的转售信号 Flip Score。这些功能与网站使用同一套引擎。

工具

托管服务提供八个只读工具。本地 npm 包提供前四个。

工具	功能
search_listings	搜索 GSA 联邦剩余物资在售商品（仅提供事实信息）。可按州、类别、关键词和价格筛选。
get_listing	按 ID 获取一条 GSA 在售商品信息。
get_sold_comps	获取所描述物品的成交价范围（第 25 百分位数／中位数／第 75 百分位数），涵盖美国、英国、加拿大或澳大利亚的政府剩余物资市场。
get_flip_score	获取商品的转售信号 Flip Score：估算价值、实际出价和折扣。
get_sold_history	获取构成对比价格数据的单笔历史成交记录。
get_price_trend	获取所描述物品逐月成交价趋势。
get_comp_coverage	按类别和市场查看哪些物品可以或无法估价。
get_api_usage	查看你的密钥对每月额度的使用情况。

可在 https://govauctions.app/developers 获取 API 密钥（提供免费额度）。

使用方式（两种）

1. 托管服务（远程），无需安装。推荐。

将支持远程 MCP 的任意客户端连接到托管的 Streamable HTTP 端点：

{
  "mcpServers": {
    "govauctions": { "url": "https://govauctions.app/api/mcp" }
  }
}

Claude Code：

claude mcp add --transport http govauctions https://govauctions.app/api/mcp \
  --header "Authorization: Bearer gak_YOUR_KEY"

托管端点上的 get_sold_comps 无需密钥即可使用；其他工具会从请求中读取你的密钥。请参阅开发者文档。

2. 通过 npx 本地运行（stdio）

适用于无法添加远程 MCP URL 的客户端。这是一个无依赖的 Node 封装程序（Node 18+），用于调用 REST Data API，并以 govauctions-mcp 为名发布到 npm：

{
  "mcpServers": {
    "govauctions": {
      "command": "npx",
      "args": ["-y", "govauctions-mcp"],
      "env": { "GOVAUCTIONS_API_KEY": "gak_your_key" }
    }
  }
}

或者下载 govauctions-mcp.mjs，并使用 node /absolute/path/to/govauctions-mcp.mjs 运行。

配置（环境变量）：

• GOVAUCTIONS_API_KEY：必需。可从 https://govauctions.app/developers/keys 获取密钥
• GOVAUCTIONS_API_BASE：可选。默认值为 https://govauctions.app/api/v1

本地封装程序会将每次调用转发到 REST API，因此与托管服务不同，它的每个工具都需要密钥，包括 get_sold_comps。

API

这些工具封装了公共 REST Data API。OpenAPI 规范： https://govauctions.app/api/v1/openapi.json

许可证

MIT，详见 LICENSE。