Drag a Timeline Across 2,400 Years of Chinese History on This Static Map
The project demonstrates how a static site can expose AI-queryable interfaces without a backend, and its license split shows that open-source code does not mean open data. Developers reusing the map need to check per-dataset restrictions before commercial use or redistribution.
Jiangshan Chronicles (jiangshan-map) is a pure static interactive atlas that lets you drag a timeline from 403 BC, the year the Jin state split into three, all the way to today. The map redraws territories, rivers, walls, and canals as the era shifts, and clicking an ancient city reveals its evolution across 18 periods. A person search traces individual journeys, and multi-person searches mark where paths intersected, like the meeting of Li Bai, Du Fu, and Gao Shi. The repo has roughly 7,300 stars and is still actively updated as of November 2026.
Beyond the human-facing interactions, the project ships three ways for AI agents to query it: a zero-dependency local MCP server with inspect_place, inspect_person, and search_atlas tools; an Agent Skill with a CLI script that generates maps for a given year and place; and an llms.txt file plus a URL protocol that embeds map views. The browser exposes window.atlasAPI and WebMCP as well. The README explicitly says the map boundaries are illustrative approximations, not authoritative survey results.
Licensing is split: code and self-drawn data are GPL-3.0, but prefecture boundaries from CHGIS V6 and Hartwell GIS are academic non-commercial only, no redistribution, and are not included in default GeoJSON exports. GeoJSON export only covers 403 BC to 1948 and omits modern province boundaries. Deployment is a static server or Docker with nginx:alpine, and embedding works through URL parameters, though WeChat, Zhihu, and Xiaohongshu block iframes.
The project's three AI entry points (MCP, Agent Skill, llms.txt) are a concrete example of how a static site can serve AI agents without a backend, a pattern worth copying for other content-heavy projects.
The license split between GPL code and academically restricted prefecture data is a reminder that open-source repositories can mix permissive and restricted assets; the default-on exclusion of prefecture boundaries in GeoJSON exports is a sensible safeguard.
The explicit disclaimer that boundaries are illustrative avoids the trap of presenting historical maps as authoritative, which is important given how easily such visualizations get cited as fact.
Suggestion: add the Xia, Shang, and Western Zhou periods, and including the Three Sovereigns and Five Emperors era would make it even more perfect.