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 分

    请在仓库或注册中心条目中声明许可证。