How to Use Openmart local business search in Codex
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.
Prompts to try with Openmart local business search in Codex
Copy an example into Codex, or ask in your own words.
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 Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run Openmart local business search
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": "openmart/businesses/search", "input": { "query": "<query>" } }'
Then paste one of the prompts above: Codex finds Openmart local business search on Spiral, shows the price and runs it.
Openmart local business search providers and prices
Spiral runs Openmart local business search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Limit | 1 to 100 | 10 | Records per page, 1 to 100. Default 10. Each record returned costs 10 credits. |
| Estimate total | on or off | Wrap the page as {data, total_count} with an estimated match count. |
Every API field of Openmart · Local business search is on its tool page: open its card above.
What can you do with Openmart local business search in Codex?
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.
More on Openmart local business search and Codex
Overview
Openmart local business search in other agents
Questions about Openmart local business search in Codex
Can Codex use Openmart local business search?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Openmart local business search like any built-in tool.
How much does Openmart local business search cost in Codex?
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 Codex plan is separate.
Do I need an Alexandria account to use Openmart local business search in Codex?
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 Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while Openmart local business search runs?
Openmart local business search runs in the background. Codex 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.
Start using Openmart local business search in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


