This guide walks you through adding Buying Buddy to a website built with Claude. Because Claude builds your site by chatting with you, the entire setup is done by handing Claude a short series of ready-made AI prompts that your Buying Buddy dashboard generates for you. For each step your dashboard shows a single, complete prompt - you copy it and paste it into Claude. There is no code to copy or paste by hand.
AI-guided setup only: Claude does not use a manual, copy-the-script installation. Instead, you hand Claude a series of personalized prompts and it adds the Buying Buddy plugin and builds out your pages for you. Buying Buddy widgets are added as standard <bb-widget> elements, which Claude-built sites support.
Is this the right guide? This install path is for a plain static HTML / JavaScript site that Claude built for you - real HTML pages served as static files (for example on Netlify). Claude can also build other kinds of site - a React, Next.js, Vue, or Astro app, a single-page app, or a server-rendered site - and those need a different Buying Buddy install method. If your site is one of those, please contact Buying Buddy support and we will point you to the right steps. Most Claude static sites qualify, so if you are not sure, go ahead - the first prompt checks the site type before it changes anything.
Real pages, not sections: Buying Buddy needs its pages (Results, Property Details, and so on) created as real pages with their own web addresses - their own .html file or route - not as #anchor sections on a single long landing page. The widgets rely on those page addresses to work, for example to open a property's detail page or run a search. The prompts already ask Claude to do this; this note is just so you know what to expect if your current site is one long page.
What the AI Prompts Set Up for You
The prompts are generated specifically for your account, so Claude already has everything it needs. Setup runs as a five-step flow: three small install prompts, one quick settings entry, and an optional "add recommended widgets" prompt. The install is split into small prompts on purpose - each one gives Claude a single, focused job, and each prompt first checks that the previous step was completed before it makes any changes.
How each step works: For every step, the dashboard shows the full, personalized prompt on the Add Plugin tab. Copy it and paste it into Claude. Each prompt is already set up for your account - paste it exactly as it is.
Step-1 Prompt - Add the Plugin
- ✅ Adds the Buying Buddy plugin loader to your site's shared page head, so it loads on every page
- ✅ Uses a safe, self-contained loader that always adds the plugin only once, even when the page builder re-runs scripts during publishing
- ✅ Confirms your site still previews with no errors
Step-2 Prompt - Create the Foundation Pages
- ✅ Creates your foundation pages - a Results page, a Property Details page, a Market Report page, and a Communities page
- ✅ Adds the required MLS disclaimer to your site footer, site-wide
- ✅ Groups your Buying Buddy pages under a single See More.. menu
Step-3 Prompt - Add Search & Get Your Settings
- ✅ Adds a property search form to your home page so visitors can start searching right away
- ✅ Measures Widget Header Offset values if your site has a sticky header
- ✅ Ends with an Action Required Before Previewing summary - your Website Type, your Preview URL, and your header offset values
In Step 4 you enter that summary into your dashboard (right on the install page - it takes under a minute). Then the optional Step-5 prompt adds the recommended extras:
Step-5 Prompt - Add Recommended Widgets (optional)
- ✅ A dedicated Search page
- ✅ A Featured Listings page
- ✅ A Home Value lead-capture form
- ✅ A Contact Me form
- ✅ An About Me page
- ✅ A Register / Login bar across the top of your site header
The Step-5 prompt asks before making any changes - it presents the six recommended widgets as a checklist with everything pre-checked (or as a simple numbered list, depending on how Claude responds), so you just uncheck anything you don't want and confirm. Each new page is added to the same See More.. menu, so all of your Buying Buddy pages are grouped together and easy to find.
Built-in guardrails: Every prompt opens with strict rules for Claude - it may only add the Buying Buddy items requested, it must not redesign, restyle, or "improve" your site or its styling, and it must never publish or deploy your site. Each prompt also ends by listing every file it touched, so you can see exactly what changed. You always preview and publish yourself.
Let Claude finish each step: Claude sometimes keeps working for a moment after it prints its "Next Step" line. Wait until it has fully finished and gone idle before you copy and paste the next prompt.
More on the way: The AI prompts are regularly improved, and additional setup options may be added over time - so it is always worth grabbing a fresh copy from your dashboard when you install.
Before You Begin
- An active Buying Buddy account (your Activation Key is filled into every prompt for you - you do not need to look it up).
- A website built with Claude that you can edit and re-publish.
- Know where your site is hosted. Claude generates the site, but you deploy and host it yourself (for example on Netlify). You will authorize both your preview address and your live domain in a later step.
Enter Your Settings and Go Live
After Step 3, two short tasks are yours to do by hand. Neither involves any code.
1
Enter Your Settings
Copy the Step-3 summary into your dashboard
In your Buying Buddy dashboard, on the install page, enter the values from your Step-3 Action Required summary:
- Website Type: set this to Built with Claude
- Preview URL: the address where you preview or deploy your site (for example your Netlify deploy preview)
- Widget Header Offset: the Mobile, Tablet, and Desktop values from Step 3, but only if your site has a sticky header
2
Preview, Deploy, and Authorize Your Site
You publish yourself - Claude never does
Claude builds your site but does not publish it. When you are happy with the preview, deploy the site to your own host the way you normally do. Then authorize your addresses so the widgets can load:
- Authorize your preview address (so widgets appear while you are testing)
- Authorize your live domain (so widgets appear on the published site)
Widgets are domain-locked: Buying Buddy widgets only load on addresses you have authorized, so your preview will show blank spaces where the widgets belong until you add each address. This is normal - add the address and refresh.
Troubleshooting
The widgets are blank or not showing
Almost always this means the address has not been authorized yet. Confirm that the exact address you are viewing - your preview address or your live domain - has been added in your dashboard, then refresh the page. If you have just generated your widget theme, give it a moment and do a hard refresh of the browser.
I see a console error about "documentReady" or "MBB.mbbActions"
Errors like Identifier 'documentReady' has already been declared or MBB.mbbActions is not a function mean the Buying Buddy plugin was loaded twice. Claude-built sites can re-run the scripts in your page head when they publish, and loading the plugin a second time causes these errors.
The current Step-1 prompt already prevents this - it adds a self-contained loader that only ever loads the plugin once, no matter how many times the page runs it. To fix a site that shows these errors:
- Make sure you used the exact Step-1 prompt from your dashboard, unchanged.
- Check that there is only one Buying Buddy loader in your site. If an older or hand-written Buying Buddy script was added earlier, remove it and re-run the current Step-1 prompt so only the run-once loader remains.
- Do not add a Buying Buddy script tag by hand in addition to the Step-1 loader - a second copy is what causes the error.
Claude changed my styling or other pages
The prompts instruct Claude only to add the Buying Buddy items and never to restyle or redesign your site. If Claude went further than asked, grab a fresh copy of the prompt from your dashboard and paste it exactly as it is. Buying Buddy widgets carry their own fully isolated styling, so no changes to your site's design are ever needed to make them look right.
That's it: once your addresses are authorized and your site is deployed, your Buying Buddy pages and widgets are live. You can re-open the Add Plugin tab at any time to add more widgets or grab updated prompts.