MCPMCP-Tools/SEO-Ranking-Tracking/download_seo_report

download_seo_report

Readlistings:read

Build the branded, section-configurable SEO ranking report — the same "Download Report" action in the app. Returns rendered HTML, not a binary PDF file: there's no headless-Chrome renderer available server-side, so turning this into an actual PDF (as the app's own UI does, client-side) is on the caller. preset controls the date window (e.g. "lastMonth"; pass from/to instead for a custom range). sections lets you include/exclude report sections by key: coverPage, executiveSummary, performanceSnapshot, agencyActivityLog, gridRankSnapshots, keywordPerformanceTable, monthOverMonthTrend, competitorLandscape, aiRecommendations — omitted keys use the report's own defaults. Distinct from generate_seo_report, which only enqueues a background rank-grid scan and returns no document.

Parameter
locationIdstringerforderlich
Location id — the id from list_locations. Either id shape works. Required.
preset"lastMonth" | "last3Months" | "last6Months" | "last12Months" | "custom"optional
Date-range preset (default "lastMonth"). Use "custom" with from/to for an arbitrary range.
fromstringoptional
Custom range start (ISO date). Requires to.
tostringoptional
Custom range end (ISO date). Requires from.
keywordsstring[]optional
Limit to these tracked keyword ids (from get_ranking_overview's keywords[]). Omit for all.
sectionsobjectoptional
Which report sections to include, by key (see the tool description for the full key list). Omitted keys use the report's own defaults.
coverPagebooleanoptional
Include the coverPage section.
executiveSummarybooleanoptional
Include the executiveSummary section.
performanceSnapshotbooleanoptional
Include the performanceSnapshot section.
agencyActivityLogbooleanoptional
Include the agencyActivityLog section.
gridRankSnapshotsbooleanoptional
Include the gridRankSnapshots section.
keywordPerformanceTablebooleanoptional
Include the keywordPerformanceTable section.
monthOverMonthTrendbooleanoptional
Include the monthOverMonthTrend section.
competitorLandscapebooleanoptional
Include the competitorLandscape section.
aiRecommendationsbooleanoptional
Include the aiRecommendations section.
notesstringoptional
Free-text notes to include on the report.
locale"en" | "es" | "fr" | "de" | "pt"optional
Language for the rendered report (default "en").
Beispielanfrage
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "download_seo_report",
    "arguments": {
      "locationId": "string"
    }
  }
}
Beispielantwort
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

Die Antwortform dient nur zur Veranschaulichung — der tatsächliche Inhalt hängt vom Tool und Ihren Daten ab.