How to Use GovInfo publication search in Gemini CLI
Returns matching federal publications and document sections from GovInfo. Use it for topic research across publication series when you do not already have an exact document identifier.
Prompts to try with GovInfo publication search in Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
Use GovInfo publication search to find federal publications about broadband deployment from 2024, then add a reading-list fixture with the returned titles and document links.
Use GovInfo publication search to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from GovInfo publication search and tell me what changed since last week.
Check GovInfo publication search and summarize what you find in three bullet points.
Pull the newest data from GovInfo publication search and give me the result as a table.
How to set up GovInfo publication search in Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run GovInfo publication 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": "govinfo-gov/legislation/search", "input": { "query": "<query>" } }'
Then paste one of the prompts above: Gemini CLI finds GovInfo publication search on Spiral, shows the price and runs it.
GovInfo publication search providers and prices
Spiral runs GovInfo publication search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Gemini CLI for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Page | a number from 0 | 0 | 0-based page index; pass |
| Page size | 1 to 50 | 10 | page_size |
| Historical | on or off | Include superseded (historical) editions. The site default is true; false keeps only current documents. |
Every API field of GovInfo · Search is on its tool page: open its card above.
What can you do with GovInfo publication search in Gemini CLI?
Build a federal publication reader with U.S. Code navigation, source text, and edition comparisons. A coding agent can use GovInfo documents to populate the interface and connect each passage to its publication metadata.
Build a federal statute research reader
Create a reader that starts with publication selection, lets researchers explore the U.S. Code, and opens cited sections with their metadata and text. Add edition selection for historical comparisons and topic search for discovery.
Prepare a legislative research packet
Choose publication series, find documents about a policy topic, and organize the relevant U.S. Code provisions by chapter. Include document metadata, readable text, and selected historical editions for a reviewer.
Create a federal legal research lesson
Build an exercise around a public statute: identify its publication collection, locate its chapter, search for related publications, and retrieve a cited section. Have students compare selected editions and distinguish document metadata from document text.
Assemble an edition-specific reference archive
Select federal publication collections and collect the documents needed for a policy handbook. Organize U.S. Code sections within their titles, preserve publication metadata and text, and include earlier editions where the handbook discusses changes.
Find federal publications on a policy topic
Identify relevant publication series, search their metadata and full text, and prepare a reading list with document details and selected passages. Keep the publication series visible so readers can distinguish the sources.
More on GovInfo publication search and Gemini CLI
Overview
GovInfo publication search in other agents
Questions about GovInfo publication search in Gemini CLI
Can Gemini CLI use GovInfo publication search?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run GovInfo publication search like any built-in tool.
How much does GovInfo publication 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 GovInfo publication search in Gemini CLI?
No. Spiral runs GovInfo publication 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 GovInfo publication search in Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while GovInfo publication search runs?
GovInfo publication search runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.
Does GovInfo include every government document?
GovInfo covers official publications from all three branches of the federal government. Its search only includes documents stored on GovInfo, so it is not a complete index of everything government agencies publish.
How far back does GovInfo's U.S. Code archive go?
GovInfo provides virtual main editions of the U.S. Code from 1994 onward. You can browse them by year and then title.
How often is the U.S. Code updated?
The publication cycle includes a new main edition every six years and annual supplements. A GovInfo edition is a published snapshot, so choose the edition deliberately when comparing statutory wording.
Does a recent modification date mean a publication is new?
GovInfo's lastModified value records when a package was added or updated. It differs from the publication date, so a recent modification alone does not establish when the document was issued.
Is every document available in the same formats?
Most GovInfo documents are available as PDF and text. Other formats depend on the publication, and the document details page identifies the available files.
Start using GovInfo publication 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 https://spiral.ai/SKILL.md


