Irisches Kleinanzeigen-Toolkit (Daft + Adverts)

Bun-Monorepo: inoffizielle HTTP-Clients und MCP-Server für zwei irische Websites —

Nicht mit Distilled Media, Daft oder Adverts verbunden. Protokolle und Datenstrukturen stammen aus den Android-Apps.

Haftungsausschluss

Dieses Repository wurde vollständig von KI-Code-Agenten unter menschlicher Anleitung geschrieben. Experiment / persönliches Werkzeug — kein unterstütztes Produkt.

• Keine Garantie — Korrektheit und API-Kompatibilität sind nicht garantiert; die vorgelagerten Apps ändern sich.

• Die Tests sind minimal — behandeln Sie einen grünen Testlauf nicht als produktionsreif.

• Nutzung auf eigene Gefahr. Respektieren Sie die ToS und Ratenlimits; scrapen Sie nicht, spammen Sie nicht und missbrauchen Sie keine Konten.

Related MCP server: Bazos-MCP

Pakete

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)

Schichten:

  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)

Schnellstart

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

Nutzung der Bibliothek

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 über HTTP (beide Tools, ein Prozess) — bevorzugt für Multi-Client-Setups:

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

Docker: siehe packages/mcp-host.

MCP stdio (ein Server pro Prozess)

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

Anbindung: .cursor/mcp.json, opencode.json und packages/mcp-host/README.md.

Umgebung

Gemeinsame .env im Wurzelverzeichnis (gitignored). Grobe Aufteilung:

Tokendateien nach dem Login: .daft-tokens.json, .adverts-tokens.json (mit *_TOKEN_FILE überschreibbar).

Sie können nur Daft, nur Adverts oder beide ausführen — ungenutzte Schlüssel werden einfach nicht verwendet.

Tests

Pro Paket (bun test in dem jeweiligen Ordner). Die Abdeckung ist bewusst dünn; siehe Haftungsausschluss.

Lizenz

MIT (sofern ein Paket nichts anderes angibt).