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)

包

自述文件

内容

@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

流式 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
    D
    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