MCP Skills

Reporting Skills fuer Claude, Codex und MCP anpassen

Nutze einen Skill, wenn dieselbe Reporting-Frage jeden Tag wiederkommt. Der Skill fixiert erlaubte MCP Actions, exakte Dimensionen und Metrics, Ausgabeformat und Guardrails.

Was ein Reporting Skill enthalten sollte

Ein guter Skill ist kein generischer Prompt. Er ist ein kleiner Ausfuehrungsvertrag fuer den Agenten: erlaubte MCP Funktionen, gueltige GAM Felder, JSON- oder Prosa-Ausgabe und verbotene Aktionen.

Erlaubte Actions

MCP functions + scope

Feldvertrag

Dimensions + metrics

Output-Vertrag

JSON, CSV, or summary

Interne Verlinkung

Jeder Skill sollte auf den Feldkatalog und auf die exakte Use-Case-Seite verlinken. Leser bekommen einen klaren Pfad, Suchmaschinen verstehen den Reporting Cluster besser.

Claude Cowork

Taeglicher GAM Report Skill

Fuer ein morgendliches AdOps Briefing zu Delivery, Revenue, Fill-Problemen und Aktionen ohne zuerst ein Spreadsheet zu oeffnen.

Technischen Use Case oeffnen Academy Guide lesen

User Prompt

Claude, fuehre den gestrigen GAM Report nach DATE, ADVERTISER_NAME, ORDER_NAME, LINE_ITEM_NAME und AD_UNIT_NAME aus. Nutze AD_SERVER_IMPRESSIONS, AD_SERVER_CLICKS, AD_SERVER_CTR, AD_SERVER_REVENUE, AD_REQUESTS, FILL_RATE und UNFILLED_IMPRESSIONS. Fasse Anomalien zusammen und gib die resultId aus.

Skill Anweisungen

Erlaubte MCP Actions: get_report_dimensions, get_report_metrics, run_custom_report, get_report_result, export_report_csv. Standard api=rest. api=soap nur nutzen, wenn die Feldreferenz REST als nicht verfuegbar zeigt. Gib Zusammenfassung, Aktionsliste und resultId zurueck.

Erlaubte MCP Funktionen

get_report_dimensionsget_report_metricsrun_custom_reportget_report_resultexport_report_csv

Feldreferenzen

Dimensionen

DATE ADVERTISER_NAME ORDER_NAME LINE_ITEM_NAME AD_UNIT_NAME

Metrics

AD_SERVER_IMPRESSIONS AD_SERVER_CLICKS AD_SERVER_CTR AD_SERVER_REVENUE AD_REQUESTS FILL_RATE UNFILLED_IMPRESSIONS

Beispielausgabe

Gestern: 1.284.220 Impressions, EUR 4.862 Revenue, CTR 0,42 %, Fill Rate 91,8 %.
Watch: LI-8241 liegt 18 % unter dem 7-Tage-Schnitt auf AD_UNIT_NAME=Sports/Home.
Aktion: Creative Rotation vor Mittag pruefen; resultId rep_20260609_daily.

Guardrails

Keine Felder erfinden. Unsichere Feldnamen mit get_report_dimensions oder get_report_metrics pruefen.
GAM REST fuer das gesamte Reporting hier nutzen; verknuepfte Analytics-Felder sind optionale GAM-Spalten nur bei aktivem Link.

Codex

Unsold Inventory Triage Skill

Fuer Ad Units mit Nachfrage, aber Fill- oder Monetarisierungsverlust.

Technischen Use Case oeffnen Academy Guide lesen

User Prompt

Codex, finde Unsold Inventory der letzten 7 Tage nach DATE, AD_UNIT_NAME, AD_UNIT_CODE und DEVICE_CATEGORY_NAME. Nutze AD_REQUESTS, AD_SERVER_IMPRESSIONS, UNFILLED_IMPRESSIONS und FILL_RATE. Sortiere nach geschaetztem Lost Revenue und exportiere CSV bei mehr als 20 Zeilen.

Skill Anweisungen

Nutze run_custom_report fuer den vollstaendigen REST Report. fetch_inventory_report ist nur als schnelle Ad-Unit Inventory Ansicht erlaubt, nicht als Quelle fuer alle Unsold Metrics. AD_REQUESTS immer neben UNFILLED_IMPRESSIONS zeigen.

Erlaubte MCP Funktionen

get_report_metricsrun_custom_reportget_report_resultexport_report_csvfetch_inventory_report

Feldreferenzen

Dimensionen

DATE AD_UNIT_NAME AD_UNIT_CODE DEVICE_CATEGORY_NAME

Metrics

AD_REQUESTS AD_SERVER_IMPRESSIONS UNFILLED_IMPRESSIONS FILL_RATE AD_SERVER_REVENUE

Beispielausgabe

Sports/Homepage | 184.210 Ad Requests | 52.440 Unfilled | Fill Rate 71,5 % | geschaetzter Lost Revenue EUR 1.126.
Hypothese: Nachfrage- oder Size-Coverage-Problem, kein Traffic-Verlust.
Aktion: Demand Filter, Price Floor und Bidder Sizes vor Trafficking-Aenderung pruefen.

Guardrails

Keine GA4 oder Google Ads APIs fuer diesen Workflow aufrufen.
Price Floors nicht aus einem Tag optimieren; gestern, 7 Tage und gleichen Wochentag vergleichen.

Codex

Line Item Forecast Guardrail Skill

Um vor einer GAM Mutation zu pruefen, ob ein geplantes Line Item wahrscheinlich liefern kann.

Technischen Use Case oeffnen Academy Guide lesen

User Prompt

Codex, fuehre einen Standalone Forecast fuer ein geplantes STANDARD Line Item aus: France, Homepage Ad Units, Sizes 300x250 und 728x90, Ziel 500000 Impressions, Priority 8, Frequency Cap 3 pro Tag. Gib availableUnits, matchedUnits, possibleUnits, riskLevel und lockere Targeting Constraint aus.

Skill Anweisungen

Forecast Funktionen nutzen, nicht run_custom_report, weil zukuenftige Verfuegbarkeit keine historische Reporting Metric ist. Line Item nicht erstellen, aendern oder reservieren. Entscheidung ausgeben: safe, review oder unsafe.

Erlaubte MCP Funktionen

get_standalone_forecastget_delivery_forecast_by_line_itemget_prospective_delivery_forecast

Feldreferenzen

Dimensionen

lineItemType=STANDARDadUnitIdscreativePlaceholdersgeoTargetingfrequencyCaps

Metrics

availableUnitsmatchedUnitspossibleUnitsriskLevel

Beispielausgabe

Forecast: 612.400 availableUnits fuer Ziel 500.000, matchedUnits 544.900, riskLevel=LOW.
Constraint: Homepage + France + Frequency Cap 3/Tag reduziert possibleUnits um 21 %.
Entscheidung: safe fuer Sales Review, vor Booking neu erzeugen.

Guardrails

Forecast ist eine Planungs-Schaetzung, keine Delivery Garantie.
Bei bestehenden Line Items get_delivery_forecast_by_line_item nutzen.

Codex / LLM JSON

Forecast JSON Skill fuer Order und Key-Values

Um einen wiederholbaren JSON Forecast mit GAM Order-Kontext, aufgeloesten Custom-Targeting IDs und Verfuegbarkeitszahlen auszugeben.

Technischen Use Case oeffnen Academy Guide lesen

User Prompt

Codex, erzeuge nur ein forecastDecision JSON fuer Order OR-2026-SUMMER: Order aufloesen, audience=sports und hb_pb=20 zu keyId/valueIds aufloesen, Homepage/Sports Ad Units vom 2026-07-01 bis 2026-07-31 fuer 500000 Impressions forecasten, Sizes 300x250 und 728x90, Priority 8, Frequency Cap 3 pro Tag.

Skill Anweisungen

Erlaubte MCP Actions: orders list/get, targeting search_custom_targeting/get_custom_targeting_values, reporting get_standalone_forecast/get_delivery_forecast_by_line_item/get_prospective_delivery_forecast. IDs vor dem Forecast aufloesen. Nur JSON ausgeben, keine Prosa. Forecast ist kein HISTORICAL REST Report.

Erlaubte MCP Funktionen

list_ordersget_ordersearch_custom_targetingget_custom_targeting_valuesget_standalone_forecastget_delivery_forecast_by_line_itemget_prospective_delivery_forecast

Feldreferenzen

Dimensionen

ORDER_ID ORDER_NAME AD_UNIT_ID KEY_VALUES_ID KEY_VALUES_NAME

Metrics

availableUnitsmatchedUnitsutilizationPercentriskLevel

Beispielausgabe

{"order":{"id":"9482","name":"OR-2026-SUMMER","status":"DRAFT","advertiserId":"7712"},"targeting":{"adUnitIds":["1234567","1234568"],"keyValues":[{"keyId":1871,"valueIds":[9912]},{"keyId":2450,"valueIds":[3301]}]}}
{"forecast":{"availableUnits":612400,"matchedUnits":544900,"utilizationPercent":81.6,"contendingLineItems":[{"lineItemId":"90031","priority":6}]}}
{"decision":{"riskLevel":"LOW","status":"safe_to_review","relaxFirst":null,"nextAction":"regenerate_before_booking"}}

Guardrails

Keine Order aus dieser Skill erstellen, aendern, genehmigen oder reservieren.
Nicht mit rohen Key-Value Namen forecasten; zuerst IDs aufloesen.
JSON Keys stabil halten, damit nachgelagerte LLM Prompts Pflichtfelder validieren koennen.

GAM REST / liens actifs

Skill fuer verknuepfte GAM REST Felder

Fuer Reporting auf Analytics-, AdSense- oder Ad-Exchange-Feldern, die Google Ad Manager bei aktivem Link oder aktiver Quelle ausgibt.

Technischen Use Case oeffnen Academy Guide lesen

User Prompt

Nur mit GAM REST: wenn die verknuepften Felder verfuegbar sind, fuehre einen HISTORICAL Report fuer die letzten 7 Tage nach DATE, PAGE_PATH und DEMAND_CHANNEL_NAME aus. Nutze SESSIONS, GOOGLE_ANALYTICS_REVENUE, ADSENSE_REVENUE, AD_EXCHANGE_REVENUE und AD_EXCHANGE_AVERAGE_ECPM.

Skill Anweisungen

Erlaubte MCP Actions: get_report_dimensions, get_report_metrics, run_custom_report, get_report_result. api="rest" und report_type="HISTORICAL" nutzen. Wenn ein Feld fehlt oder leer ist, erklaeren, dass die verknuepfte Quelle in GAM eventuell nicht aktiv ist.

Erlaubte MCP Funktionen

get_report_dimensionsget_report_metricsrun_custom_reportget_report_result

Feldreferenzen

Dimensionen

DATEPAGE_PATHDEMAND_CHANNEL_NAME

Metrics

SESSIONSGOOGLE_ANALYTICS_REVENUEADSENSE_REVENUEAD_EXCHANGE_REVENUEAD_EXCHANGE_AVERAGE_ECPM

Beispielausgabe

/news/live | Direct | 18.420 Sessions | EUR 1.284 GAM Analytics Revenue | EUR 942 Ad Exchange Revenue | EUR 3,82 AdX eCPM.
DEMAND_CHANNEL_NAME=AdSense bringt EUR 218 auf 62.410 Impressions; AD_EXCHANGE_REVENUE ist die groessere verknuepfte Quelle.
Hinweis: Das sind verknuepfte GAM REST Felder; keine GA4 Data API oder Google Ads API wurde aufgerufen.

Guardrails

Keine GA4 Property ID oder Google Ads Account ID anfordern.
Nicht verfuegbare Kosten-, Keyword-, Bid- oder native Klickdaten nicht als GAM REST Output beschreiben.

Finance / AdOps

Billing und Export Evidence Skill

Fuer monatliche Finance Checks mit gebuchten Mengen, gelieferten Impressions, Revenue und CSV Nachweisen.

Technischen Use Case oeffnen

User Prompt

Bereite den Mai Billing Report vor. Nimm nur STANDARD und SPONSORSHIP Line Items auf, zeige contracted vs delivered impressions, revenue und eCPM, dann exportiere CSV fuer Finance.

Skill Anweisungen

generate_billing_report fuer contracted vs delivered Zeilen nutzen. get_report_result fuer Review und export_report_csv fuer Finance Datei. Falls Download URL existiert, get_report_download_link nach Export nutzen.

Erlaubte MCP Funktionen

generate_billing_reportget_report_resultexport_report_csvget_report_download_link

Feldreferenzen

Dimensionen

ORDER_NAME LINE_ITEM_NAME LINE_ITEM_TYPE_NAME ADVERTISER_NAME

Metrics

LINE_ITEM_CONTRACTED_QUANTITY AD_SERVER_IMPRESSIONS AD_SERVER_REVENUEeCPM

Beispielausgabe

Mai Billing: 42 abrechenbare Line Items, 38 innerhalb Toleranz, 4 fuer Make-good Review.
STANDARD lieferte 93,2 % der gebuchten Impressions; SPONSORSHIP 101,4 %.
CSV Export bereit: billing_2026_05_standard_sponsorship.csv.

Guardrails

Billing Reports sind operative Nachweise, keine finalen Buchhaltungsdokumente.
Order, Line Item und Advertiser Names im Export immer behalten.