yandex-maps-v3 skill
A reference and recipe skill for the Yandex Maps JS API v3: markers, clustering, search, geocoding and React/Next.js, plus the coordinate-order gotcha
- 1 ★ on the repository
- Last commit
Minimal access
Why this level
- Reference material only; it makes no requests and changes no data
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/yandex-maps-v3Detects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- Reference material only; it makes no requests and changes no data
This is third-party code. Review the repository files before installing.
What it does
The skill compiles a reference for the Yandex Maps JavaScript API v3 (ymaps3): script loading and the API key, the longitude-latitude coordinate order that differs from Leaflet and Google, the YMap class, layers and data sources, markers, controls, YMapListener events, hints and popups, the @yandex/ymaps3-clusterer marker clusterer, themes and geolocation, plus the React and Next.js reactify pattern with an SSR-safe dynamic import. A separate file covers the related HTTP APIs: Geosuggest for address autocomplete, forward and reverse geocoding, place search and route building, each with its own key. It also covers polygons and route lines, draggable markers, viewport-based marker loading and v2-to-v3 migration.
Who it is for. For frontend developers embedding Yandex Maps into a web, React or Next.js application.
Good fit when
- You need to quickly wire up a map with markers, popups or clustering
- The map shows the wrong place: the coordinate order is likely swapped
- You need a recipe for React or Next.js App Router with a correct SSR-safe import
Not a fit when
- Your project uses Yandex Maps API v2: this reference is entirely about v3 and ymaps3
- You need help with something other than maps: the skill is narrowly about the maps JS API and the related search and routing HTTP APIs
Example request
Add markers with a popup and clustering to the map in my Next.js app for a list of pointsLimitations
No license is declared in the repository. The skill is reference material; it does not write or validate map code itself, only supplies context to the agent. A personal Yandex Maps API key is required, and key activation can take up to 15 minutes.
How to disable. Delete the skill folder from .claude/skills or the equivalent agent directory.
FAQ
Why does the map show the wrong place?
The coordinate order is most likely swapped; v3 uses [longitude, latitude] everywhere, unlike Leaflet and Google's [latitude, longitude].
Does one key cover everything?
No, the search, geocoder and routing HTTP APIs each have their own separate key, in addition to the map JS API key.
Discussion
No questions or reviews yet.
Related
All Yandex Maps toolsA local SEO audit skill for the CIS market: business cards in Google Business Profile, Yandex Business, Yandex Maps, 2GIS and their consistency
An MCP server for Yandex Maps: forward and reverse geocoding and static map rendering with placemarks
Monorepo of Yandex MCP servers: Direct, Metrica, Webmaster, Wordstat, Tracker, 360, Maps, SpeechKit, YandexGPT and AppMetrica
An MCP server for pre-project land analysis: Rosreestr boundaries, Yandex geocoding and maps, infrastructure and geometry
A self-hosted MCP server on Cloudflare Workers for local SEO: organization search and cards in 2GIS, Yandex Geocoder and Google Places
An MCP server that fuses three transit sources, Mosgortrans, the Moscow region RNIS system and Yandex Transport, reconciling arrival predictions
README in short
The short README describes the skill as a complete reference and integration guide for the Yandex Maps JS API v3 across web, React and Next.js. It lists coverage: the loader and key, coordinate order, YMap and layers, markers, controls, events, hints, the clusterer, themes, geolocation and the reactify pattern. It gives the file structure: SKILL.md as the entry point and a reference folder with api.md, packages.md, recipes.md and search-geocode-routing.md. Install is a single npx skills add command.
README badge
Original SKILL.md
---
name: yandex-maps-v3
description: >-
Complete reference and integration guide for the Yandex Maps JavaScript API
v3 (ymaps3), script loader and API key, the [longitude, latitude] coordinate
order, YMap / layers / data sources, markers (custom DOM + YMapDefaultMarker),
controls (zoom, geolocation, buttons, YMapOpenMapsButton), YMapListener events,
hints and popups, the @yandex/ymaps3-clusterer marker clusterer, themes
(dark/light), geolocation, behaviors, and the React/Next.js reactify pattern
(App Router, SSR-safe dynamic import). Also covers the separate HTTP API
products, Geosuggest (address autocomplete), Geocoder (forward and reverse),
Places/POI search, and Routing (build and draw routes), plus YMapFeature
polygons/polylines, draggable markers, viewport-based marker loading at scale,
satellite/raster layers, scheme customization, and v2 to v3 migration.
---
# Yandex Maps JavaScript API v3 (ymaps3)
The modern (v3) Yandex Maps web SDK. Vector-first, promise-based, modular
(extra features loaded via ymaps3.import('@yandex/...')), with a first-class
React wrapper (reactify).
THE #1 GOTCHA: Yandex v3 uses [longitude, latitude] order
everywhere (center, coordinates, bounds). This is the OPPOSITE of
Leaflet/Google ([lat, lng]). Mixing them puts Tashkent in the ocean.
Toshkent center = [69.2797, 41.3111].
For exhaustive detail load the bundled references:
- reference/api.md, every class/type with props.
- reference/recipes.md, copy-paste Next.js App Router patterns.
- reference/packages.md, importable @yandex/* modules.
- reference/search-geocode-routing.md, the separate HTTP APIs.
## 1. API key
Get a "JavaScript API and Geocoder" key at
https://developer.tech.yandex.com/ (or developer.tech.yandex.ru).
Activation takes up to 15 minutes.