[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Particle podcast topic taxonomy](https://spiral.ai/integrations/gemini-cli/particle-podcast-topic-taxonomy)

# How to Use Particle podcast topic taxonomy in Gemini CLI

Returns topic names and identifiers from Particle’s classification tree. Use it to browse broad categories and narrower branches for a podcast research project.

|  |  |
| --- | --- |
| Model | Particle podcast topic taxonomy |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.026189 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Particle podcast topic taxonomy in Gemini CLI

- Use Particle podcast topic taxonomy to browse the Business branch. Map the returned hierarchy to our project’s category navigation.
- Use Particle podcast topic taxonomy to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Particle podcast topic taxonomy and tell me what changed since last week.
- Check Particle podcast topic taxonomy and summarize what you find in three bullet points.
- Pull the newest data from Particle podcast topic taxonomy and give me the result as a table.

## How to set up Particle podcast topic taxonomy in Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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 Particle podcast topic taxonomy**: 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": "particle/entities/topics",
    "input": {
      "limit": 25
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Particle podcast topic taxonomy on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## Particle podcast topic taxonomy tools and prices

- [Particle · Topics](https://spiral.ai/tools/alexandria/particle/entities/topics) (Alexandria): $0.026189 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 100 | 25 | Maximum records to return. |
| cursor |  | — | Opaque cursor from a previous page. Omit for the first page; send the same filters with it. |
| parent_id |  | — | Only children of this topic, by id, ancestry slug or path hash. Omit for the top-level roots. |
| ancestry_path |  | — | Only the topic with exactly this path hash. |
| ancestry_path_prefix |  | — | Only descendants under this path prefix. |

## What can you do with Particle podcast topic taxonomy in Gemini CLI?

Build a podcast research interface with resolved company identities and topic navigation. Use Particle’s descriptions, category labels, and taxonomy to make subject selection clear before users investigate audio.

### Plan a podcast research interface

Design a research screen around Nvidia: reconcile its domain, inspect its identity, browse show entities, and use the returned entity categories and topic hierarchy to organize navigation.

### Prepare an editorial research brief

Resolve OpenAI and other named organizations, inspect their descriptions, and explore relevant business and technology branches. Use entity categories to separate organizations from other subjects before choosing the brief’s scope.

### Define a brand research watchlist

Match public company domains to Particle identities and check ambiguous names. Review show-specific entity rankings, available entity categories, and topic ancestry to define which subjects belong in the research.

### Scope a podcast discovery project

Start with Microsoft and the business taxonomy. Inspect identity matches, show entities, category labels, and topic details to decide which companies and subject branches the project should cover.

### Choose precise editorial categories

Browse Politics and its narrower branches, then inspect Elections and International Relations. Use ancestry and child counts to choose categories with a clear scope.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## Particle podcast topic taxonomy in other agents

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

## More Gemini CLI guides

- [Particle podcast topic details](https://spiral.ai/integrations/gemini-cli/particle-podcast-topic-details)
- [Particle podcast transcript mentions](https://spiral.ai/integrations/gemini-cli/particle-podcast-transcript-mentions)
- [Particle podcast topic counts](https://spiral.ai/integrations/gemini-cli/particle-podcast-topic-counts)
- [Particle podcast transcript preview](https://spiral.ai/integrations/gemini-cli/particle-podcast-transcript-preview)
- [Particle podcast suitability assessment](https://spiral.ai/integrations/gemini-cli/particle-podcast-suitability-assessment)
- [Particle podcast trend chart](https://spiral.ai/integrations/gemini-cli/particle-podcast-trend-chart)

## Questions about Particle podcast topic taxonomy in Gemini CLI

**Can Gemini CLI use Particle podcast topic taxonomy?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Particle podcast topic taxonomy like any built-in tool.

**How much does Particle podcast topic taxonomy cost in Gemini CLI?**

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

**Do I need an Alexandria account to use Particle podcast topic taxonomy in Gemini CLI?**

No. Spiral runs Particle podcast topic taxonomy on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Particle podcast topic taxonomy in Gemini CLI?**

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

**Does Gemini CLI wait while Particle podcast topic taxonomy runs?**

Particle podcast topic taxonomy runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**How broad is Particle’s podcast coverage?**

Particle advertises more than 165,000 podcasts, including the entire US Apple Podcasts Top 200 across more than 130 English-language verticals. That is its stated coverage boundary, rather than a claim to cover every podcast.

**How quickly does new podcast content reach Particle?**

Popular, frequent shows are polled at least every 30 minutes, while every show is checked at least every two days. Transcription and enrichment then take minutes to hours after discovery.

**Does an episode count mean someone appeared as a guest?**

Search counts measure episodes tagged with the subject. Particle’s entity directory also covers subjects discussed in a show, so these counts alone do not establish a guest appearance.

**Does an external identifier guarantee one identity?**

No. Particle can return several records for one identifier and shows at most ten matches, with a separate count reporting the total.

**Are Particle’s topic labels unique?**

No. The same topic name can appear under several parents, and episodes are classified automatically. Read the ancestry to distinguish, for example, a technology branch from a business branch.

