### Unraid

Fredy is in the Unraid community store.
------------------------------------------------------------------------
✨ What you get
🏠 24 portals across 🇩🇪 🇦🇹 🇨🇭 🇪🇸 🇮🇹 🇵🇹: ImmoScout24, Immowelt, Kleinanzeigen, WG-Gesucht,
    willhaben, Flatfox, idealista, Subito and 16 more
⚡ Instant notifications: Slack, Telegram, Email (SMTP, SendGrid, Mailjet, Resend), ntfy,
    Discord, Mattermost, Pushover, Apprise and more
🔄 Deduplication across platforms: the same flat advertised on ImmoScout, Immowelt and
    Kleinanzeigen reaches you once, matched on living space, rooms and location rather than on the
    headline, no two portals write that the same way
🛑 Scam detection: a warning on listings that read like rental fraud,
    with your verdict always outranking Fredy's
💶 Financing calculator: which listings you can afford, for renting and
    for buying
🚆 Real travel times from your addresses by public transport, car, bike
    or on foot, plus a filter to match, and the transport network with live departures on the map
📊 Market benchmark: the price per m² of every listing against the local median, so cheap and
    expensive are facts rather than a feeling
📎 Document uploads: attach the exposé, floor plans and photos to a listing, so they survive
    the portal taking the ad down. A listing with documents is never cleaned up automatically
🖥️ Web UI in several languages, with configurable search intervals and working hours
🤖 MCP server: query your listings from Claude, ChatGPT or a local LLM
🌍 Runs anywhere: Docker, Node.js, self-hosted, and uses the reverse engineered
    ImmoScout Mobile API
------------------------------------------------------------------------
🧩 Basic architecture overview
| Concept | What it is |
|---|---|
| Provider 🌐 | A real-estate platform. You paste a search URL from the portal into Fredy, sorted by date. |
| Adapter 📡 | A kind of connection Fredy can send through (Slack, Telegram, Email, ntfy, Discord ...). You never configure one on its own. |
| Channel 🔔 | One filled-in adapter, e.g. "Telegram → family chat", saved once under Settings → Notification channels and reused in as many jobs as you like. |
| Job 📅 | Providers + channels: "search ImmoScout24 and Immowelt, send to Slack and Telegram". Runs at the interval set under Administration → Execution. |
A job can hold as many channels as you want, including several of the same type, and every new
listing goes out through all of them at once. Rotating a token means editing one channel instead of
every job that used it. Channels belong to whoever created them; an admin can share one with all
users or with admins only, which lets others send through it without ever revealing its
credentials. A channel still used by a job cannot be deleted.

subgraph group_backend["Backend runtime"] node_entry["Server entry
bootstrap
[index.js]"] node_pipeline["Job pipeline
orchestrator"] node_providers["Providers
source integrations"] node_extractor["Extraction stack
scraping services"] node_immoscout["ImmoScout path
mobile-api translator"] node_notifications["Notifications
delivery adapters"] node_storage[("SQLite storage
persistence layer")] node_api["API routes
http contract"] node_security["Security
authz/authn
[security.js]"] node_sse["SSE broker
push channel
[sse-broker.js]"] node_crons["Cron services
background tasks"] node_geocoding["Geocoding
location service"] node_listingqc["Listing QC
dedupe/quality"] end

subgraph group_frontend["Frontend app"] node_uientry["UI entry
app bootstrap
[Index.jsx]"] node_dashboard["Dashboard
admin view
[Dashboard.jsx]"] node_jobsui["Jobs UI
admin view"] node_listingsui["Listings UI
admin view"] node_adminui["Admin config
admin view"] end

subgraph group_ops["Operational surface"] node_debug["Debugging
observability"] node_mcp["MCP server
llm integration"] end

node_entry -->|"serves"| node_api node_entry -->|"starts"| node_pipeline node_pipeline -->|"pulls listings"| node_providers node_pipeline -->|"scrapes"| node_extractor node_pipeline -->|"special case"| node_immoscout node_pipeline -->|"dedupes"| node_listingqc node_pipeline -->|"persists"| node_storage node_pipeline -->|"fans out"| node_notifications node_providers -->|"uses"| node_extractor node_providers -->|"reads config"| node_storage node_notifications -->|"reads state"| node_storage node_api -->|"protects"| node_security node_api -->|"reads/writes"| node_storage node_api -->|"publishes"| node_sse node_crons -->|"enriches"| node_geocoding node_crons -->|"checks"| node_listingqc node_crons -->|"updates"| node_storage node_geocoding -->|"stores coords"| node_storage node_debug -->|"captures logs"| node_storage node_mcp -->|"queries"| node_storage node_uientry -->|"consumes"| node_api node_uientry -->|"subscribes"| node_sse node_dashboard -->|"loads"| node_api node_jobsui -->|"manages"| node_api node_listingsui -->|"queries"| node_api node_adminui -->|"configures"| node_api node_adminui -->|"shows"| node_debug

click node_entry "https://github.com/orangecoding/fredy/blob/master/index.js" click node_pipeline "https://github.com/orangecoding/fredy/blob/master/lib/FredyPipelineExecutioner.js" click node_providers "https://github.com/orangecoding/fredy/tree/master/lib/provider" click node_extractor "https://github.com/orangecoding/fredy/tree/master/lib/services/extractor" click node_immoscout "https://github.com/orangecoding/fredy/tree/master/lib/services/immoscout" click node_notifications "https://github.com/orangecoding/fredy/tree/master/lib/notification/adapter" click node_storage "https://github.com/orangecoding/fredy/tree/master/lib/services/storage" click node_api "https://github.com/orangecoding/fredy/tree/master/lib/api/routes" click node_security "https://github.com/orangecoding/fredy/blob/master/lib/api/security.js" click node_sse "https://github.com/orangecoding/fredy/blob/master/lib/services/sse/sse-broker.js" click node_crons "https://github.com/orangecoding/fredy/tree/master/lib/services/crons" click node_geocoding "https://github.com/orangecoding/fredy/tree/master/lib/services/geocoding" click node_listingqc "https://github.com/orangecoding/fredy/tree/master/lib/services/listings" click node_debug "https://github.com/orangecoding/fredy/tree/master/lib/services/debug" click node_mcp "https://github.com/orangecoding/fredy/tree/master/lib/mcp" click node_uientry "https://github.com/orangecoding/fredy/blob/master/ui/src/Index.jsx" click node_dashboard "https://github.com/orangecoding/fredy/blob/master/ui/src/views/dashboard/Dashboard.jsx" click node_jobsui "https://github.com/orangecoding/fredy/tree/master/ui/src/views/jobs" click node_listingsui "https://github.com/orangecoding/fredy/tree/master/ui/src/views/listings" click node_adminui "https://github.com/orangecoding/fredy/tree/master/ui/src/views"

------------------------------------------------------------------------

📚 Going deeper

| Topic | What is in there | |---|---| | Providers & scraping | All 24 providers, the Immoscout / idealista / Casa.it specifics, and residential proxies for when a VPS gets blocked | | Scam detection | The signals, their weights, the languages, and how to overrule Fredy | | Financing calculator | Rent and Annuitätendarlehen, Kaufnebenkosten, Restschuld, the 35 % rule | | Travel time & public transport | Addresses and place types, estimated vs exact, route drawing, departure boards, operator settings | | MCP server | Connecting Claude, ChatGPT or a local LLM to your listings | | Reverse proxy sign-in | Forward auth with Authelia, Authentik, oauth2-proxy, Traefik, Pangolin | | Debug bundles | Capturing logs for a bug report | | Development | Dev mode, tests, fixtures, adding a language | | Contributing | Writing a provider or a notification adapter |

🤖 MCP Server

Since V20, Fredy ships a built-in MCP Server, so you can connect it to Claude, ChatGPT or a local model (LM Studio) and query your real estate data in natural language. A local LLM can even enrich existing listings by checking them online. Setup: MCP Readme.

------------------------------------------------------------------------

📊 Analytics