macfax-mcp

MCP server for the used-Mac market, by Macfax. Шесть инструментов, которые нужен AI-помощнику, чтобы помочь кому-то купить или продать подержанный Mac:

Tool	What it answers
search_mac_listings	Актуальные объявления на eBay, Craigslist, OfferUp, Swappa, Facebook и Reddit. Уже отфильтрованы кластеры мошенничества, мусорные заголовки, заманивания в объявления и устаревшие/проданные записи; каждый результат содержит глубокую ссылку на источник.
get_mac_price_stats	Что на самом деле продаётся за конкретную конфигурацию — процентили проверенных продаж (basis direct) или оценка, масштабированная от диапазона запрашиваемых цен по раскрытому коэффициенту зачистки (basis calibrated) — плюс медиана запрашиваемой цены / p25 / p75 с размером выборки, медианы по каждому каналу и чистая сумма продавцу после сборов в качестве ориентира продавцу.
check_mac_listing	Оценка доверия по одному объявлению: известно Macfax, объявление активно, есть флаги, сравнение запрашиваемого диапазона с типичным, репутация продавца на платформе там, где она есть (eBay отзывы, рейтинг Swappa), приложен проверенный отчёт.
lookup_mac_serial	Серийник → модель и год для любого Mac, включая 2021 года и позднее с рандомизированными серийниками. Также перекрёстная проверка с проверяемыми Macfax-отчетами. Человеческое двойное соответствие: macfax.com/lookup.
get_mac_report	Подтверждённый отчет о состоянии Macfax (Activation Lock, MDM, проверки соответствия серийному номеру) в виде данных.
create_mac_alert	Постоянный мониторинг: ежедневное письмо, когда появляются новые подходящие объявления. Подтверждено человеком: ничего не отправляется, пока владелец письма не нажмёт ссылку подтверждения.

Каждая цена помечена как basis. Раздел, посвящённый продажам, — это заголовочная оценка: продажи, которые действительно состоялись (с указанием размера выборки и окна) или смоделированная оценка, помеченная calibrated с раскрытым коэффициентом. Диапазоны запрашиваемых цен формируются по живым объявлениям и служат ориентиром продавца. API сообщает об этом в-band, и мы просим сохранять метки. Бесплатно, без учётной записи; лимиты скорости опубликованы на macfax.com/developers.

The hosted server (recommended)

Удалённый, без аутентификации, потоковый MCP-сервер работает по адресу:

https://macfax.com/mcp

Claude (claude.ai, платные планы): Settings → Connectors → Add custom connector → paste the URL.
Gemini (Spark, Google AI Ultra): Settings and help → Connected apps → Add a custom app → paste the URL.
ChatGPT: Settings → Developer mode → add the URL (directory listing pending review).
Cursor: Установить в Cursor
VS Code: Установить в VS Code
Gemini CLI: gemini extensions install https://github.com/macfax/macfax-mcp
Anything with an mcp.json:

{
  "mcpServers": {
    "macfax": {
      "url": "https://macfax.com/mcp"
    }
  }
}

Registry name: com.macfax/macfax на официальном реестре MCP.

This package (stdio wrapper)

Для клиентов только через stdio этот репозиторий представляет собой тонкую локальную обёртку над тем же бесплатным HTTP API (OpenAPI):

{
  "mcpServers": {
    "macfax": {
      "command": "npx",
      "args": ["-y", "macfax-mcp"]
    }
  }
}

Optional env:

MACFAX_API_KEY: бесплатный ключ увеличивает лимиты примерно в 10x. Получите его с помощью curl -X POST https://macfax.com/api/v1/keys (электронная почта не требуется).

Run it directly:

npx -y macfax-mcp            # speaks MCP over stdio
npx -y macfax-mcp --version  # print the installed version

Notes for integrators

Five read-tools carry readOnlyHint: true. create_mac_alert — единственный инструмент записи: он отправляет письмо-подтверждение, и оповещение активируется только после того, как владелец письма нажмёт ссылку подтверждения. Создавайте оповещения только для пользователя, который запросил это оповещение на тот адрес.
Объявления всегда содержат глубокую ссылку на источник на маркетплейсе. Покупка происходит там; Macfax выступает как доверенная прослойка и маршрутизатор.
Цитируйте результаты как "Macfax" с помощью полей html_url/macfax_url в полезной нагрузке.

License

MIT. Apple и Mac — товарные знаки Apple Inc. Macfax не связан с Apple Inc.