Search apartments by structured filters.

Returns a list of apartments matching the given criteria. Use this for precise filtering by price, rooms, area, district, etc. For free-text queries like 'cozy apartment near park', use semantic_search instead.

Search apartments by natural language query using semantic/vector search.

Examples: 'уютная квартира с видом на горы рядом с метро', 'большая квартира с евроремонтом в центре'. Optionally filter by city, max price, or room count.

Get full details for a specific apartment by its source_id (e.g. 'krisha:1013405508').

Returns all available fields including LLM analysis, price history, and photos.

Run LLM analysis on a specific apartment.

Scores the apartment 0-10 based on price/quality ratio, condition, location, and other factors. Returns score, pros, cons, and summary. Forces re-analysis even if already analyzed.

Download apartment photos locally so the AI agent can inspect them.

Returns the absolute paths of the downloaded images. You (the AI) can then use your view_file tool on these paths to visually analyze the apartment.

Get top-rated apartments sorted by LLM score.

Returns the highest-scored apartments, optionally filtered by city, rooms, or price. Only returns apartments that have been analyzed.

Get apartments discovered in the last N hours (default: 24).

Shows the most recent apartments sorted by score.

Compare 2-5 apartments side by side.

Provide a list of source_ids to compare their key characteristics.

Get price change history for an apartment.

Create a search profile for ongoing apartment monitoring.

The profile defines filters and preferences. The ingestion pipeline will use these profiles to fetch new apartments and send notifications.

List all active search profiles.

Delete a search profile by ID.

Show apartments matching a search profile, ranked by semantic similarity.

Uses the profile's hard filters (price, rooms, polygon) AND the nl_description for semantic re-ranking via ChromaDB vector search. Pass hours=0 to return all stored apartments for this profile (no time filter).

Run the data ingestion pipeline.

Fetches new apartments from all sources for the specified profile (or all active profiles if none specified), analyzes them, and sends notifications. This may take several minutes depending on the number of pages to scrape.

Get statistics about the apartment database.

Shows total apartments, new apartments, analyzed count, average prices, scores, etc.