Spiral gives your agent every tool with one account. Browse the tools →

Windsurf · Maps & Reviews

How to Use Houzz professional projects in Windsurf

Fetch the initial portfolio summaries on a public Houzz professional profile, including project names, locations, and photo counts. Use them to find relevant examples before reviewing individual projects.

Prompts to try with Houzz professional projects in Windsurf

Copy an example into Windsurf, or ask in your own words.

Use Houzz professional projects for Bespoke Contracting in Burlington, Ontario, and create a CSV of the initial project names, locations, and photo counts. Label the file's scope as initial portfolio summaries.

Houzz professional projectsWindsurf
Try asking
  • Use Houzz professional projects for Bespoke Contracting in Burlington, Ontario, and update my portfolio index with returned titles mentioning additions or whole-home renovations, their locations, and photo counts.

  • Use Houzz professional projects to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from Houzz professional projects and tell me what changed since last week.

  • Check Houzz professional projects and summarize what you find in three bullet points.

How to set up Houzz professional projects in Windsurf

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the server

    Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:

    {
      "mcpServers": {
        "spiral": {
          "url": "https://api.spiral.ai/mcp"
        }
      }
    }
  2. Sign in

    Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Houzz professional projects

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "alexandria",
        "model": "houzz-com/professionals/projects",
        "input": {
          "url": "<url>"
        }
      }'

Then paste one of the prompts above: Windsurf finds Houzz professional projects on Spiral, shows the price and runs it.

Houzz professional projects providers and prices

Spiral runs Houzz professional projects through Alexandria. Open a card for today's price, with every fee included.

AlexandriaMaps & Reviews
Houzz · Projects
houzz-com/professionals/projects

What can you do with Houzz professional projects in Windsurf?

Build a contractor comparison in your project from Houzz business details and published portfolio summaries. Keep directory candidates, advertised service areas, ratings, and project examples distinct so the comparison shows what each observation supports.

Build a renovation shortlist

Find contractors in a location directory, compare their advertised services and service areas, and review initial project titles for work relevant to your renovation.

Compare additions with whole-home renovations

Discover candidates, check which services they advertise, and separate portfolio titles mentioning additions from those mentioning whole-home renovations. Use those examples to prepare questions for each business.

Compare candidates across nearby cities

Review directory candidates from neighboring cities, compare their service areas, and organize initial portfolio summaries by reported project location.

Prepare contractor consultation notes

Turn directory results, business descriptions, and relevant portfolio titles into a brief for each shortlisted contractor. Include questions about advertised services and examples you want to discuss.

Recheck a shortlist before choosing

Revisit directory candidates, compare their published profile details with an earlier comparison, and check whether their initial portfolio summaries have changed.

Index published portfolio examples

Organize returned project names, locations, and photo counts into a reading list. Label it as the initial portfolio summaries so readers understand its scope.

Questions about Houzz professional projects in Windsurf

Can Windsurf use Houzz professional projects?

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Houzz professional projects like any built-in tool.

How much does Houzz professional projects cost in Windsurf?

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.

Do I need an Alexandria account to use Houzz professional projects in Windsurf?

No. Spiral runs Houzz professional projects on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up Houzz professional projects in Windsurf?

About two minutes: add the server, then sign in, then check it.

Does Windsurf wait while Houzz professional projects runs?

Houzz professional projects runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.

What does a public Houzz portfolio represent?

Houzz describes portfolio projects as collections of photos and information published under a business's public profile. The initial project summaries are a starting point for reviewing that published portfolio.

Are directory results limited to businesses in the named city?

No. The Hamilton, Ontario directory includes a business in North Tonawanda, New York. Check a candidate's advertised service areas before assuming it serves your project location.

Does one directory page contain every matching professional?

No. The inspected Hamilton directory shows professionals 1–15 on its first page and offers a next-page link. That observed page size does not establish a universal limit for every Houzz directory.

How quickly do new reviews appear on Houzz?

Houzz says review moderation can take 5–7 business days, depending on volume. A newly submitted review may therefore take several business days to appear.

Does a Houzz listing mean the professional has been vetted?

No. Houzz explicitly says it does not conduct background checks or otherwise vet listed professionals. A directory result or portfolio is not evidence of that verification.

Get started

Start using Houzz professional projects in Windsurf

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Windsurf:

Set up Windsurf

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options