# Search

> Find FRED economic series IDs by keyword through the fred-client CLI. Use when a user knows the economic concept but not its FRED series ID, or asks to search FRED for GDP, unemployment, inflation, interest rates, exchange rates, or another series. Trigger phrases: FRED series 찾기, FRED 코드 찾아, 경제지표 검색, find FRED series, search FRED, FRED series ID.

- Skill: `seokhoonj/search-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add seokhoonj/search-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/seokhoonj/search-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: seokhoonj (https://skillmd.com/u/seokhoonj)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/seokhoonj/search-2

---


# FRED series search

Call the fred-client package's CLI and relay its JSON result. Keep all search and API logic in
the package rather than reimplementing it in the skill.

## Prerequisite

Install fred-client and configure a FRED API key:

```sh
pipx install fred-client
export FRED_API_KEY=...
```

The key may instead be stored in `~/.config/fred-client/credentials.json` as
`{"FRED_API_KEY": "..."}`.

## Run

```sh
fred search "<SEARCH_TEXT>" [--limit NUMBER] --json
```

1. Preserve the user's search phrase; quote it when it contains spaces.
2. Use `--limit` only when the user requests a result count.
3. Show the returned series IDs and titles. Point out the best match without hiding alternatives.
4. If the user next wants metadata, use the metadata skill. For values over time, use fetch.
5. Relay a nonzero CLI error concisely. A missing command means fred-client is not installed; a
   missing or rejected key requires installing/configuring the package, not changing the skill.

