Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · News & Media

How to Use NASA media search in Gemini CLI

Finds NASA images, videos, and audio through indexed metadata, returning matching records with descriptions and preview links. Use it to shortlist material by mission or subject before retrieving an item's files.

Prompts to try with NASA media search in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

Use NASA media search to find Apollo 11 lunar surface material and add a gallery to this project showing returned titles, descriptions, and preview links.

NASA media searchGemini CLI
Try asking
  • Use NASA media search for James Webb Space Telescope and create a local JSON collection of returned titles, NASA IDs, creation dates, and descriptions.

  • Use NASA media search for Kennedy Space Center rocket launch and populate this project's media picker with returned records and previews.

  • Use NASA media search to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from NASA media search and tell me what changed since last week.

How to set up NASA media search 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:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run NASA media 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": "images-nasa-gov/media/search_media",
        "input": {
          "q": "<q>"
        }
      }'

Then paste one of the prompts above: Gemini CLI finds NASA media search on Spiral, shows the price and runs it.

NASA media search providers and prices

Spiral runs NASA media search through Alexandria. Open a card for today's price, with every fee included.

AlexandriaNews & Media
NASA Image and Video Library · Search media
images-nasa-gov/media/search_media

Settings you can ask for

Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Year end1900 to 2100

year_end

Page size1 to 5010

page_size

Media typeaudio, image, video, or allaudio

Media type to return; defaults to audio.

Year start1900 to 2100

year_start

Include fileson or off

Resolve preview_url/download_url for audio and video hits (one manifest request per hit). Images always carry them.

Every API field of NASA Image and Video Library · Search media is on its tool page: open its card above.

What can you do with NASA media search in Gemini CLI?

Build a NASA media browser that pairs searchable mission records with downloadable files. Use descriptions for selection and asset manifests for the available renditions.

Illustrate a space history lesson

Find Apollo 11 material, select records using their descriptions, and retrieve available files for a classroom presentation.

Prepare documentary research

Shortlist mission images, video, and audio, then collect download links for an editor to review alongside the source descriptions.

Build a mission anniversary exhibit

Research Space Shuttle or Apollo material and retrieve image renditions for exhibit planning, with source credits kept beside each selection.

Source illustrations for science reporting

Find media related to a mission covered in an article, review its description, and obtain the available files for editorial selection.

Create a browsable NASA media collection

Use search records to organize a subject collection and asset manifests to offer available downloads for selected items.

Refresh a museum's media shortlist

Repeat searches for Artemis or Mars exploration, identify previously unseen records, and retrieve their file manifests for curatorial review.

Questions about NASA media search in Gemini CLI

Can Gemini CLI use NASA media search?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run NASA media search like any built-in tool.

How much does NASA media search cost in Gemini CLI?

$0.00873 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 NASA media search in Gemini CLI?

No. Spiral runs NASA media 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 NASA media search in Gemini CLI?

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

Does Gemini CLI wait while NASA media search runs?

NASA media search runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

Does the library contain every NASA image, video, and recording?

No. NASA explicitly describes it as a selection of publicly available material rather than a comprehensive archive, so an absent item does not establish that NASA has no such media.

Are additions always newly created media?

No. NASA continually adds both new and archival material, so a newly added item can document a much older event.

Are downloads limited to preview images?

No. The library offers multiple download resolutions, and NASA's documented asset manifest includes an original image alongside smaller renditions.

Can schools and publishers reuse NASA media?

NASA generally permits educational and informational use under its media guidelines. Its content generally is not subject to copyright in the United States, but that statement is not a blanket clearance for every item.

Is everything in the library NASA-owned material?

No. NASA sometimes publishes third-party copyrighted material and identifies the copyright holder. Reusing those items requires permission from that holder.

Get started

Start using NASA media search in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options