Skip to main content
Glama
daft-adverts-mcp

daft-adverts-mcp

by lortonx

아일랜드 중고거래 툴킷 (Daft + Adverts)

Bun 모노레포: 아일랜드 두 사이트를 위한 비공식 HTTP 클라이언트 및 MCP 서버 —

사이트

도메인

초점

Daft.ie

부동산

매매 / 임대 / 쉐어 검색, 매물 상세, Keycloak 인증

Adverts.ie

마켓플레이스

광고 검색, 정제/패싯, 광고 상세, 선택적 계정

Distilled Media, Daft, Adverts와 제휴 관계가 아닙니다. 프로토콜과 구조는 Android 앱에서 비롯되었습니다.

고지 사항

이 저장소는 인간의 지시에 따라 AI 코딩 에이전트에 의해 전적으로 작성되었습니다. 실험 / 개인 도구 — 지원되는 제품이 아닙니다.

  • 보증 없음 — 정확성과 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)

패키지

README

제공 내용

@daft-ie/api

packages/daft-api

DaftApi: 주거/상업/신축 주택 검색, 지리 헬퍼, 매물 상세, 저장된 광고/검색, 받은 편지함, Keycloak 로그인 + 갱신 로테이션

@daft-ie/mcp

packages/daft-mcp

에이전트 도구: search_for_sale / for_rent / sharing, get_property, autocomplete, resolve_area, 선택적 auth_*

@adverts-ie/api

packages/adverts-api

AdvertsApi: 레거시 search.json 탐색 + 패싯/위치; 최신 advert/{id}, 계정, 미디어, 광고 등록 인터페이스; 앱 열거형

@adverts-ie/mcp

packages/adverts-mcp

에이전트 도구: search_ads, 정제/가격 패싯, 카운티/지역, get_ad, 발견/구성, 선택적 auth_*

@daft-ie/mcp-host

packages/mcp-host

Streamable HTTP: /mcp/daft, /mcp/adverts, /health; Cursor / OpenCode / Hermes / 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();

HTTP를 통한 MCP (두 도구, 단일 프로세스) — 다중 클라이언트 설정에 권장:

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_CLIENT_ID, DAFT_REFRESH_TOKEN, DAFT_ACCESS_TOKEN, …

@daft-ie/api / @daft-ie/mcp

ADVERTS_NEW_API_KEY, ADVERTS_OLD_API_KEY, ADVERTS_ACCESS_TOKEN, …

@adverts-ie/api / @adverts-ie/mcp

HTTP_PROXY

두 API 모두를 위한 선택적 아웃바운드 프록시

TS_AUTHKEY

Docker mcp-host Tailscale → Pi 출구 노드

MCP_HOST, MCP_HOST_PORT

@daft-ie/mcp-host

로그인 후 토큰 파일: .daft-tokens.json, .adverts-tokens.json (*_TOKEN_FILE로 재정의).

Daft만, Adverts만, 또는 둘 다 실행할 수 있습니다 — 사용하지 않는 키는 그냥 사용되지 않습니다.

테스트

패키지별 (해당 폴더에서 bun test). 커버리지는 의도적으로 얇습니다; 고지 사항 참조.

라이선스

MIT (패키지에 다른 명시가 없는 한).

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that enables interaction with the Daft.ie API for searching rental properties and retrieving detailed information about specific rental listings.
    10
    ISC
  • A
    license
    A
    quality
    B
    maintenance
    MCP server for interacting with Bazos.cz, Bazos.sk, Bazos.at, and Bazos.pl. Supports searching ads, retrieving ad details, and fetching user ratings.
    3
    63 npm
    4
    AGPL 3.0
  • A
    license
    A
    quality
    D
    maintenance
    MCP server that enables AI assistants to search Irish property listings on Daft.ie via the daftlistings library.
    5
    MIT
  • A
    license
    Not graded
    quality
    F
    maintenance
    MCP server to search tutti.ch Swiss classifieds anonymously with tools for listings, categories, and localities. Supports both MCP clients and a JSON CLI.
    9 npm
    MIT