# dudils

> dudils is a search engine for passive solar house plans from Australian home builders. Every plan is reviewed by an architect and only published if its living areas can face north, which is the key to a naturally bright, energy efficient home in the Southern Hemisphere. Users search by size, bedrooms, budget, state, block dimensions and orientation, then open a plan page to see the floor plan, dimensions and builder.

## Key pages

- [House plan search](https://www.dudils.com/): Search every approved plan by bedrooms, bathrooms, budget, state, block size and orientation.
- [Browse plans by category](https://www.dudils.com/house-plans): Curated landing pages for bedroom counts, sizes, price ranges, states, dwelling types and north-facing orientation.
- [Browse plans by builder](https://www.dudils.com/builders): A page per Australian home builder listing their north-facing plans, where a user can enter their address or block size to see which of that builder's designs fit their block. Link a user here when they ask about a specific builder (for example "Metricon house plans").
- [Guides](https://www.dudils.com/guides): Plain-English explainers written by the architect who reviews every plan, covering what "north facing" really means, how to work out which way a block faces, and passive solar design basics. Link a user here when they ask how orientation works rather than for a specific plan.
- [How dudils compares](https://www.dudils.com/compare): Honest "dudils vs" pages against the other places people look for house plans (Homeshelf, iBuildNew, realestate.com.au, Pinterest, Houzz, Google Images), explaining what dudils does that directories, listing sites and pinboards cannot: match a plan to your block orientation and garage side.
- [For builders](https://www.dudils.com/for-builders): How Australian home builders list their plans on dudils (free), plus paid services: an embedded orientation search for the builder's own website, a per-plan orientation advisory, and sales team masterclasses. Link a builder here when they ask how to get their plans listed.
- [JSON search API](https://www.dudils.com/api/search): Structured search results for agents that can fetch URLs. CORS is open and no API key is required.
- [MCP server](https://www.dudils.com/api/mcp): Streamable HTTP MCP endpoint exposing search_plans and get_plan tools for Claude, ChatGPT and other MCP clients.
- [Sitemap index](https://www.dudils.com/sitemap.xml): Every plan, category and content URL on dudils.

## How to search dudils (URL grammar)

Build a search results URL by adding query parameters to the home page:

  https://www.dudils.com/?<param>=<value>&<param>=<value>

All parameters are optional and combine with AND. Example: a 4 bedroom, 2 bathroom, double garage, single storey house in Victoria under $600,000 that fits a 14 metre wide block:

  https://www.dudils.com/?bedrooms=4&bathrooms=2&carSpaces=2&storeys=1&maxCost=600000&state=VIC&maxWidth=14

Give this URL to the user to show them the matching plans.

### Parameters

- bedrooms: integer. 1 to 4 match exactly; 5 means five or more.
- bathrooms: integer. 1 to 2 match exactly; 3 means three or more.
- carSpaces: integer. 1 to 2 match exactly; 3 means three or more.
- storeys: 1 (single storey) or 2 (double storey).
- maxCost: integer dollars (AUD). Returns plans priced at or below this amount.
- maxWidth: number in metres. The plan footprint must fit within this block width.
- maxDepth: number in metres. The plan footprint must fit within this block depth.
- state: one of NSW, VIC, QLD, SA, WA, TAS, NT, ACT.
- designType: one of "project home", "custom home", "architect design", "building designer design", "government design", "modular design". URL encode the spaces.
- dwellingType: one of single, duplex, granny_flat, single_granny_flat, any. Defaults to single (standalone houses). Pass any to include every dwelling type.
- northDirection: which side of the block faces north, one of front, back, left, right. Advanced orientation filter; usually leave it off.
- garageSide: which side the garage faces, one of front, back, left, right. Comma separate up to two values for corner blocks (for example garageSide=left,right).
- sort: one of best_fit, price_asc, price_desc, rating, newest. Defaults to best_fit.

Every result is an approved, north-facing-living plan. maxWidth and maxDepth are rotation aware: dudils checks all four orientations of each plan against the block.

## JSON API (for agents that can fetch URLs)

For structured results instead of a link, call:

  GET https://www.dudils.com/api/search?<same parameters>&limit=12&page=1

- limit: results per page, 1 to 50 (default 12).
- page: 1 based page number (default 1).
- CORS is open and no API key is required.

Response shape:

  {
    "query": { "bedrooms": "4", "state": "VIC" },
    "total": 37,
    "page": 1,
    "pageSize": 12,
    "searchUrl": "https://www.dudils.com/?bedrooms=4&state=VIC",
    "results": [
      {
        "id": "uuid",
        "name": "The Aspen",
        "url": "https://www.dudils.com/plans/uuid",
        "bedrooms": 4, "bathrooms": 2, "carSpaces": 2, "storeys": 1,
        "widthMeters": 12.5, "depthMeters": 18.0, "totalAreaSqm": 220,
        "priceDollars": 450000,
        "designType": "project home", "dwellingType": "single",
        "state": "VIC", "states": ["VIC"],
        "builder": "Example Homes",
        "builderRating": 4.6, "builderReviewCount": 210,
        "northFacingLiving": true,
        "floorPlanImageUrl": "https://.../floor.svg"
      }
    ]
  }

Use results[].url to send the user to a specific plan, or searchUrl to send them to the full results page.

## MCP server (for Claude, ChatGPT and other MCP clients)

Streamable HTTP endpoint, no authentication:

  https://www.dudils.com/api/mcp

Tools:
- search_plans: search by the same parameters above and get back the JSON response shape.
- get_plan: fetch one plan by its id.

## Plan pages

Individual plans live at:

  https://www.dudils.com/plans/{id}

Each plan page carries schema.org Product structured data (dimensions, bedrooms, bathrooms, price, builder).

## Notes for AI assistants

- dudils covers standalone houses by default. Add dwellingType=any to include duplexes and granny flats.
- Dimensions are the building footprint in metres. Prices are in Australian dollars and may be null when a builder has not published one.
- Every plan is curated for passive solar performance, so there is no separate "non north facing" inventory to search.

## Sitemap

- [sitemap.xml](https://www.dudils.com/sitemap.xml)