# みちよみ (michiyomi)

> 東京の街路写真191万枚（市民が撮影して Mapillary に公開したもの）を、AIが日本語で言語化したデータです。地図やオープンデータに載っていない「街の実際の様子」（歩道の幅・路面標示・看板・植え込み・建物など）を、座標・通り・町丁目で引けます。REST API と MCP サーバーは登録・APIキー不要で、読み取り専用です。観測データは CC BY 4.0 で、AIの回答・アプリ・転記に出典の表示は要りません。
>
> Japanese street-level observations of Tokyo: 1.91 million public street photos (Mapillary) described by vision-language models. Free REST API and MCP server — no key, no sign-up, read-only. Observation data under CC BY 4.0; no credit needed in AI answers, apps or quotes.

## 重要な事実

- 収録: 東京都全域（23区は複数年、多摩・島しょは最新年中心）。1,914,490シーンを言語化し、1,914,451シーンを公開（release 2026-09-13-r1、データ時点 2026-09-13）。最新の値は GET https://michiyomi.dev/v1/meta で確かめること。
- できること: 地点の近くの街路の様子、通り（線）と町丁目（面）の「カルテ」、同じ地点の経年変化（別のAIセッション（同じ系列のモデル）が反証を試みても崩れなかったものだけ）、1シーンの言語化の全文と来歴。
- どの記述にも、撮影年・言語化したAIの世代（generation）・データの版が付く。画像IDから元の写真まで遡れる。
- 幅・車線数などの数値は、1枚の画像からの推定（confidence 付き）で、実測ではない。
- 「なし」「不明」「画角外不明」を区別している。データに無いことを推測で埋めないこと。
- 撮影時点の様子であり、いまの状態とは限らない。リアルタイムの情報ではない。
- 収録が0件の場所は「何もない場所」ではなく「撮影がない場所」。
- 東京都の外のデータはない。
- レート制限: IP単位で REST 300回/60秒、MCP 120回/60秒（超えると 429 と retry-after）。一括の分析には Hugging Face の Parquet を使うこと。
- 提供条件: 無償。稼働の保証（SLA）はない。

## MCP（AIエージェント向け・キー不要）

- サーバー: https://michiyomi.dev/mcp （Streamable HTTP・ステートレス。POST で JSON-RPC を送る）
- Claude Code: `claude mcp add --transport http michiyomi https://michiyomi.dev/mcp`
- Codex CLI: `codex mcp add michiyomi --url https://michiyomi.dev/mcp`
- クライアント別の設定手順: https://michiyomi.dev/agent-setup.md
- ツール（11）: get_metadata, coverage, describe_location, get_scene, changes_near, describe_street, describe_area, find_street, find_area, find_school, find_amenities
- 使う順番: 地名は find_street / find_area / find_school で ID や座標にする → coverage でその場所に収録があるか確かめる → describe_location（地点）・describe_street（通り）・describe_area（町丁目）・changes_near（経年変化）で中身を引く → 詳しくは get_scene。
- 言葉の印象で探す専用のMCP（風景を探す）: https://michiyomi.dev/explore/mcp （キー不要）。ツール: search_metadata（区市町村・プリセット・上限）、search_scenes（「懐かしい路地」「夏っぽい」のような風景・印象で探す。日本語の根拠・撮影年・出典・続きの取得）、get_scene（選んだ写真の観測全文）。場所が決まっているときは本体の /mcp、場所を決めずに風景で探すときはこちら。
  - Claude Code: `claude mcp add --transport http michiyomi-scenery https://michiyomi.dev/explore/mcp`

## REST API

- [ドキュメント](https://michiyomi.dev/docs/): クイックスタート・3つの使い方
- [APIリファレンス](https://michiyomi.dev/docs/api/): エンドポイントごとのパラメータ・例
- [AIから使う](https://michiyomi.dev/docs/ai/): MCPのつなぎ方・ツール・守ること
- [データの読み方](https://michiyomi.dev/docs/data/): 3つの層(記録・計算・AIの読み取り)・世代・確度・「なし」「不明」「画角外不明」・被覆・カルテ・経年変化
- [出典・ライセンス](https://michiyomi.dev/docs/license/): 貼れる出典文・写真を出すときの決まり
- [言語化モデル OddEye](https://michiyomi.dev/docs/model/): 比べた結果・弱いところ・使い方(公開データは OddEye で作っていない)
- [OpenAPI（日本語）](https://michiyomi.dev/openapi.yaml) / [OpenAPI（English）](https://michiyomi.dev/openapi.en.yaml)
- [GET /v1/meta](https://michiyomi.dev/v1/meta): 公開中の版・件数・ライセンス
- 主なエンドポイント: /v1/coverage, /v1/scenes/nearby, /v1/scenes/{id}, /v1/changes/nearby, /v1/streets/nearby, /v1/streets/search, /v1/streets/{street_id}, /v1/areas/at, /v1/areas/nearby, /v1/areas/search, /v1/areas/{town_key}
- 例: `curl "https://michiyomi.dev/v1/scenes/nearby?lat=35.6717&lon=139.7647&radius_m=150&limit=5"`

## ライセンス

- 観測データ（文章・構造化データ・経年変化）は CC BY 4.0。AIの回答・分析・アプリの表示・個別の転記には、出典もロゴも要らない。継承（同じ条件での公開）も求めない。
- データとして配り直すとき（ファイル・データベース・第三者向けの API など）だけ、応答の license.attribution を表示する。例: 出典: みちよみ(michiyomi.dev、Mapillary の街路写真より)、CC BY 4.0
- 座標・撮影日時・画像IDは Mapillary 由来の参照情報。1件ずつ使うのは自由だが、みちよみは許諾しない（まとめて配るときは各自で確認）。
- 写真は応答に含まれない。写真を表示するときは撮影者（image_page へのリンクで可）と CC BY-SA 4.0 を示す。
- 通り・町丁目は OpenStreetMap の派生データベース（ODbL 1.0）。通りの結果を人に見せるときは「© OpenStreetMap contributors」を添える。
- 撮影年を添えて答える（ライセンスの条件ではなく、正確さのため）。
- 詳しくは https://michiyomi.dev/docs/license/

## 関連

- [データセット（Hugging Face・Parquet）](https://huggingface.co/datasets/finalvent/michiyomi-tokyo-streetscape): 公開スナップショット。API全件とは更新時点が異なることがある。
- [3D都市モデル(PLATEAU)に結んだデータ（Hugging Face）](https://huggingface.co/datasets/finalvent/michiyomi-tokyo-plateau): PLATEAU の建物・道路など72.7万件の地物に、みちよみの記述を地物ID（gml_id）で結んだ表（62区市町村、紐づけ1,862万件）。PLATEAU の形は含まない。手元の CityGML に書き込むツールつき。
- [言語化モデル OddEye 0.1 27B](https://huggingface.co/finalvent/OddEye-0.1-27B-NVFP4): 街路写真1枚から日本語の構造化された観測記録を書く、みちよみ専用のモデル（実験版・Apache-2.0）。このAPIの公開データを作った本番の手順とは別のモデル。
- [地図](https://michiyomi.dev/map/): 写真・通り・町丁目・経年変化を1つの地図で(`?street=` `?area=` `?scene=` `?change=` で直接開ける)
- [しくみ](https://michiyomi.dev/how/)
- [技術白書](https://michiyomi.dev/docs/whitepaper)
- [トップページ](https://michiyomi.dev/) / [English](https://michiyomi.dev/en/)
- 問い合わせ・掲載の削除依頼: contact@michiyomi.dev