MCP-Werkzeugreferenz
Die sieben lesenden Werkzeuge, ihre Parameter und ihre Grenzen.
Werkzeuge im Überblick
| Werkzeug | Ergebnis | Standardzeitraum |
|---|---|---|
list_websites | Freigegebene Websites mit IDs und Zeitzonen | Kein Zeitraum |
get_visits | Besuchs- und verfügbare Besucherkennzahlen | Gestern |
get_top_pages | Seiten-URLs, nach Besuchen sortiert | Letzte Kalenderwoche |
get_traffic_sources | Zugangskanäle | Letzte Kalenderwoche |
get_referring_websites | Verweisende Domains | Letzte Kalenderwoche |
get_visitor_countries | Länder, nach Besuchen sortiert | Letzte Kalenderwoche |
compare_monthly_traffic | Laufender Monat gegenüber vollständigem Vormonat | Automatisch |
Rufe zuerst list_websites ohne Parameter auf. Verwende für alle weiteren Aufrufe eine ID aus dieser Liste. Die Website-Auswahl deiner Verbindung wird bei jeder Abfrage geprüft.
Parameter für Berichte
Die fünf Werkzeuge von get_visits bis get_visitor_countries akzeptieren:
| Parameter | Werte | Hinweis |
|---|---|---|
idSite | Positive ganze Zahl | Erforderliche Website-ID |
period | day, week, month, year, range | Kalenderperiode in der Website-Zeitzone |
date | ISO-Datum, Datumsbereich oder unterstütztes Schlüsselwort | Wählt Datum beziehungsweise Zeitraum |
Unterstützte Schlüsselwörter sind today, yesterday, lastWeek, lastMonth, lastYear sowie lastN und previousN für N von 1 bis 366. Für einen einzelnen aggregierten Datumsbereich verwende period: "range" und zwei aufsteigende ISO-Daten, durch Komma getrennt. Bei range sind auch lastN und previousN zulässig.
Listen paginieren
Die vier Listenwerkzeuge zusätzlich zu get_visits unterstützen:
| Parameter | Standard | Bereich |
|---|---|---|
limit | 10 | 1 bis 100 |
offset | 0 | 0 bis 10000 |
Erhöhe offset um die verwendete Seitengröße, um weitere Zeilen zu lesen. Ein leeres Ergebnis bedeutet, dass für diese Abfrage keine Zeilen zurückgegeben wurden; es ist nicht automatisch ein API-Fehler.
{
"idSite": 1,
"period": "week",
"date": "lastWeek",
"limit": 10,
"offset": 0
}Monatsvergleich
compare_monthly_traffic akzeptiert ausschließlich idSite. Es liefert die Originalberichte beider Monate und Änderungen für verfügbare Zählwerte. Ein Prozentwert ist null, wenn der vorherige Wert null ist. Der aktuelle Monat ist unvollständig; beachte die Vergleichshinweise.
Grenzen
Die Werkzeuge sind lesend und stellen keine Matomo-Verwaltungsfunktionen bereit. Eigene Segmente, Ziele, Conversion-Berichte, E-Commerce, Events und beliebige Reporting-API-Methoden sind im aktuellen MCP-Werkzeugsatz nicht verfügbar. Fehlende Werte dürfen nicht geschätzt werden.
Technischer Hintergrund: Matomo Reporting API.