[Integrations](https://spiral.ai/integrations) › [Muse](https://spiral.ai/integrations/muse) › [OpenSanctions entity search](https://spiral.ai/integrations/muse/opensanctions-entity-search)

# How to Use OpenSanctions entity search in Muse

Returns matching entity records with country, topic, and source facets. Use it to find companies or vessels for further research; OpenSanctions says full-text search is unsuitable for building an automated screening process.

|  |  |
| --- | --- |
| Model | OpenSanctions entity search |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with OpenSanctions entity search in Muse

- Use OpenSanctions entity search to find Sberbank. Show the returned company names, reasons for inclusion, and contributing sources.
- Use OpenSanctions entity search to research Sovcomflot. Show the matching company records and explain which sources contributed them.
- Use OpenSanctions entity search to look this up and give me the result as a table.
- Pull the latest numbers from OpenSanctions entity search and tell me what changed since last week.
- Check OpenSanctions entity search and summarize what you find in three bullet points.

## How to set up OpenSanctions entity search 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 OpenSanctions entity 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": "opensanctions-org/sanctions-screening/search_entities",
    "input": {
      "q": "<q>"
    }
  }'
```

Then paste one of the prompts above: Muse finds OpenSanctions entity search on Spiral, shows the price and runs it.

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

## OpenSanctions entity search tools and prices

- [OpenSanctions · Search entities](https://spiral.ai/tools/alexandria/opensanctions-org/sanctions-screening/search_entities) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| q |  | — | Free-text name query. Optional when at least one filter is given. |
| scope |  | — | Dataset or collection to search within (default: the site's 'default' collection). Pattern: ^[a-z0-9_]{2,80}$. |
| schema |  | — | FollowTheMoney schema name: Person, Company, Organization, LegalEntity, PublicBody, Vessel, Airplane, Address, CryptoWallet, Security. Pattern: ^[A-Z][A-Za-z]{2,40}$. |
| topics |  | — | FollowTheMoney topic codes, e.g. sanction, sanction.linked, role.pep, role.rca, poi, wanted, crime, debarment, export.control. |
| datasets |  | — | Restrict to entities present in these dataset names (us_ofac_sdn, eu_fsf, wikidata, ...). |
| countries |  | — | Lower-case country codes as OpenSanctions uses them, including historic/territory codes (ru, ua, suhh, ua-cri, eu). |

## What can you do with OpenSanctions entity search in Muse?

Prepare a company research brief with evidence from OpenSanctions and an explanation of the underlying sources. A chat assistant can turn returned records into a readable account of what the database says and why the company appears.

### Prepare a supplier research packet

Discover relevant sanctions sources, inspect their coverage, find a public supplier such as Sberbank, and examine its entity profile. Assemble the findings and contributing sources for a reviewer.

### Compare sanctions authorities

Identify US and EU source datasets, read their descriptions, and investigate how a company appears in the returned records. Explain which authorities contribute to its profile.

### Research a shipping company

Find sources relevant to maritime sanctions, inspect their coverage, and research Sovcomflot or another public shipping company. Examine returned sanctions records and business relationships for a shipping review.

### Investigate procurement exclusions

Discover debarment sources and inspect their publishers and coverage. Browse relevant company records, then examine individual profiles to prepare a procurement research brief.

### Explain a company finding

Find a public company by name, then inspect its profile to distinguish sanctions records from other reasons for inclusion. Present the supporting records for a human review.

## Overview

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

## OpenSanctions entity search in other agents

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

## More Muse guides

- [OpenSanctions entity profile](https://spiral.ai/integrations/muse/opensanctions-entity-profile)
- [Openmart brand search](https://spiral.ai/integrations/muse/openmart-brand-search)
- [OpenSanctions dataset details](https://spiral.ai/integrations/muse/opensanctions-dataset-details)
- [Openmart business lookup](https://spiral.ai/integrations/muse/openmart-business-lookup)
- [OpenSanctions dataset catalog](https://spiral.ai/integrations/muse/opensanctions-dataset-catalog)
- [Openmart local business search](https://spiral.ai/integrations/muse/openmart-local-business-search)

## Questions about OpenSanctions entity search in Muse

**Can Muse use OpenSanctions entity search?**

Yes. Add Spiral to Muse as an MCP server, and Muse can find and run OpenSanctions entity search like any built-in tool.

**How much does OpenSanctions entity search cost in Muse?**

$0.00873 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 OpenSanctions entity search in Muse?**

You need no Alexandria account. Muse uses one Spiral API key for every tool, and Spiral runs OpenSanctions entity search on its own Alexandria account.

**How long does it take to set up OpenSanctions entity search in Muse?**

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

**Does Muse wait while OpenSanctions entity search runs?**

OpenSanctions entity search runs in the background. Muse starts the run, checks on it and gives you the json when it's ready.

**Is everyone listed in OpenSanctions sanctioned?**

No. OpenSanctions also includes records connected to criminal matters and public office. A listing’s reason must be checked before describing it as a sanctions designation.

**Where does OpenSanctions get its information?**

It collects records from sanctions authorities, government registries, and public records worldwide. Dataset descriptions identify publishers and explain source coverage.

**Does OpenSanctions cover procurement bans?**

Yes. Its inclusion criteria explicitly cover companies and individuals excluded or debarred from procurement, extending its coverage beyond sanctions lists.

**What tells me whether a source is maintained?**

OpenSanctions dataset metadata includes maintenance status, update timestamps, and temporal coverage. These describe the individual source rather than promising one update schedule for every dataset.

**Why does a search result show less detail than an entity profile?**

Search results contain the entity’s own properties, including names, identifiers, and key dates. Detailed relationships are retrieved through an entity lookup.

