Kit de herramientas de clasificados irlandeses (Daft + Adverts)

Monorepo de Bun: clientes HTTP y servidores MCP no oficiales para dos portales irlandeses —

No está afiliado a Distilled Media, Daft ni Adverts. Los protocolos y los formatos provienen de las aplicaciones de Android.

Descargo de responsabilidad

Este repositorio fue escrito íntegramente por agentes de codificación de IA bajo dirección humana. Herramienta experimental / personal — no es un producto con soporte.

• Sin garantía — la corrección y la compatibilidad con la API no están garantizadas; las aplicaciones upstream cambian.

• Las pruebas son mínimas — no trates una ejecución de pruebas en verde como lista para producción.

• Úsalo bajo tu propio riesgo. Respeta los términos del servicio y los límites de peticiones; no hagas scraping, no envíes spam ni abuses de las cuentas.

Related MCP server: Bazos-MCP

Paquetes

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)

Capas:

  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)

Inicio rápido

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

Uso de la biblioteca

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 sobre HTTP (ambas herramientas, un solo proceso) — la opción preferida para configuraciones con varios clientes:

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

Docker: consulta packages/mcp-host.

MCP stdio (un único servidor por proceso)

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

Configuración: .cursor/mcp.json, opencode.json y packages/mcp-host/README.md.

Entorno

En la raíz compartida: .env (ignorado por git). Reparto aproximado:

Archivos de tokens tras el inicio de sesión: .daft-tokens.json, .adverts-tokens.json (sobrescríbelos con *_TOKEN_FILE).

Puedes ejecutar solo Daft, solo Adverts o ambos — las claves no utilizadas simplemente no se usan.

Pruebas

Por paquete (bun test en esa carpeta). La cobertura es intencionadamente escasa; consulta el descargo de responsabilidad.

Licencia

MIT (salvo que un paquete indique lo contrario).