@ikeytz/maps-mcp 1.0.5 → 1.0.6

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 1.0.6
+
+- Same 42 command names as `@ikeytz/mcp`. Maps data live; prices/FAQ/ratgeber/wissen/auswahl = www URL only.
+- `site_overview`, `list_nav`, `resolve_locale_url`, `get_llms_txt`, `compose_*`, …
+
 ## 1.0.5
 
 - CLI structure aligned with `@ikeytz/mcp`: `help`/`list` ASCII table (TOOL │ ARGS │ EXAMPLE), `list --global`, `-V`/`version`/`serve`.

package/README.md

@@ -4,7 +4,7 @@ Official **terminal CLI** and **MCP stdio proxy** for [maps.ikeytz.com](https://
 
 **Remote SSOT:** `https://maps.ikeytz.com/mcp`  
 **MCP Registry:** `com.ikeytz/maps` (v1.0.1)  
-**npm:** `@ikeytz/maps-mcp@1.0.5`  
+**npm:** `@ikeytz/maps-mcp@1.0.6`  
 **MCP scope (server):** read/link only · `ai-train: no`  
 **Auth:** public read-only MCP — no account, no API key · HTTPS POST to `/mcp`  
 **License:** proprietary — `LicenseRef-ikeytz-terms` (see [LICENSE](https://unpkg.com/@ikeytz/maps-mcp/LICENSE); install & use OK; no training)
@@ -20,7 +20,7 @@ Official **terminal CLI** and **MCP stdio proxy** for [maps.ikeytz.com](https://
 | Version | `1.0.1` |
 | Status | active |
 | Website | https://maps.ikeytz.com |
-| npm package | `@ikeytz/maps-mcp` **1.0.5** |
+| npm package | `@ikeytz/maps-mcp` **1.0.6** |
 | Remote | Streamable HTTP `https://maps.ikeytz.com/mcp` |
 | Card | https://maps.ikeytz.com/.well-known/mcp/server-card.json |
 | Search | https://registry.modelcontextprotocol.io/v0.1/servers?search=com.ikeytz/maps |
@@ -35,7 +35,7 @@ Official **terminal CLI** and **MCP stdio proxy** for [maps.ikeytz.com](https://
     {
       "registryType": "npm",
       "identifier": "@ikeytz/maps-mcp",
-      "version": "1.0.5",
+      "version": "1.0.6",
       "runtimeHint": "npx",
       "transport": { "type": "stdio" }
     }
@@ -74,7 +74,7 @@ Install (Mac/Linux/Windows):
 
 ```bash
 npm i -g @ikeytz/maps-mcp
-ikeytz-maps-mcp --version   # z. B. 1.0.5
+ikeytz-maps-mcp --version   # z. B. 1.0.6
 ikeytz-maps-mcp update      # später: npm i -g @ikeytz/maps-mcp@latest
 ```
 
@@ -131,7 +131,7 @@ ikeytz-maps-mcp get_service_area --slug=pattonville --raw
 ikeytz-maps-mcp                 # MCP stdio proxy (any MCP host) — keine Args
 ikeytz-maps-mcp help            # Usage + Flags + Tool-Tabelle (offline)
 ikeytz-maps-mcp update [ver]    # npm i -g @ikeytz/maps-mcp@latest
-ikeytz-maps-mcp list            # 33 Tools (offline) + global CLI flags
+ikeytz-maps-mcp list            # alle Tools (offline) + global CLI flags
 ikeytz-maps-mcp list --global   # nur globale Flags
 ikeytz-maps-mcp describe NAME   # = ikeytz-maps-mcp NAME -h
 ikeytz-maps-mcp call NAME …     # oder: ikeytz-maps-mcp NAME …
@@ -166,25 +166,60 @@ Diese Flags sind **Terminal-CLI**. MCP Inspector / Cursor zeigt nur **Tools**, k
 - **`google_maps` / `icbm`:** Komma-Form wie in `/llms-orte-geo.txt`  
 - Volltext Geo: `ikeytz-maps-mcp get_discovery --which llms-orte-geo`
 
-## Alle 33 Tool-Befehle
+## Alle Tool-Befehle (42 www-Namen + maps-Extras)
+
+Dieselben **42 Namen** wie `ikeytz-mcp`. maps-Daten live. Preise/FAQ/Ratgeber/Wissen/Auswahl = **www-URL**, kein www-Corpus.
 
 | Befehl | Argumente |
 |--------|-----------|
-| `list_service_areas` | — |
-| `get_service_area` | `--slug` `--plz` `--name` (ein Treffer; PLZ = erster) |
-| `get_geo_office` | — |
-| `get_contact` | — |
+| `site_overview` | `--locale` |
+| `get_business_identity` | `--locale` |
+| `list_nav` | `--locale` |
+| `list_footer` | `--locale` |
+| `list_locales` | — |
+| `resolve_locale_url` | `--path*` `--locale*` |
+| `get_prices` | `--locale` (www-Link) |
+| `get_invoice_line_items` | `--situationKey*` `--whenKey` `--breakdown` `--locale` (www-Link) |
+| `list_services` | `--locale` (www-Link) |
+| `get_emergency` | `--locale` (www-Link) |
+| `list_auswahl` | `--locale` (www-Link) |
+| `get_auswahl_item` | `--slug*` `--locale` (www-Link) |
+| `list_service_areas` | `--locale` |
+| `get_service_area` | `--slug` `--plz` `--name` `--locale` |
+| `get_geo_office` | `--locale` |
+| `get_contact` | `--locale` |
+| `get_legal` | `--doc*` `--locale` |
+| `get_about` | `--locale` |
+| `get_partner_info` | `--locale` (www-Link) |
+| `get_links` | `--locale` |
+| `get_review_url` | `--locale` (www-Link) |
+| `list_faq` | `--locale` (www-Link) |
+| `get_faq` | `--id` `--q` `--locale` (www-Link) |
+| `list_wissen` | `--locale` (www-Link) |
+| `get_wissen_entry` | `--id*` `--locale` (www-Link) |
+| `list_ratgeber` | `--locale` (www-Link) |
+| `get_ratgeber` | `--slug*` `--locale` (www-Link) |
+| `get_page_summary` | `--path*` `--locale` |
+| `get_ai_page` | `--path` `--locale` (maps ai-pages oder www-Link) |
+| `get_serp_snippet` | `--path` `--url` `--slug` `--locale` |
+| `find_by_keyword` | `--q*` `--limit` `--locale` |
 | `get_discovery` | `--which*` `--offset` `--limit` |
-| `get_llms_mcp_server` | — |
-| `get_llms_mcp_web` | — |
-| `find_by_keyword` | `--q*` `--limit` |
+| `get_llms_txt` | `--offset` `--limit` |
+| `get_llms_mcp_server` | `--offset` `--limit` |
+| `get_llms_mcp_web` | `--offset` `--limit` |
+| `get_ai_txt` | `--offset` `--limit` |
+| `get_sitemap_txt` | `--offset` `--limit` |
+| `list_whatsapp_options` | `--locale` |
+| `compose_tel_mobile` | — |
+| `compose_tel_landline` | — |
+| `compose_whatsapp` | `--option` |
+| `compose_mailto` | — |
 | `find_by_serp` | `--q` `--path` `--url` `--slug` `--limit` |
-| `get_serp_snippet` | `--path` `--url` `--slug` |
-| `find_by_plz` | `--plz*` (alle Gebiete dieser PLZ) |
+| `find_by_plz` | `--plz*` |
 | `find_by_geo` | `--lat` `--lng` `--icbm` `--radius_km` `--limit` |
 | `find_by_icbm` | `--icbm` `--lat` `--lng` `--radius_km` `--limit` |
 | `find_by_gebiet` | `--q` `--name` `--slug` |
-| `find_by_area` | Alias von `find_by_gebiet` |
+| `find_by_area` | Alias `find_by_gebiet` |
 | `list_slugs` | — |
 | `list_plz` | — |
 | `get_hub` | — |
@@ -194,15 +229,14 @@ Diese Flags sind **Terminal-CLI**. MCP Inspector / Cursor zeigt nur **Tools**, k
 | `get_geschichte` | `--slug` `--plz` `--name` |
 | `distance_to_office` | `--slug` `--lat` `--lng` `--icbm` |
 | `resolve_maps_url` | `--url` |
-| `find_by_google_maps` | `--q` (Koordinaten-Paste) |
-| `get_legal` | `--doc*` urheberrecht\|copyright\|impressum\|agb\|nutzungsbedingungen\|datenschutz\|widerruf |
-| `get_urheberrecht` | — (maps `/llms-urheberrecht.txt`) |
+| `find_by_google_maps` | `--q` |
+| `get_urheberrecht` | — |
 | `get_copyright` | — |
 | `get_impressum` | — |
-| `get_agb` | — (www-URL) |
-| `get_nutzungsbedingungen` | — (www-URL) |
-| `get_datenschutz` | — (www-URL) |
-| `get_widerruf` | — (www-URL) |
+| `get_agb` | — |
+| `get_nutzungsbedingungen` | — |
+| `get_datenschutz` | — |
+| `get_widerruf` | — |
 
 Präfix immer `ikeytz-maps-mcp ` (z. B. `ikeytz-maps-mcp get_service_area -h`).
 
@@ -247,7 +281,7 @@ www bleibt **zweiter** Eintrag:
 **Option C — Terminal only**  
 `ikeytz-maps-mcp get_service_area --slug=pattonville`, `ikeytz-maps-mcp list`, … — **ohne** MCP-Host.
 
-Alle Optionen nutzen dieselbe SSOT: `https://maps.ikeytz.com/mcp` (33 Tools, read/link only).
+Alle Optionen nutzen dieselbe SSOT: `https://maps.ikeytz.com/mcp` (42 www-Namen + maps-Extras, read/link only).
 
 ## Env
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@ikeytz/maps-mcp",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "mcpName": "com.ikeytz/maps",
-  "description": "Official CLI + MCP stdio proxy for maps.ikeytz.com — 33 read-only tools (Einsatzgebiet-Karten, not www prices) at https://maps.ikeytz.com/mcp",
+  "description": "Official CLI + MCP stdio proxy for maps.ikeytz.com — 42 www-command names + maps extras (Einsatzgebiet-Karten, prices/FAQ = www links) at https://maps.ikeytz.com/mcp",
   "type": "module",
   "bin": {
     "ikeytz-maps-mcp": "bin/ikeytz-maps-mcp.js"

package/src/cli.js

@@ -57,6 +57,19 @@ function exampleForTool(name) {
     get_nutzungsbedingungen: `${p} get_nutzungsbedingungen`,
     get_datenschutz: `${p} get_datenschutz`,
     get_widerruf: `${p} get_widerruf`,
+    site_overview: `${p} site_overview --locale=de`,
+    get_business_identity: `${p} get_business_identity --locale=de`,
+    list_nav: `${p} list_nav --locale=de`,
+    list_footer: `${p} list_footer --locale=de`,
+    list_locales: `${p} list_locales`,
+    resolve_locale_url: `${p} resolve_locale_url --path=/pattonville --locale=de`,
+    get_prices: `${p} get_prices --locale=de`,
+    get_about: `${p} get_about --locale=de`,
+    get_links: `${p} get_links --locale=de`,
+    get_llms_txt: `${p} get_llms_txt`,
+    get_sitemap_txt: `${p} get_sitemap_txt`,
+    compose_tel_mobile: `${p} compose_tel_mobile`,
+    compose_mailto: `${p} compose_mailto`,
   };
   return map[name] || `${p} ${name}`;
 }

package/src/tools-catalog.json

@@ -5,7 +5,11 @@
       "description": "Alle 52 Einsatzgebiete auf maps.ikeytz.com (Punkte, keine Polygone).",
       "inputSchema": {
         "type": "object",
-        "properties": {}
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
       }
     },
     {
@@ -22,6 +26,9 @@
           },
           "name": {
             "type": "string"
+          },
+          "locale": {
+            "type": "string"
           }
         }
       }
@@ -31,7 +38,11 @@
       "description": "Gewerbesitz Ludwigsburg. Kein Walk-in.",
       "inputSchema": {
         "type": "object",
-        "properties": {}
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
       }
     },
     {
@@ -39,7 +50,11 @@
       "description": "NAP: Handy, Festnetz, Fax, E-Mail, WhatsApp, Adresse.",
       "inputSchema": {
         "type": "object",
-        "properties": {}
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
       }
     },
     {
@@ -89,7 +104,14 @@
       "description": "Katalog llms-mcp-server.txt",
       "inputSchema": {
         "type": "object",
-        "properties": {}
+        "properties": {
+          "offset": {
+            "type": "integer"
+          },
+          "limit": {
+            "type": "integer"
+          }
+        }
       }
     },
     {
@@ -97,7 +119,14 @@
       "description": "Katalog llms-mcp-web.txt",
       "inputSchema": {
         "type": "object",
-        "properties": {}
+        "properties": {
+          "offset": {
+            "type": "integer"
+          },
+          "limit": {
+            "type": "integer"
+          }
+        }
       }
     },
     {
@@ -111,6 +140,9 @@
           },
           "limit": {
             "type": "integer"
+          },
+          "locale": {
+            "type": "string"
           }
         },
         "required": [
@@ -456,6 +488,9 @@
           },
           "limit": {
             "type": "integer"
+          },
+          "locale": {
+            "type": "string"
           }
         },
         "required": [
@@ -539,6 +574,441 @@
         "type": "object",
         "properties": {}
       }
+    },
+    {
+      "name": "site_overview",
+      "description": "Was ist maps.ikeytz.com — 52 Karten, nicht www-Preise.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_business_identity",
+      "description": "Inhaber, NAP, Gewerbesitz. Kein Walk-in.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "list_nav",
+      "description": "maps-Navigation: Hub, MCP, 52 Einsatzgebiete.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "list_footer",
+      "description": "maps-Footer + www-HTML-Links (kein Preise-Corpus).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "list_locales",
+      "description": "Locales auf maps: nur de (E8 nein).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "resolve_locale_url",
+      "description": "Pfad → maps-URL (de). Keine /en auf maps.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "locale": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "path",
+          "locale"
+        ]
+      }
+    },
+    {
+      "name": "get_prices",
+      "description": "Preise sind www. maps liefert nur den Link.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_invoice_line_items",
+      "description": "Rechnungszeilen sind www. maps nur Link.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "situationKey": {
+            "type": "string"
+          },
+          "whenKey": {
+            "type": "string"
+          },
+          "breakdown": {
+            "type": "boolean"
+          },
+          "locale": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "situationKey"
+        ]
+      }
+    },
+    {
+      "name": "list_services",
+      "description": "Leistungen sind www. maps nur Link.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_emergency",
+      "description": "Notfall-Text ist www. maps nur Link.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "list_auswahl",
+      "description": "Auswahl-Hub ist www. maps nur Link.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_auswahl_item",
+      "description": "Auswahl-Detail ist www. maps nur Link.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "slug": {
+            "type": "string"
+          },
+          "locale": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "slug"
+        ]
+      }
+    },
+    {
+      "name": "get_about",
+      "description": "Über maps.ikeytz.com (nicht www Über-uns-Corpus).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_partner_info",
+      "description": "Partner-werden ist www. maps nur Link.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_links",
+      "description": "maps Discovery-URLs (Card, MCP, llms, Registry).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_review_url",
+      "description": "Google-Review ist www. maps nur Link.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "list_faq",
+      "description": "FAQ ist www. maps nur Link.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_faq",
+      "description": "FAQ-Antwort ist www. maps nur Link.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "q": {
+            "type": "string"
+          },
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "list_wissen",
+      "description": "Wissen-Lexikon ist www. maps nur Link.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_wissen_entry",
+      "description": "Wissen-Artikel ist www. maps nur Link.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "locale": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id"
+        ]
+      }
+    },
+    {
+      "name": "list_ratgeber",
+      "description": "Ratgeber-Liste ist www. maps nur Link.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_ratgeber",
+      "description": "Ratgeber-Seite ist www. maps nur Link.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "slug": {
+            "type": "string"
+          },
+          "locale": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "slug"
+        ]
+      }
+    },
+    {
+      "name": "get_page_summary",
+      "description": "Kurz: maps-Ort oder www-Pfad-Link.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "slug": {
+            "type": "string"
+          },
+          "locale": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "path"
+        ]
+      }
+    },
+    {
+      "name": "get_ai_page",
+      "description": "maps /ai-pages/de/{slug}.txt oder www-Link.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "slug": {
+            "type": "string"
+          },
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_llms_txt",
+      "description": "maps /llms.txt 1:1.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "offset": {
+            "type": "integer"
+          },
+          "limit": {
+            "type": "integer"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_ai_txt",
+      "description": "maps /.well-known/ai.txt 1:1.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "offset": {
+            "type": "integer"
+          },
+          "limit": {
+            "type": "integer"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_sitemap_txt",
+      "description": "maps /sitemap.txt 1:1.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "offset": {
+            "type": "integer"
+          },
+          "limit": {
+            "type": "integer"
+          }
+        }
+      }
+    },
+    {
+      "name": "list_whatsapp_options",
+      "description": "WhatsApp-Vorlagen (Link only, kein Formular).",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "locale": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "compose_tel_mobile",
+      "description": "tel:-Link Handy.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "compose_tel_landline",
+      "description": "tel:-Link Festnetz.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "compose_whatsapp",
+      "description": "wa.me-Link. option=zugefallen|abgeschlossen|zylinder|beratung",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "option": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "compose_mailto",
+      "description": "mailto:info@ikeytz.com",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
     }
   ]
 }