# Idealista CLI

> Use the idealista CLI to search Idealista listings by location (city, town, area, street) and fetch listing details. Apply when a user asks for Idealista marketplace data or needs CLI commands/flags for idealista-cli.

- Skill: `kbarbel640-del/idealista-cli` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add kbarbel640-del/idealista-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/idealista-cli/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/kbarbel640-del/idealista-cli

---


## Purpose
Search Idealista listings and fetch listing details.

## When to use
- User wants Idealista searches by city/town/area/street.
- User needs listing detail by ad ID.
- User wants JSON output for scripting.

## Commands
### Location suggestions
```
idealista locations "<query>" --operation <sale|rent|transfer> --property-type <homes|rooms|offices|garages|land>
```

### Search listings
```
idealista search "<query>" --operation <sale|rent|transfer> --property-type <homes|rooms|offices|garages|land>
```

Optional filters:
- `--page <n>`
- `--limit <n>`
- `--min-price <amount>` / `--max-price <amount>`
- `--min-size <sqm>` / `--max-size <sqm>`
- `--bedrooms <count>`
- `--order <field>` / `--sort <order>`
- `--location-id <id>` to skip lookup

### Listing detail
```
idealista listing <adId>
```

### JSON output
Add `--json` to any command:
```
idealista search "madrid" --json
idealista listing 123456789 --json
```

## Configuration
Defaults are prefilled from APK, override via env vars if needed:
- `IDEALISTA_API_KEY`
- `IDEALISTA_SIGNATURE_SECRET`
- `IDEALISTA_OAUTH_CONSUMER_KEY`
- `IDEALISTA_OAUTH_CONSUMER_SECRET`
- `IDEALISTA_DEVICE_ID`
- `IDEALISTA_APP_VERSION`
- `IDEALISTA_BASE_URL`
- `IDEALISTA_USER_AGENT`
- `IDEALISTA_DNT`

## Output expectations
- Locations: table or JSON with `locationId`, name, type.
- Search: table or JSON with id, price, rooms, size, address, location, url.
- Listing: table or JSON with price, rooms, size, address, url, description.

## Examples
```
idealista locations "madrid" --operation sale --property-type homes
idealista search "madrid" --operation rent --property-type homes --limit 20
idealista listing 123456789
```

## Error handling
- Non-zero exit code on failure.
- For scripting, use `--json` and check exit code.