[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Openmart local business search](https://spiral.ai/integrations/opencode/openmart-local-business-search)

# How to Use Openmart local business search in opencode

Find physical business locations with names, addresses, websites, categories, ratings, and social links where available. Use it to research local markets or build store-level prospect lists, keeping separate locations of the same company distinct.

|  |  |
| --- | --- |
| Model | Openmart local business search |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | Up to $0.69836 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Openmart local business search in opencode

- Use Openmart local business search to retrieve 100 businesses in Austin, Texas, United States, and add a review table to this project showing names, addresses, categories, and websites.
- Use Openmart local business search to retrieve businesses in Seattle, Washington, United States, then compare returned names and street addresses with our CRM fixture and write a differences report.
- Use Openmart local business search to retrieve 100 businesses in Portland, Oregon, United States, then use returned categories to create a restaurant shortlist in this project's research directory.
- Use Openmart local business search to retrieve businesses in Denver, Colorado, United States, and build a project view that keeps locations with the same website at separate addresses.
- Use Openmart local business search to retrieve 100 businesses in Boston, Massachusetts, United States, and create a CSV of returned names, websites, and available Google ratings for our market review.

## How to set up Openmart local business search in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 Openmart local business search**: 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": "openmart/businesses/search",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: opencode finds Openmart local business search on Spiral, shows the price and runs it.

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

## Openmart local business search tools and prices

- [Openmart · Local business search](https://spiral.ai/tools/alexandria/openmart/businesses/search) (Alexandria): Up to $0.69836 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 100 | 10 | Records per page, 1 to 100. Default 10. Each record returned costs 10 credits. |
| cursor |  | — | Next page: the last row's cursor from the previous page, a two-item array [match_score (number), store_id (string)], such as [24.26, "store-a"]. match_score must be a JSON number, not a string. Omit for the first page. |
| location |  | — | Location filters, each with a country, such as [{"country":"USA","state":"CA","city":"San Francisco"}]. |
| estimate_total |  | — | Wrap the page as {data, total_count} with an estimated match count. |

## What can you do with Openmart local business search in opencode?

Build a territory review tool that organizes Openmart business locations by address and category. Coding agents can connect returned listings to project files and show changes between monthly snapshots.

### Build a local sales territory list

Retrieve business locations in Austin, then organize the returned addresses and categories into prospect lists for field sales.

### Compare businesses in a market

Review returned restaurants in Portland by category, website, and available Google rating to prepare a local competitor brief.

### Find potential retail partners

Review Seattle business results for stores that fit a distribution partnership. Include each candidate's address, website, and listed social pages.

### Check business records against a CRM

Compare returned business names, street addresses, and websites with existing CRM records to flag differences for review.

### Review local businesses' web presence

Separate returned businesses with websites or social links from those without those details in the response. Use the results to plan further business research.

### Compare monthly listing snapshots

Repeat the same location search each month and compare returned names, addresses, websites, and ratings. Describe differences as listing changes requiring review.

## Overview

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

## Openmart local business search in other agents

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

## More opencode guides

- [Openmart business lookup](https://spiral.ai/integrations/opencode/openmart-business-lookup)
- [OrbiSearch company profile](https://spiral.ai/integrations/opencode/orbisearch-company-profile)
- [Openmart brand search](https://spiral.ai/integrations/opencode/openmart-brand-search)
- [OrbiSearch email verification](https://spiral.ai/integrations/opencode/orbisearch-email-verification)
- [OpenSanctions entity search](https://spiral.ai/integrations/opencode/opensanctions-entity-search)
- [OrbiSearch work email finder](https://spiral.ai/integrations/opencode/orbisearch-work-email-finder)

## Questions about Openmart local business search in opencode

**Can opencode use Openmart local business search?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Openmart local business search like any built-in tool.

**How much does Openmart local business search cost in opencode?**

Up to $0.69836 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

**Do I need an Alexandria account to use Openmart local business search in opencode?**

No. Spiral runs Openmart local business search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Openmart local business search in opencode?**

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

**Does opencode wait while Openmart local business search runs?**

Openmart local business search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**Which markets and business categories does Openmart cover?**

Openmart advertises more than 500 business categories across 16 markets in North America, Europe, and APAC.

**How fresh is Openmart's business database?**

Openmart says it runs comprehensive verification passes monthly. That schedule does not establish that every returned listing reflects changes made today.

**Does each result represent a company or a physical location?**

Business search returns physical store locations. A company with several locations can therefore appear more than once; Openmart's company search aggregates stores under a shared business identity.

**Where does Openmart get its data?**

Openmart lists public business registrations, tax filings, Google Maps listings, and local web data among its database sources.

**Are email addresses and phone numbers included in search results?**

They are withheld when the record's contact-lock flag is true. A business appearing in search results does not guarantee that its raw contact details are returned.

