Govauctions

GovAuctions MCP サーバー

GovAuctions.app は、政府余剰品オークションを探せる無料の公開サイトです。GSA やその他の政府系販売者による出品中のリストと、同等のロットが実際にいくらで落札されたかを確認できます。このリポジトリはその MCP サーバーであり、エージェントやコードから同じデータにアクセスするためのもう一つの入り口です。

政府余剰品オークションデータをエージェントから呼び出せるツールです。出品中のリストを検索し、米国、英国、カナダ、オーストラリアの政府オークションで落札された17万件以上の実データから類似品の落札価格を取得し、サイトと同じエンジンを使って0〜100の Flip Score 再販シグナルを取得できます。

ツール

ホスト型サーバーには、すべて読み取り専用のツールが8つあります。ローカルの npm パッケージで利用できるのは最初の4つです。

ツール	内容
search_listings	GSA の連邦余剰品の出品中リストを検索します（事実情報のみ）。州、カテゴリ、キーワード、価格で絞り込めます。
get_listing	ID を指定して、出品中の GSA リストを1件取得します。
get_sold_comps	説明した品目について、米国、英国、カナダ、オーストラリアの政府余剰品市場での落札価格帯（25パーセンタイル／中央値／75パーセンタイル）を取得します。
get_flip_score	リストの再販シグナルである Flip Score を取得します。推定価値、実質入札額、割引率が含まれます。
get_sold_history	類似品の価格データの根拠となる、個別の過去の落札情報を取得します。
get_price_trend	説明した品目について、月ごとの落札価格の推移を取得します。
get_comp_coverage	カテゴリと市場ごとに、価格を算出できるものとできないものを確認します。
get_api_usage	月間利用枠に対する API キーの使用状況を確認します。

API キーは https://govauctions.app/developers で取得できます（無料プランあり）。

利用方法（2通り）

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 を追加できないクライアント向けです。REST Data API を利用する依存関係のない Node ラッパー（Node 18 以降）で、npm に govauctions-mcpとして公開されています。

{
  "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を参照してください。