Import Listing

Step 1: Extract Listing Data

Use WebFetch to retrieve the listing page. Extract these fields:

Step 2: Resolve Location UUID AND Address Fields

Qobrix stores location in two complementary ways — both must be populated:

1. location UUID — links to the Qobrix locations tree (district/area hierarchy).
2. Free-text address fields — street, post_code, city, state, country, coordinates. These are what show on the property "Location" page. If you only set location + coordinates, Street and Post Code display as "--".

2a. Look up the location UUID

bash "${CLAUDE_PLUGIN_ROOT}/scripts/qobrix-api.sh" GET "/api/v2/locations?search={district}%20{area}"

If no exact match, try: fuzzy match on area, match on district only, or ask the user.

2b. Extract the street address and postal code from the listing page

Scrape hard for these — they are often tucked into the "Location" / "Address" section, the breadcrumb, or the embedded Google Maps block:

• Street — full street name, plus number if displayed. If the listing only gives a neighbourhood name, put that in city (not street) and leave street null.
• Postal code — Cyprus postcodes are 4 digits (e.g. 6046, 7550). Look for them near the address, in structured data (JSON-LD), or in the map iframe URL (&q=...%206046).
• Coordinates — Extract from the map embed (q=lat,lng or center=lat,lng). Format as "lat,lng" string.
• City / State / Country — From breadcrumbs or title (e.g. "Larnaca → Sotiros" → state=Larnaca, city=Sotiros, country=CY).

If street or post_code cannot be found on the page, leave them null — don't invent values.

Step 3: Map Enum Values

sale_rent

property_type

furnished

Step 4: Present Summary for Confirmation

Before creating, show the user:

Property to import:
---
Name:        3 Bedroom Apartment in Mesa Geitonia, Limassol
Type:        apartment (for_sale)
Price:       EUR 375,000
Beds/Baths:  3 bed / 1 bath
Area:        99m2 covered
Floor:       1st
Built:       1997
Location:    Mesa Geitonia, Limassol [matched UUID]
Street:      Agias Fylaxeos 128
Post Code:   3025
Coordinates: 34.6892,33.0411
Agency:      Kazo Real Estate [found in contacts]
Images:      7 photos found

Source: https://index.cy/sale/9140726-...
---
Create in Qobrix?

Wait for confirmation.

Step 5: Create Property

bash "${CLAUDE_PLUGIN_ROOT}/scripts/qobrix-api.sh" POST "/api/v2/properties" \
  '{"name":"...","property_type":"apartment","sale_rent":"for_sale","list_selling_price_amount":375000,"bedrooms":3,"bathrooms":1,"covered_area_amount":99,"location":"{location_uuid}","street":"{street}","post_code":"{postcode}","city":"{area}","state":"{district}","country":"CY","coordinates":"{lat},{lng}","status":"available","description":"..."}'

Always include in description:

{original description text}

---
Imported from {Site Name}
Source URL: {original_url}
External reference: {ref_number_if_found}
Import date: {today}
Original agency: {agency_name_if_found}

Step 5.5: Link Seller/Agency Contact

After creating, look up the listing agency:

bash "${CLAUDE_PLUGIN_ROOT}/scripts/qobrix-api.sh" GET "/api/v2/contacts?search=first_name%20contains%20%22{agency_name}%22&limit=5"

If not found, create:

bash "${CLAUDE_PLUGIN_ROOT}/scripts/qobrix-api.sh" POST "/api/v2/contacts" '{"first_name":"{agency_name}","is_company":true}'

Then link:

bash "${CLAUDE_PLUGIN_ROOT}/scripts/qobrix-api.sh" PUT "/api/v2/properties/{id}" '{"seller":"{contact_uuid}"}'

Step 5.6: Upload Photos

For each image URL:

bash "${CLAUDE_PLUGIN_ROOT}/scripts/qobrix-api.sh" POST "/api/v2/properties/{id}/media" \
  '{"url":"{image_url}","display_order":{N},"category":"{featured_photo|photos}"}'

First image: category="featured_photo", rest: category="photos".

If upload fails with permission error, collect all URLs and show them for manual upload.

Step 6: Report Result

Created in Qobrix: #{id} — {title}
Open: {crm_url}/properties/view/{id}

Seller:  {agency} [linked]
Photos:  7/7 uploaded

Then offer:

• "Link this property to an opportunity?"
• "Send this to a customer on WhatsApp?"
• "Import another listing?"

Bulk Import

If given multiple URLs, process each and show a results table at the end.

Error Handling

• Page fetch fails: ask user to paste listing details manually
• Location not found: show closest matches, ask user to confirm
• Missing required fields: ask user to fill in name or property_type
• Duplicate detected: warn if same name + location + price exists
• Image upload permission denied: collect URLs, show in report for manual upload