[Integrations](https://spiral.ai/integrations) › [n8n](https://spiral.ai/integrations/n8n) › [Akta industry code search](https://spiral.ai/integrations/n8n/akta-industry-code-search)

# How to Use Akta industry code search in n8n

Akta industry code search returns matching industry names, codes, and similarity scores for a topic such as warehouse automation. Use it to choose sector codes before filtering Akta news or company lists.

|  |  |
| --- | --- |
| Model | Akta industry code search |
| Available through | Alexandria |
| Category | News & Media |
| Price | $0.013 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Akta industry code search in n8n

- At the start of each Monday research session, use Akta industry code search for warehouse automation. Show the returned names, codes, and similarity scores for my review.
- Before each monthly battery recycling research session, use Akta industry code search for battery recycling. Present the matching industries and recommend candidates for that session's company screening.
- Every Friday, use Akta industry code search for semiconductor packaging. Show the returned candidates and explain which codes fit the sector news scope for this run.
- At the start of each weekly logistics research run, use Akta industry code search separately for industrial robotics and warehouse automation. Compare the codes returned during that run.
- Before each scheduled energy research session, use Akta industry code search for grid-scale energy storage. Present the returned matches and identify closely related candidates worth reviewing together.

## How to set up Akta industry code search in n8n

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

### Use the Spiral skill

1. **Send n8n 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 Spiral's MCP server

1. **Create a key**: Create a key under API keys in the console.

2. **Add an MCP Client node**: In a workflow, add an MCP Client node (or, under an AI Agent node, an MCP Client Tool) and set:

```text
https://api.spiral.ai/mcp
```

3. **Pick a tool**: The node lists Spiral's tools. In an MCP Client node pick one, such as `run`, and give it its arguments:

```json
{
  "provider": "fal",
  "model": "fal-ai/flux/schnell",
  "input": { "prompt": "a lighthouse at dawn" },
  "wait": true
}
```

4. **Run Akta industry code search in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds Akta industry code search, prices it and runs it each time the step fires.

### 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 Akta industry code 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": "akta/industries/search",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: n8n finds Akta industry code search on Spiral, shows the price and runs it.

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

## Akta industry code search tools and prices

- [Akta · Industry search](https://spiral.ai/tools/alexandria/akta/industries/search) (Alexandria): $0.013 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| level |  | — | Comma-separated taxonomy levels: l1, l2, l3, l4, all. Default l4. |

## What can you do with Akta industry code search in n8n?

Resolve the sector topic assigned to each scheduled research run into candidate Akta codes. An always-on agent can present the current matches for review before the run uses them to scope news or company research.

### Prepare a sector news search

Resolve warehouse automation into candidate industry codes and compare the returned names before choosing the sector scope for an internal news search.

### Scope a company screening exercise

Look up battery recycling and select relevant industry codes for a company list research session.

### Compare overlapping market descriptions

Search industrial robotics and warehouse automation separately. Compare their returned codes to identify overlap before defining a research brief.

### Separate ambiguous industry meanings

Compare results for cloud data warehouses and physical warehouse automation so a logistics research session uses the intended sector codes.

### Expand a narrow news research scope

Review several closely related semiconductor packaging matches and choose multiple relevant codes for a broader sector news search.

### Translate a market brief into Akta terminology

Turn a brief about grid-scale energy storage into returned industry names and codes that an analyst can review during the session.

## Overview

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

## Akta industry code search in other agents

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

## More n8n guides

- [Akta company search filters](https://spiral.ai/integrations/n8n/akta-company-search-filters)
- [Akta news articles](https://spiral.ai/integrations/n8n/akta-news-articles)
- [Akta company lookup](https://spiral.ai/integrations/n8n/akta-company-lookup)
- [Anthropic blog post](https://spiral.ai/integrations/n8n/anthropic-blog-post)
- [Akta company lists](https://spiral.ai/integrations/n8n/akta-company-lists)
- [Anthropic blog post search](https://spiral.ai/integrations/n8n/anthropic-blog-post-search)

## Questions about Akta industry code search in n8n

**Can n8n use Akta industry code search?**

Yes. Add Spiral to n8n as an MCP server, and n8n can find and run Akta industry code search like any built-in tool.

**How much does Akta industry code search cost in n8n?**

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

**Do I need an Alexandria account to use Akta industry code search in n8n?**

You need no Alexandria account. n8n uses one Spiral API key for every tool, and Spiral runs Akta industry code search on its own Alexandria account.

**How long does it take to set up Akta industry code search in n8n?**

About two minutes: create a key, then add an MCP Client node, then pick a tool.

**Does n8n wait while Akta industry code search runs?**

Akta industry code search runs in the background. n8n starts the run, checks on it and gives you the json when it's ready.

**What does Akta industry search return?**

It returns matching industry names and codes ranked by similarity, with a similarity score for each match. These are taxonomy lookup results for choosing a sector filter.

**What does the similarity score measure?**

It measures similarity between your query and a matched industry on a scale from 0 to 1. Use it to compare the returned candidates.

**What happens when Akta finds no matching industry?**

The documented response contains an empty results array. The endpoint does not substitute a default industry.

**Can one industry code miss relevant sector news?**

Akta recommends considering more than one code when a query matches several closely related industries. Using multiple codes can widen coverage beyond the single top match.

**Can I keep the returned industry codes in a permanent database?**

Akta's self-serve terms require prior written consent to persistently cache or store outputs beyond an active session. That restriction matters when planning a saved industry mapping table.

