# Nuqs

> nuqs (Type-safe URL search params state manager for React / Next.js) リファレンス。 useQueryState, useQueryStates, parsers (parseAsString / parseAsInteger / parseAsBoolean / parseAsArrayOf 等)、 Next.js App Router / Pages Router、SSR、シャロールーティング、history 制御。 createSerializer, createStandardSchemaV1, inferParserType ユーティリティ、URL 長さ制限 (limits)。

- Skill: `fandhe-ai-agent-reference-skil/nuqs` (Agent Skill, multi-file: 34 files)
- Install (CLI): `npx skillmds@latest add fandhe-ai-agent-reference-skil/nuqs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fandhe-ai-agent-reference-skil/nuqs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: fandhe-ai (https://skillmd.com/u/fandhe-ai-agent-reference-skil)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/fandhe-ai-agent-reference-skil/nuqs

---


# nuqs API リファレンス

nuqs — Type-safe URL query state management for React。
`React.useState` のドロップイン置換として URL クエリパラメータと状態を同期する。

## ディレクトリ構成

```text
skills/nuqs/
  SKILL.md
  references/
    hooks/
      README.md
      useQueryState.md
      useQueryStates.md
    parsers/
      README.md
      built-in.md
      custom.md
    options/
      README.md
      options.md
    server/
      README.md
      server-side.md
    utilities/
      README.md
      createSerializer.md
      createStandardSchemaV1.md
      inferParserType.md
    limits/
      README.md
      limits.md
  samples/
    README.md
    basic-query-state.md
    typed-state-with-parsers.md
    multiple-params-batch-update.md
    search-filter-debounce.md
    server-side-parsing.md
    search-params-cache.md
    adapter-setup.md
    custom-parser.md
    url-key-remapping.md
    array-params.md
    testing.md
  scripts/
    README.md
    install.md
    setup.md
    testing.md
    debug.md
```

## 探索手順

タスクからカテゴリを引き、カテゴリの README.md で目的のページを特定する:

1. 下記マッピング表でタスクに対応するカテゴリを探す
2. そのカテゴリの `references/{category}/README.md` を参照して目的のページを特定する
3. 該当ページの `.md` を Read して詳細を確認する

## タスク → カテゴリ マッピング

| タスク | カテゴリ | 参照 README |
|--------|---------|------------|
| useQueryState の基本的な使い方、単一パラメータの読み書き | hooks | [references/hooks/README.md](references/hooks/README.md) |
| useQueryStates でバッチ更新、複数パラメータの同期 | hooks | [references/hooks/README.md](references/hooks/README.md) |
| ビルトインパーサー（parseAsString / parseAsInteger / parseAsBoolean / parseAsArrayOf 等）の使い方 | parsers | [references/parsers/README.md](references/parsers/README.md) |
| createParser でカスタムパーサーを作成する | parsers | [references/parsers/README.md](references/parsers/README.md) |
| history, shallow, scroll, throttle, debounce, clearOnDefault, startTransition オプション設定 | options | [references/options/README.md](references/options/README.md) |
| createLoader, createSearchParamsCache でサーバーサイド解析 | server | [references/server/README.md](references/server/README.md) |
| createSerializer, createStandardSchemaV1, inferParserType でパーサーからユーティリティを生成する | utilities | [references/utilities/README.md](references/utilities/README.md) |
| URL 長さ・ブラウザ制限（throttling, max URL length）を知りたい | limits | [references/limits/README.md](references/limits/README.md) |
| 典型的な使い方を知りたい | samples | [samples/README.md](samples/README.md) |
| インストール・CLI コマンド・テスト・デバッグ手順を知りたい | scripts | [scripts/README.md](scripts/README.md) |