360 Secure SkillHub
360 安全技能中心

Idealista Cli

该 Skill 是 idealista CLI 的使用说明，支持按城市、城镇、区域或街道检索 Idealista 房源，支持地区建议查询、房源搜索（含价格、面积、卧室、排序等筛选项）、按广告 ID 获取房源详情，并可用 --json 输出结构化结果供脚本处理。

pjtf93
pjtf93
热度 77.55
最近更新 2026-05-11 15:50:52
分类：搜索依赖：代码执行 / 第三方 API应用场景：推荐

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add idealista-cli
Metadata
name
idealista-cli
description
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.
compatibility
Requires idealista-cli installed (Node.js 18+), network access to app.idealista.com.
license
MIT
metadata
{"author":"pjtf93","version":"0.1.0"}

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.