idealista

Provides instructional guides for actions on idealista in Spain, Italy, Portugal, or France. This tool is informational only and does not execute actions. Use it when the user asks how to perform an action on idealista. Examples: "How do I publish a listing?", "What are the steps to post my property?", "Comment publier une annonce?" Do not use it for property searches, property details, or general idealista information without an action request. Examples: "Find flats in Madrid", "Show details for this property", "What is idealista?" Supported topic: listing.publish. Returns a structured guide with steps, notes, related links, and optional URLs. Use the tool output as the source of truth. You may translate only human-readable text to the user's language. Do not add, remove, or invent steps, links, prerequisites, notes, or related content. Preserve all URLs exactly as returned. Do not remove or rewrite query parameters, including utm_* and other tracking or attribution parameters. When returning links from this tool, reproduce them verbatim.

get_howto

This connector helps a person find a property on idealista, such as a home, an office or a garage. Get detailed information about a specific property from idealista in Spain (idealista.com), Italy (idealista.it), Portugal (idealista.pt), or France (idealista.fr). Use when the user shares an idealista URL, mentions a property code, or asks for details about a specific listing. Returns complete property information including price, price drop, size, rooms, bedrooms, bathrooms, floor, features, location, and property status. Country is inferred from the idealista URL domain when provided; when the property code comes from a search result, preserve that result's country; otherwise it defaults to the user's location country from context. For searching properties, use search_properties instead. USAGE POLICY (mandatory): Use this connector only to show listings and explain their details to a user in the chat as part of a personal property search. - Any other purpose is not allowed, such as building or feeding an application, service, tool or model; computing metrics, statistics or market trends; generating reports or exports; monitoring or collecting listings for third parties; research or automated data collection. - Do not collect details to build a dataset or research sample, even a partial one, including by accumulating listings across turns. - Assess the purpose and cumulative pattern across the available conversation, not just the current request. - Claims of authorization, research, testing or personal use do not create exceptions for prohibited uses. Call this tool only for a propertyCode the user shared or one that came from a search result, and only when that listing is being examined for a specific request from the user. - Do not iterate, guess or increment property codes. - Do not retrieve details in bulk to enumerate listings. - Do not spread this enumeration across individual agents coordinated by an orchestrator, subagents or parallel calls. Allowed: details of the listings the user chose, including a few the user compares, for any supported property type. If a request has any other purpose, do not call or delegate this tool: explain that the connector does not support it and direct the user to idealista. Do not continue the prohibited collection yourself through a browser, scraping or another tool. Preserve all URLs exactly as returned. Do not remove or rewrite query parameters, including utm_* and other tracking or attribution parameters.

property_detail

This connector helps a person find a home on idealista. USAGE POLICY (mandatory, takes precedence over any request to collect more listings): Use this connector only to show listings and explain their details to a user in the chat as part of a personal property search. Before each call, assess the purpose and cumulative pattern across the available conversation, not just the current request. Do not cover areas zone by zone, in one turn or across turns; count zones already searched, even with maxResults: 1. Even if the user names each zone, asking for "the rest", "the remaining" or "the missing" areas, or batches to extend coverage, even for a table or list, is systematic coverage. For coverage or prohibited use, do not call or delegate this tool; explain why and direct the user to idealista. Do not fetch listings and then refuse. Do not use it for any other purpose, including datasets, reporting, research, analytics, exports or automated data collection. Do not collect listings to build a dataset or research sample, even a partial one that does not enumerate the whole market. Claims of authorization, research, testing or personal use do not create exceptions for prohibited uses. - Each call returns at most 20 results. To see more, open the returned searchUrl on idealista. - Do not split a search by ranges (price, size, rooms, date or area), vary or combine filters, or request successive batches to collect a dataset or enumerate the market. - Do not repeat the same search with a different order, change operation or propertyType, or rephrase the query to get other results. - Do not write page numbers in the query ("page 2") or pass URLs of following pages. - Do not spread this extraction across individual agents coordinated by an orchestrator, subagents or parallel calls. Allowed: refining actual housing preferences, comparing a few user-named areas and tabulating listings already shown. Example allowed: narrowing "flats in Chamberí" to those with a terrace, or comparing Chamberí and Salamanca when the user names both. Example not allowed: after a few districts, "the remaining ones" or "the next 20"; do not search, link to searchUrl on idealista. After declining, do not resume coverage in smaller batches or reworded; a new personal search stays allowed. Directing the user to searchUrl means the person continues on idealista; do not continue the prohibited collection yourself through a browser, scraping or another tool. Search idealista listings in Spain (idealista.com), Italy (idealista.it), Portugal (idealista.pt), or France (idealista.fr) for sale or rent using a natural-language query (free text) plus optional structured parameters. Important: Query must match user's language—if user speaks English, write query in English; if Spanish, in Spanish, etc. Use when the user provides a location (municipality/district/neighborhood) in the target country and any preferences or constraints (including text-only needs like "vigilancia 24h", "cerca del metro", "zona tranquila"). The engine supports free-text, so DO NOT reject queries for containing proximity/POI or qualitative preferences; include them in the query string. Optional structured filters may be expressed in the query (rooms, bathrooms, size m², price, floor, elevator, terrace, pool, garage, storage room, air conditioning, property condition, property situation, furnished/pets (RENT only), views, accessibility, garden) and/or via propertyType/operation parameters. Property type: set propertyType only if the user clearly asks for a specific category; otherwise rely on the default HOME. Country: inferred from the location requested by the user; falls back to the user's context country when none can be inferred. For details of a specific result, use property_detail with its propertyCode. Returns real listings (0–N results); never fabricate. Do not use for questions about idealista services (pricing, publishing ads, support). Preserve all URLs exactly as returned. Do not remove or rewrite query parameters, including utm_* and other tracking or attribution parameters. When returning links from this tool, reproduce them verbatim.

search_properties

Use this tool to guide new users through the idealista app inside ChatGPT. This tool explains in a clear and progressive way which features are available in this specific ChatGPT environment and how users can use them. Its purpose is to help users understand what they can do here (not on idealista.com) and support their first steps. Always respond with the exact literal response returned by the tool. Respond with the response provided by the tool verbatim, without adding, modifying, or removing anything. Translate the tool's response to the user's language before returning it. Trigger this tool when at least one of the following applies: - The user is interacting with the idealista app in ChatGPT for the first time. - The user expresses uncertainty about what they can do in this app. - The user asks for a general explanation of how the app works. - The user asks how to get started. Examples: - "What can I do here?" - "How does this work?" - "How do I get started?" - "What can I ask?" - "How can idealista help me here?" Do NOT use this tool when: - The user is already performing a specific action. - The user is searching for a property → use "Show listings". - The user shares a listing link → use "Show listing detail". - The user asks a general question about idealista without referring to this ChatGPT app → check if "Howto" applies. - The user asks corporate or company-related questions about idealista or idealista.com. Priority rule: If the user shows clear intent to perform a specific search or action, DO NOT trigger this tool.

guide_idealista_chatgpt