FindA.Sale

sale.finda由 finda.sale 發布官方發布者v2.0.0更新於 Oct 24, 2026

Find yard sales, garage sales, auctions, flea markets and resale shops, and search items for sale.

已驗證Streamable HTTP可網頁執行位置與生活商業與電商

概覽

AI 產生的概覽

FindA.Sale 讓助理搜尋公開的庭院二手拍賣、車庫拍賣、整屋出清與拍賣會，以及其中的待售物品，並提供每個拍賣頁面的連結。

可以做什麼
依關鍵字、城市、郵遞區號、地圖點、日期範圍或拍賣類型搜尋與瀏覽拍賣活動，包括熱門拍賣與即將開始的拍賣，並列出城市、拍賣類型與物品分類及數量。取得單一拍卖的日期、城市、大致位置、描述、照片、主辦人名稱與評分，以及最多 25 件待售物品。依關鍵字搜尋待售物品，可依分類、狀況、價格區間與城市篩選，或跨目前拍賣尋找某件特定想要的物品。取得單一物品的標題、描述、價格、狀況、照片及其所屬拍賣。
適用情境
適合回答本週末或某城市附近有哪些拍賣活動，或想從目前公開拍賣中尋找某件二手物品（例如家具、收藏品或工具）的情境。
執行需求
遠端 streamable HTTP 端點；未宣告用戶端需要身分驗證、API 金鑰或環境變數。需要能連線至該端點的網路。
安裝前請注意
所有工具皆為唯讀，結果從不包含街道地址，座標約精確至 1 公里。買家須開啟拍賣連結並登入，才能在拍賣開始前一天看到地址。設有依 IP 與依工具的速率限制。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 FindA.Sale，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/sale.finda%2Ffindasale/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "finda-sale": {
      "type": "http",
      "url": "https://mcp.finda.sale/mcp"
    }
  }
}

README

FindA.Sale MCP Server

Public, read-only Model Context Protocol server for finding sales and items on FindA.Sale. Built on the official TypeScript MCP SDK v2 (@modelcontextprotocol/server 2.3.x, MCP spec 2026-07-28).

Production: https://mcp.finda.sale (Railway service findasale, project keen-wisdom, root directory packages/mcp-server, Dockerfile.production, auto-deploys on pushes to main that touch packages/mcp-server/**).

Endpoints

PathPurpose
POST /mcpStreamable HTTP transport, stateless. Serves 2026-07-28 clients and 2025-era clients (stateless fallback). GET/DELETE answer 405.
GET /sse + POST /messages?sessionId=…Legacy HTTP+SSE transport (deprecated in the spec, kept for existing clients) via @modelcontextprotocol/server-legacy/sse.
POST /messages (no sessionId)Sessionless JSON-RPC shim kept from v1: initialize, ping, tools/list, tools/call.
GET /mcp/server-cardMCP Server Card (application/mcp-server-card+json). Alias: /.well-known/mcp/server-card.json.
GET /.well-known/ai-catalog.jsonAI Catalog linking the Server Card.
GET /.well-known/mcp.jsonInformal manifest (also mirrored at finda.sale/.well-known/mcp.json).
GET /healthRailway health check.

Tools

All ten tools are read-only (readOnlyHint: true, destructiveHint: false, idempotentHint: true). Schemas live next to each tool in src/tools/*.ts (zod v4); handlers in src/handlers.ts.

search_sales, get_sale, search_items, get_item, list_cities, list_sale_types, list_categories, get_trending_sales, get_sales_starting_soon, find_item_for_sale.

Privacy and safety rules

  • The backend is always called anonymously (no auth header is ever sent or forwarded), so its public-viewer rules apply: DRAFT/CANCELLED/deleted sales 404, early-access and Legendary items stay embargoed, street addresses are withheld.
  • Every response is rebuilt from an allow-list in src/lib/publicShape.ts. Street address, entrance pin, approach notes, organizer phone/address/user id, payment processor ids and scrape metadata are never returned. Coordinates are rounded to 2 decimals (about 1 km).
  • Backend errors are mapped to short generic messages.

Rate limits and caching

  • Per IP: 120 MCP HTTP requests per minute (RATE_LIMIT_MAX_REQUESTS), plus per-tool limits (10 to 40 per minute) in src/lib/rateLimiter.ts.
  • Legacy SSE: at most 10 open sessions per IP and 300 total; sessions close after 1 hour.
  • Backend GET responses are cached in memory (60 s for searches, 10 min for cities/categories, 30 min for sale summaries used by city-filtered item search).

Configuration

See .env.example: BACKEND_URL, PORT (3003), MCP_PUBLIC_ORIGIN, RATE_LIMIT_MAX_REQUESTS, NODE_ENV.

Local run

bash
npm installnpm run buildBACKEND_URL=https://api.finda.sale PORT=3003 npm start

Try it with the MCP Inspector (npx @modelcontextprotocol/inspector) against http://localhost:3003/mcp.

Registry

Official MCP Registry name: sale.finda/findasale (DNS-authenticated namespace for finda.sale). Submission steps: claude_docs/operations/mcp-registry-submission-2026-10-23.md.

來源：packages/mcp-server/README.md，提交 6850444

工具

10

search_sales

Search Sales

Find current public sales (yard and garage sales, whole-house sales, auctions, flea markets, shops) by keyword, city, ZIP, map point, date range or sale type. Returns sale summaries with approximate location and a link to each sale page. Street addresses are never included.

輸入參數latlngzipcitylimitqueryendDateradiusKmsaleTypestartDateminConfidence

get_sale

Get Sale Details

Get one public sale: dates, city, approximate location, description, photos, organizer name and rating, and up to 25 available items. Street addresses are never included; the sale page shows them to signed-in shoppers from the day before the sale.

輸入參數saleId必填

search_items

Search Items

Search items listed for sale across current public FindA.Sale sales by keyword, with optional category, condition, price range and city filters. Returns item title, price, condition, photos and links to the item and its sale.

輸入參數citylimitquery必填sortBycategorypriceMaxpriceMincondition

get_item

Get Item Details

Get one publicly listed item: title, description, price, condition, photos, and the sale it belongs to (title, city, dates, link).

輸入參數itemId必填

list_cities

List Cities

List cities with current public sales on FindA.Sale, busiest first, with active sale counts and a browse link for each city. Filter by state to narrow the list.

輸入參數limitstate

list_sale_types

List Sale Types

List the sale type codes FindA.Sale uses (yard sale, whole-house sale, auction, flea market, shop, dorm move-out) with a short description of each.

無需輸入參數。

list_categories

List Categories

List item categories that currently have items for sale, with item counts. Use a name from this list as the category filter in search_items.

無需輸入參數。

get_sales_starting_soon

Get Sales Starting Soon

List public sales starting in the next few days (default 7, max 14). Good for "what sales are this weekend near X" questions.

輸入參數citysaleTypedaysAhead

find_item_for_sale

Find Item For Sale

Find a specific thing someone wants to buy (furniture, a collectible, a tool) across current public sales, optionally in one city and price range. Returns up to 10 matches with links to cite.

輸入參數cityquery必填maxPriceminPrice

版本歷史

1
  1. v2.0.0最新Oct 24, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。