Инструментарий ирландских досок объявлений (Daft + Adverts)

Bun-монорепозиторий: неофициальные HTTP-клиенты и MCP-серверы для двух ирландских сайтов —

Не аффилирован с Distilled Media, Daft или Adverts. Протоколы и структуры данных взяты из Android-приложений.

Отказ от ответственности

Этот репозиторий написан полностью ИИ-агентами кодирования под руководством человека. Эксперимент / личный инструмент — не поддерживаемый продукт.

• Без гарантий — корректность и совместимость API не гарантируются; исходные приложения меняются.

• Тесты минимальны — не считайте зелёный прогон тестов признаком готовности к продакшену.

• Используйте на свой страх и риск. Соблюдайте условия использования и лимиты запросов; не скрейпите, не спамьте и не злоупотребляйте аккаунтами.

Related MCP server: Bazos-MCP

Пакеты

packages/
  daft-api/       @daft-ie/api          HTTP client → gateway.daft.ie / auth.daft.ie
  daft-mcp/       @daft-ie/mcp          MCP tools (stdio) over daft-api
  adverts-api/    @adverts-ie/api       HTTP client → new.api + api.adverts.ie
  adverts-mcp/    @adverts-ie/mcp       MCP tools (stdio) over adverts-api
  mcp-host/       @daft-ie/mcp-host     one Fastify process: both MCPs over HTTP (+ Docker)

Слои:

  Cursor / OpenCode / Hermes / your code
            │
            ├─ stdio ──► daft-mcp ──► daft-api ──► Daft
            ├─ stdio ──► adverts-mcp ──► adverts-api ──► Adverts
            └─ HTTP  ──► mcp-host ──► both MCP servers (shared process)

Быстрый старт

bun install
cp .env.example .env   # fill DAFT_* and/or ADVERTS_* as needed

Использование библиотеки

import { DaftApi } from "@daft-ie/api";
import { AdvertsApi } from "@adverts-ie/api";

const daft = new DaftApi({ platform: "android", appVersion: "9.8.1" });
const adverts = new AdvertsApi();

MCP через HTTP (оба инструмента, один процесс) — предпочтительно для мультиклиентских конфигураций:

bun packages/mcp-host/src/index.ts
# http://127.0.0.1:3100/mcp/daft
# http://127.0.0.1:3100/mcp/adverts

Docker: см. packages/mcp-host.

MCP stdio (один сервер на процесс)

bun packages/daft-mcp/src/index.ts
bun packages/adverts-mcp/src/index.ts

Подключение: .cursor/mcp.json, opencode.json и packages/mcp-host/README.md.

Окружение

Общий корневой .env (в gitignore). Примерное разделение:

Файлы токенов после входа: .daft-tokens.json, .adverts-tokens.json (переопределяются через *_TOKEN_FILE).

Вы можете запускать только Daft, только Adverts или оба — неиспользуемые ключи просто не используются.

Тесты

Для каждого пакета (bun test в соответствующей папке). Покрытие намеренно минимальное; см. отказ от ответственности.

Лицензия

MIT (если в пакете не указано иное).