[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Particle podcast show directory](https://spiral.ai/integrations/claude-code/particle-podcast-show-directory)

# How to Use Particle podcast show directory in Claude Code

Returns shows with metadata and detected format attributes, such as guest frequency and publishing cadence. Use it to browse shows by their characteristics before researching individual episodes.

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

## Prompts to try with Particle podcast show directory in Claude Code

- Use Particle podcast show directory to fetch recent Pivot episodes and adapt our existing results component to show titles, publication dates, and durations.
- Use Particle podcast show directory to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Particle podcast show directory and tell me what changed since last week.
- Check Particle podcast show directory and summarize what you find in three bullet points.
- Pull the newest data from Particle podcast show directory and give me the result as a table.

## How to set up Particle podcast show directory in Claude Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code 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 show directory**: 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/podcasts/list",
    "input": {
      "slug": "<slug>"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Particle podcast show directory on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## Particle podcast show directory tools and prices

- [Particle · Show directory](https://spiral.ai/tools/alexandria/particle/podcasts/list) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| slug |  | — | Exact slug of one show. |
| sort | relevance, popularity | — | relevance ranks by match quality (the default with q); popularity orders by global popularity percentile. |
| 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. |
| has_ads | true, false | — | true for shows with detected advertising, false for ad-free shows with enough analysed episodes to say so. |
| language |  | — | ISO 639-1 language code, for example en or fr. Matches the primary subtag, so fr covers fr-CA. |

## What can you do with Particle podcast show directory in Claude Code?

Build a podcast research view that connects show identities, episode records, dialogue, and publisher context. Use Particle data to populate the project's research screens and distinguish newly processed material from historical publication activity.

### Prepare a topic desk briefing

Build a climate-policy show shortlist, inspect relevant episodes and publishers, follow newly processed releases, and compare episode volume with matching discussions.

### Create a current episode reading queue

Choose shows by topic and format, resolve supplied show and episode links, inspect episode metadata, and check for newly processed additions.

### Plan an evidence-based editorial calendar

Find relevant shows, inspect discussions about semiconductor manufacturing, and compare episode activity with company-mention patterns before choosing follow-up topics.

### Assess a show's fit for a research project

Compare detected show formats, resolve candidate links, inspect sample episode identities and publishing activity, and check publisher context.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## Particle podcast show directory in other agents

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

## More Claude Code guides

- [Particle podcast segments](https://spiral.ai/integrations/claude-code/particle-podcast-segments)
- [Particle podcast show lookup](https://spiral.ai/integrations/claude-code/particle-podcast-show-lookup)
- [Particle podcast segment transcript](https://spiral.ai/integrations/claude-code/particle-podcast-segment-transcript)
- [Particle podcast show mentions](https://spiral.ai/integrations/claude-code/particle-podcast-show-mentions)
- [Particle podcast segment details](https://spiral.ai/integrations/claude-code/particle-podcast-segment-details)
- [Particle podcast sponsor ad segments](https://spiral.ai/integrations/claude-code/particle-podcast-sponsor-ad-segments)

## Questions about Particle podcast show directory in Claude Code

**Can Claude Code use Particle podcast show directory?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Particle podcast show directory like any built-in tool.

**How much does Particle podcast show directory cost in Claude Code?**

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

**Do I need an Alexandria account to use Particle podcast show directory in Claude Code?**

No. Spiral runs Particle podcast show directory 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 show directory in Claude Code?**

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

**Does Claude Code wait while Particle podcast show directory runs?**

Particle podcast show directory runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

**Does Particle cover every podcast?**

Particle describes coverage of the Apple Podcasts Top 200 across more than 130 English-language verticals, plus independent shows. That coverage statement does not establish complete coverage of every podcast or language.

**How quickly does new podcast data appear?**

Every tracked show's feed is checked at least every two days. After discovery, transcription and enrichment take minutes to hours, so publication and searchable availability can differ.

**How far back does the data go?**

Particle's transcribed episode history reaches back to 2017. Coverage varies by show, and an older episode discovered in a feed may still lack a transcript.

**Does an episode record guarantee that its dialogue is searchable?**

No. Particle also holds discovered episodes without transcripts; those records have no transcript-derived speakers, entities, segments, or clips.

**Will following new episodes also retrieve a show's complete archive?**

No. Particle excludes bulk historical imports from its episode feed, while keeping those episodes available through search and episode listings.

