[Integrations](https://spiral.ai/integrations) › [Muse](https://spiral.ai/integrations/muse) › [BBB business profile](https://spiral.ai/integrations/muse/bbb-business-profile)

# How to Use BBB business profile in Muse

Returns a business's BBB grade and reasons, accreditation details, business history, alerts, and complaint totals for 12 months and three years. Use it for an overview before reading individual complaints or reviews.

|  |  |
| --- | --- |
| Model | BBB business profile |
| Available through | Alexandria |
| Category | Maps & Reviews |
| Price | $0.001746 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with BBB business profile in Muse

- Use BBB business profile for Comcast Cable Communications in Philadelphia and explain the reasons BBB gives for its grade.
- Use BBB business profile to look this up and give me the result as a table.
- Pull the latest numbers from BBB business profile and tell me what changed since last week.
- Check BBB business profile and summarize what you find in three bullet points.
- Pull the newest data from BBB business profile and give me the result as a table.

## How to set up BBB business profile in Muse

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

### Use the Muse connector

1. **Create an API key**: Create one under API keys in the Spiral console.

2. **Send Muse this message**: Muse reads Spiral's skill and asks for an API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give Muse the key**: Paste the key when Muse asks for it, never in the chat itself.

### Use the Spiral skill

1. **Send Muse 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.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run BBB business profile**: One request; the result comes back by polling or a webhook.

```bash
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": "bbb-business-profiles-ratings-complaint/businesses/profile",
    "input": {
      "url": "<url>"
    }
  }'
```

Then paste one of the prompts above: Muse finds BBB business profile on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse

## BBB business profile tools and prices

- [BBB business profiles · Business profile](https://spiral.ai/tools/alexandria/bbb-business-profiles-ratings-complaint/businesses/profile) (Alexandria): $0.001746 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| bbb_id |  | — | 4-digit BBB office id from search results, e.g. 0825. Provide together with business_id. |
| country | us, ca | us | Only with bbb_id/business_id: which BBB site holds the profile. |
| business_id |  | — | Numeric BBB business id from search results, e.g. 90019908. Provide together with bbb_id. |

## What can you do with BBB business profile in Muse?

Get a business research brief before hiring a contractor or choosing a service. A chat agent can explain the returned BBB record and turn published complaints or reviews into specific questions to ask the business.

### Choose a moving company

Find movers near Miami, confirm each business's identity, and compare grades, complaint histories, customer reviews, and published responses before booking.

### Check a roofer before a deposit

Locate Denver roofing businesses, review their BBB records, and read complaints and reviews for issues to ask about before signing.

### Compare internet providers

Match providers to their BBB profiles and compare published billing disputes, customer feedback, business replies, and complaint totals before switching.

### Research a home warranty

Identify warranty providers and read their profiles, complaints, and reviews to prepare questions about repairs, service delays, and dispute handling.

### Refresh a personal contractor shortlist

Revisit matching businesses and their profiles before making a final choice, checking for changed grades, accreditation details, or alerts.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Muse guides](https://spiral.ai/integrations/muse)

## BBB business profile in other agents

- [Amp](https://spiral.ai/integrations/amp/bbb-business-profile)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/bbb-business-profile)
- [Claude](https://spiral.ai/integrations/claude-desktop/bbb-business-profile)
- [Claude Code](https://spiral.ai/integrations/claude-code/bbb-business-profile)
- [Cline](https://spiral.ai/integrations/cline/bbb-business-profile)
- [Codex](https://spiral.ai/integrations/codex/bbb-business-profile)
- [Cursor](https://spiral.ai/integrations/cursor/bbb-business-profile)
- [Devin](https://spiral.ai/integrations/devin/bbb-business-profile)
- [dots](https://spiral.ai/integrations/dots/bbb-business-profile)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/bbb-business-profile)
- [Gemini](https://spiral.ai/integrations/gemini/bbb-business-profile)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/bbb-business-profile)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/bbb-business-profile)
- [goose](https://spiral.ai/integrations/goose/bbb-business-profile)
- [Grok](https://spiral.ai/integrations/grok/bbb-business-profile)
- [Grok Build](https://spiral.ai/integrations/grok-build/bbb-business-profile)
- [Hermes](https://spiral.ai/integrations/hermes/bbb-business-profile)
- [Instinct](https://spiral.ai/integrations/instinct/bbb-business-profile)
- [Manus](https://spiral.ai/integrations/manus/bbb-business-profile)
- [Muse Code](https://spiral.ai/integrations/muse-code/bbb-business-profile)
- [n8n](https://spiral.ai/integrations/n8n/bbb-business-profile)
- [Notion](https://spiral.ai/integrations/notion/bbb-business-profile)
- [OpenClaw](https://spiral.ai/integrations/openclaw/bbb-business-profile)
- [opencode](https://spiral.ai/integrations/opencode/bbb-business-profile)
- [Perplexity](https://spiral.ai/integrations/perplexity/bbb-business-profile)
- [Raycast](https://spiral.ai/integrations/raycast/bbb-business-profile)
- [VS Code](https://spiral.ai/integrations/vscode/bbb-business-profile)
- [Windsurf](https://spiral.ai/integrations/windsurf/bbb-business-profile)
- [Zapier](https://spiral.ai/integrations/zapier/bbb-business-profile)

## More Muse guides

- [BBB business link lookup](https://spiral.ai/integrations/muse/bbb-business-link-lookup)
- [BBB business search](https://spiral.ai/integrations/muse/bbb-business-search)
- [BBB business complaints](https://spiral.ai/integrations/muse/bbb-business-complaints)
- [BBB customer reviews](https://spiral.ai/integrations/muse/bbb-customer-reviews)
- [Amtrak train status](https://spiral.ai/integrations/muse/amtrak-train-status)
- [Ballotpedia address coordinates](https://spiral.ai/integrations/muse/ballotpedia-address-coordinates)

## Questions about BBB business profile in Muse

**Can Muse use BBB business profile?**

Yes. Add Spiral to Muse as an MCP server, and Muse can find and run BBB business profile like any built-in tool.

**How much does BBB business profile cost in Muse?**

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

**Do I need an Alexandria account to use BBB business profile in Muse?**

You need no Alexandria account. Muse uses one Spiral API key for every tool, and Spiral runs BBB business profile on its own Alexandria account.

**How long does it take to set up BBB business profile in Muse?**

About two minutes: create an API key, then send Muse this message, then give Muse the key.

**Does Muse wait while BBB business profile runs?**

BBB business profile runs in the background. Muse starts the run, checks on it and gives you the json when it's ready.

**Which businesses can these endpoints cover?**

The endpoints cover BBB records in the United States and Canada. BBB publishes profiles for both accredited and non-accredited businesses.

**How fresh is a BBB rating?**

BBB says ratings update automatically as new information reaches it. The update trigger is new information, rather than a stated daily or weekly publication schedule.

**How much complaint history does BBB publish?**

BBB says complaints appear on profiles for three years from filing. For businesses with many complaints, it may publish only a representative sample of complaint text and disclose the percentage shown.

**Does a BBB letter grade include customer review stars?**

Customer reviews do not enter BBB's letter-grade calculation. Keep the customer star average separate from the business's BBB grade.

**Does BBB guarantee that customer reviews are accurate?**

BBB verifies marketplace interactions before publication, but says it cannot guarantee any individual review's accuracy or truthfulness.

