# 風土記 API Docs

> 町の家計簿を作る。自治体の歳出の予算・決算を事業の単位まで集約したデータを、MCP と REST で取得するための文書。

## Docs

- [はじめに](https://docs.fudoki.dev/): 町の家計簿を作る。

## 接続・使い方

- [MCP で使う](https://docs.fudoki.dev/mcp): AI クライアントに風土記の MCP サーバーを登録し、会話から歳出のデータと事業の評価資料の所在を問い合わせる。
- [REST で使う](https://docs.fudoki.dev/rest): https://api.fudoki.dev に JSON で問い合わせ、歳出の木のノードを検索・取得する。
- [ChatGPT・Claude などで使う](https://docs.fudoki.dev/plugins): AI クライアントへの接続方法と plugin の導入方法。

## データ

- [データの読み方](https://docs.fudoki.dev/data): 資料区分・歳出の木・軸・COFOG の意味と、金額を足すときの条件。

## ヘルプ

- [サポート](https://docs.fudoki.dev/support): 接続の相談、不具合、データの訂正を報告する方法。

## Reference

- [風土記 API](https://docs.fudoki.dev/reference): 町の家計簿を作る。自治体の歳出の予算・決算を事業の単位まで集約したデータ。

### Operations

- [死活確認](https://docs.fudoki.dev/reference/operations/health): Worker が応答できるかだけを返す。D1 は読まず、kill switch の状態に依らず 200 を返す。 Reference for the GET /health endpoint in the 風土記 API.
- [団体と収録範囲](https://docs.fudoki.dev/reference/operations/list-jurisdictions): 団体（自治体）の名称・6桁の団体コード・都道府県と、その団体の収録範囲（明細を検索できる年… Reference for the GET /v1/jurisdictions endpoint in the 風土記 API.
- [歳出の木のノードの検索](https://docs.fudoki.dev/reference/operations/search-expenditure-nodes): 歳出の木のノード（款・項・目と、節・備考など別の軸の内訳）を条件で絞って一覧す… Reference for the POST /v1/expenditure/nodes:search endpoint in the 風土記 API.
- [歳出のノード一つと軸ごとの子](https://docs.fudoki.dev/reference/operations/get-expenditure-node): ノード一つ（document_kind と node_id… Reference for the GET /v1/expenditure/nodes/{document_kind}/{node_id} endpoint in the 風土記 API.
- [列の説明と金額の和の条件](https://docs.fudoki.dev/reference/operations/describe-expenditure-columns): 歳出の木の列の説明と、金額を足すときの条件（sum_rules）、検索の入力の例（search_exam… Reference for the GET /v1/expenditure/columns endpoint in the 風土記 API.
- [事業の評価の頁の所在の検索](https://docs.fudoki.dev/reference/operations/search-evaluations): 団体と評価対象年度（評価された実績の決算の年度）を指定して、事業の評価が書かれた頁の… Reference for the POST /v1/evaluations:search endpoint in the 風土記 API.
- [原典 PDF の表示用中継](https://docs.fudoki.dev/reference/operations/get-origin-pdf): 原典 ID が指す自治体の公開 PDF を中継する。32… Reference for the GET /v1/origins/{origin_id}/pdf endpoint in the 風土記 API.

## Agent skills

- [api-docs](https://docs.fudoki.dev/.well-known/agent-skills/api-docs/SKILL.md): Read the 風土記 API Docs instead of answering from memory. 町の家計簿を作る。自治体の歳出の予算・決算を事業の単位まで集約したデータを、MCP と REST で取得するための文書。 Use when a task involves 風土記 API Docs: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://docs.fudoki.dev/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://docs.fudoki.dev/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://docs.fudoki.dev/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://docs.fudoki.dev/openapi.json.
- [Agent skills](https://docs.fudoki.dev/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://docs.fudoki.dev/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://docs.fudoki.dev/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://docs.fudoki.dev/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://docs.fudoki.dev/sitemap.xml): Every indexable page URL with its last-modified date.