# Geospect

> Geospect is a Japanese-language catalog and preview service for public map and GIS open data in Japan.

Geospect helps users search public geospatial datasets, preview them on a web map before downloading, and navigate to official source pages, terms, licenses, and distribution pages. The service is not an official source and does not replace the latest information published by each data provider.

## Primary Pages

- [Home](https://geospect.jp/) - Service overview and entry points for map preview and dataset search.
- [Map](https://geospect.jp/map/) - Interactive map for previewing available layers.
- [Catalog](https://geospect.jp/catalog/) - Searchable catalog of Japanese public map and GIS datasets.
- [Data Sources](https://geospect.jp/data-sources/) - Provider, attribution, rights, and source-page guidance.
- [AI Agent Data Access](https://geospect.jp/ai-agents/) - llms.txt, sitemap, and MCP setup for AI agents.

## Dataset Detail Formats

- HTML detail pages: `https://geospect.jp/catalog/{code}`. Each page embeds schema.org `Dataset` JSON-LD, plus related `WebPage`, `WebSite`, `Organization`, and `DataCatalog` JSON-LD.
- Markdown detail pages: `https://geospect.jp/catalog/{code}.md`. These pages are generated from the same public catalog metadata and are intended for LLM-readable summaries.
- The `{code}` value is the public layer URL code used by catalog detail links. Discover codes from the catalog page, HTML detail URLs in the sitemap, or MCP search.
- Markdown detail pages are intended for dataset overview, official links, usage cautions, attribution/source notes, attribute descriptions, and map guidance.
- Official provider pages, distribution pages, specifications, and terms remain authoritative when they differ from Geospect summaries.

## Machine-Readable Entry Points

- [Sitemap](https://geospect.jp/sitemap-index.xml) - Search crawler sitemap index for public HTML pages.
- Markdown detail URL pattern: `https://geospect.jp/catalog/{code}.md`.

## MCP

- Endpoint: `https://mcp.geospect.jp/mcp`
- Public read-only tools: `search_datasets` and `get_dataset_detail`.
- Use MCP for public catalog discovery, dataset detail lookup, and map guidance. It is not an official data download API, extraction API, or license-decision API.
- Official provider pages, distribution pages, specifications, and terms remain authoritative.

## Policies And Caveats

- [Terms](https://geospect.jp/terms/) - Service terms and limits.
- [Privacy Policy](https://geospect.jp/privacy/) - Privacy and external service handling.
- [Notices](https://geospect.jp/notices/) - Important cautions about previews, official decisions, and source accuracy.
- [Contact](https://geospect.jp/contact/) - Corrections, removal requests, license concerns, and other contact.

## Dataset Coverage

The catalog includes datasets from Japanese national and local public sources such as MLIT National Land Numerical Information, Geospatial Information Authority of Japan, e-Stat, Japan Meteorological Agency, and local government open-data portals. Dataset detail pages and preview pages should be treated as navigation and inspection aids; official source pages and official terms remain authoritative.