Standard Operating Procedure

MLS Listing JSON Import

Use AI to convert any Matrix MLS detail page into a structured JSON file, then import it into your Agent Dashboard to auto-fill a new listing in minutes.

~5 minutes end-to-end
25–28 fields auto-filled
Works with Claude & other AI

What This Process Does

Instead of entering every field manually when adding a new listing, you give an AI assistant the MLS detail page. The AI extracts and structures the data, saves it as a .json file, and you drop that file into the listing form. Most fields fill instantly — all you add are the listing agent, photos, and a few items that aren’t on the MLS page.

25–28

Fields auto-filled

2–5

Fields to review

<5 min

MLS → saved draft

.json

File format used

Prerequisites — Set Up Once

Choose the option that matches how you prefer to work. You only need to do this setup once.

Recommended

1 Install Claude for Chrome from the Chrome Web Store if you haven’t already.
2 Sign into the extension with your Anthropic account.
3 Click the settings/customize icon inside the extension panel.
4 Go to Shortcuts → New Shortcut.
5 Name it TPG-MLS-JSON and set the command to /mls-to-json.
6 Paste the full contents of the TPG_MLS_JSON_Prompt.md file into the shortcut body. Save.

Once set up, you just open the extension on any MLS listing page, type /mls-to-json, and the JSON downloads automatically — no copy-pasting or screenshots required.

1 Go to claude.ai or open Claude Cowork and start a new conversation.
2 Paste the full contents of TPG_MLS_JSON_Prompt.md as your first message and press Enter.
3 In your next message, attach a screenshot of the full MLS page and say “Convert this listing.”

Cowork tip: Install the tpg-mls-to-json skill folder into ~/.claude/skills/ and Claude will trigger automatically whenever you share MLS data — no need to paste the prompt each time.

1 Open a new chat in your preferred AI tool.
2 Paste the full contents of TPG_MLS_JSON_Prompt.md as your first message.
3 Share the MLS listing data (screenshot, pasted text, or PDF) and ask it to convert the listing.

Step-by-Step Workflow

Log into Matrix (or your MLS portal) and open the full detail page for the listing you want to add. Make sure you’re on the complete detail view — not a search results card — so all sections are visible: General Description, Location, Building Info, Lot, Interior Features, Utilities, and Listing Details.

Use whichever method you set up in Prerequisites:

Chrome Extension

With the listing page open, click the Claude extension icon. Type /mls-to-json and press Enter. Claude reads the live page and generates the JSON in real time.

Claude.ai / Cowork

Take a screenshot of the full MLS detail page, attach it to Claude, and say “Convert this listing.”

The AI reads every section of the MLS page and produces a complete, correctly structured JSON object. You’ll see it work through the fields in real time.

The Chrome extension can read the page directly — you don’t need to scroll, copy, or take screenshots. It processes the entire MLS detail page automatically.

Once finished, the AI will display the completed JSON and flag any fields it couldn’t confidently read. Look for a note at the end of its response listing fields that were blank, partially obscured, or unclear.

Common fields that may need a quick check:

Heating type — small text in the MLS Utilities section
Sewer type — same area
Year renovated — often blank on the MLS page
MLS number — verify it matches what you see in Matrix
Listing date — verify the format is MM/DD/YYYY

If any field looks wrong, you can either correct it in the JSON before downloading, or fill it in manually inside the listing form after import — whichever is easier.

Chrome Extension

The download triggers automatically. The file appears in your Downloads folder named after the address — e.g. 324 Jebb Rd Camden Wyoming DE.json

Claude.ai / Cowork

Copy the JSON text, paste into a text editor (Notepad, TextEdit), and save as [Address] [City] [State].json — e.g. 7592 Buckman Ave Salisbury MD.json

File naming convention: Street address + city + state abbreviation, separated by spaces. No ZIP code, no underscores, no special characters.

Go to theparkergroup.com and sign in. Click your name in the top-right corner to open the account menu, then select Dashboard.

Dashboard screenshot — showing the account menu with Dashboard, My Listings, and Add Listing options

On the Dashboard, scroll down to the My Listings section and click the + Add Listing button in the top-right corner.

This opens a blank multi-step listing form (11 steps: Address & Agent, Property Details, Features, Construction, Description, Financial, Sale Info, Photos & Media, Sellers, Occupancy, and Readiness) with the Import from MLS JSON panel at the top.

You don’t need to fill all steps before saving — save a draft at any point and return later to add photos, financial details, and other information.

At the top of the new listing form, you’ll see the Import from MLS JSON panel with a dashed drop zone.

Drag and drop the .json file from your Downloads folder onto the drop zone, or
Click Browse… and select the file from your Downloads folder

Empty listing form — showing the Import from MLS JSON drop zone at the top of the Add Listing page

The import runs instantly. The form auto-scrolls to Step 1 — Address & Agent where you can see all the filled-in fields and the auto-generated title preview.

A green confirmation banner shows how many fields were imported successfully, with a green chip for every field that mapped correctly. A typical import maps 25–28 fields.

Import success screen — showing “28 fields imported successfully” with green chips for all mapped fields and the expanded “4 fields could not be mapped” list

Below the green chips, you may see an orange warning: “X fields could not be mapped.” Click the arrow to expand it. Common unmapped fields and where to find them:

Unmapped Fields Reference

Unmapped Field	Where to Fill It In
Waterfront	Step 3 → Features → Property Features checkboxes
Yr Renovated	Step 2 → Property Details → Age & History
Sewer	Step 4 → Construction → Utilities & Services → Sewer dropdown
Heating	Step 4 → Construction → HVAC & Hot Water → Heating System dropdown
Listing Agent	Step 1 → Listing Setup → always set manually

Navigate through the steps using the tab bar and fill in any unmapped fields. A few things to always check:

Listing Agent (Step 1) — required before publishing
Description (Step 5) — the MLS public remarks are auto-filled; edit and improve them if needed
Photos (Step 8) — upload the primary photo and gallery; these can’t come from the JSON
Financial (Step 6) — tax info, HOA details if applicable

You don’t need to complete every step now. Save a draft and come back to add photos, seller info, and other details whenever you’re ready.

Click the Save Draft button on any step to save your progress. The listing will appear in My Listings on your Dashboard with a DRAFT badge.

From your draft you can return at any time to:

Upload photos and media
Complete remaining steps (Financial, Sale Info, Sellers, Occupancy, Readiness)
Edit any auto-filled fields before publishing

When ready to publish, navigate to Step 8 — Photos & Media and click Publish Listing at the bottom of the form.

Quick Reference — What the JSON Auto-Fills

Fields by Form Step

Form Step	Auto-Filled from JSON	Always Manual
1 — Address & Agent	Street number, name, type, city, state, ZIP, property type, listing status, county, subdivision Auto	Listing agent Manual
2 — Property Details	Price, beds, full baths, half baths, sq ft, lot acres, year built, stories, year renovated, listing date, basement Y/N Auto	Garage details, condition, style Manual
3 — Features	Interior feature checkboxes, flooring, appliances, pool Y/N Auto	Exterior & property features Manual
4 — Construction	Water source, sewer, heating type (when dropdown matches) Auto	Roof, foundation, cooling, electric Manual
5 — Description	Full property description (from MLS public remarks) Auto	Highlights, internal notes Manual
6–11	MLS number Auto	Tax info, HOA, photos, seller info, occupancy, readiness Manual

Troubleshooting

The import zone doesn’t appear when I click Add Listing.

The JSON import zone only shows when adding a new listing. If you’re editing an existing one, the zone is hidden by design. If the listing already exists in the system (matched by MLS number), the import will offer to redirect you to the edit page for that listing instead of creating a duplicate.

More than 10 fields were skipped.

This usually means the JSON uses a flat structure instead of the required nested structure. Make sure the AI used the prompt from TPG_MLS_JSON_Prompt.md exactly — older or generic prompts may produce a flat format the import tool can’t read. Fields like mls_number, beds, and baths_full must be inside the property_details sub-object.

The price didn’t import.

The price must be a plain integer in the JSON (e.g. 650000), not a formatted string like "$650,000". Open the .json file in a text editor, correct the value, save, and re-import.

The description field is empty after import.

The JSON key must be remarks_public exactly. If the AI used "remarks" instead, the description won’t map. Open the .json file, rename the key to remarks_public, save, and re-import.

The Chrome extension shortcut isn’t working.

Make sure the full prompt text from TPG_MLS_JSON_Prompt.md was pasted into the shortcut body — the shortcut needs the complete JSON schema and field rules to work correctly. If only the title was pasted, Claude won’t have the instructions it needs.

The JSON was generated but the download didn’t trigger automatically.

In the Chrome extension, copy the JSON text from Claude’s response, open a plain text editor on your computer, paste it in, and save the file with the address as the filename and .json as the extension — for example: 324 Jebb Rd Camden Wyoming DE.json

Create & Import JSON From MLS