idealista
بواسطة quifago
Shopping & E-commerceموجز
Query Idealista API via idealista-cli (OAuth2 client credentials).
الوصف
ما الذي تفعله هذه المهارة
Queries the Idealista real estate API using idealista-cli with OAuth2 client credentials. Supports searching property listings by location, operation type, and property type, and computing price statistics across results.
Handles OAuth2 token acquisition and caching automatically, so queries run without manual authentication steps each time.
متى تستخدمها
- Search for apartments for sale within a radius of given coordinates
- Find rental homes under a price limit in a Spanish city
- Compute average sale prices grouped by property type in an area
- Retrieve all listing pages for a broad area search
- Ask an agent in natural language to find a flat matching specific criteria
مثال على سير العمل
User asks: Find flats for sale within 5km of Valencia city center
- 1
Resolve the coordinate for Valencia city center
- 2
Run idealista-cli search with --center, --distance 5000, --operation sale, --property-type homes
- 3
Use --all-pages to retrieve the full result set
- 4
Format results using --format summary
A list of flats for sale near Valencia with price, size, and location details
المتطلبات
- IDEALISTA_API_KEY environment variable (Idealista OAuth2 client_id)
- IDEALISTA_API_SECRET environment variable (Idealista OAuth2 client_secret)
- Idealista API credentials (OAuth2 client ID and secret, obtained from Idealista)
التثبيت
clawhub install quifago/idealistaشغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.