get_landing_pages

Retrieve landing page analysis from Google Analytics 4 to identify entry points and understand initial user interactions.

Instructions

ランディングページ（ユーザーが最初にアクセスしたページ）の分析結果を取得します。

Input Schema

TableJSON Schema

Name	Required	Description
`propertyId`	No	GA4プロパティID
`period`	Yes	集計期間
`limit`	No	取得件数（デフォルト: 10）

Implementation Reference

src/tools/analytics/getLandingPages.ts:14-57 (handler)

The core handler function that implements the get_landing_pages tool logic: queries GA4 report for landing pages, processes dimensions and metrics, formats data into LandingPage objects.

export async function getLandingPages(
  input: GetLandingPagesInput
): Promise<GetLandingPagesOutput> {
  const propertyId = getPropertyId(input.propertyId);
  const property = formatPropertyPath(propertyId);
  const dateRange = periodToDateRange(input.period);
  const limit = input.limit || 10;

  const response = await executeReport({
    property,
    dateRanges: [dateRange],
    dimensions: [{ name: "landingPage" }],
    metrics: [
      { name: "sessions" },
      { name: "totalUsers" },
      { name: "bounceRate" },
      { name: "averageSessionDuration" },
    ],
    orderBys: [{ metric: { metricName: "sessions" }, desc: true }],
    limit,
  });

  const landingPages: LandingPage[] = [];

  for (const row of response.rows || []) {
    const dimensionValues = row.dimensionValues || [];
    const metricValues = row.metricValues || [];

    const getValue = (index: number): number => {
      const value = metricValues[index]?.value;
      return value ? parseFloat(value) : 0;
    };

    landingPages.push({
      pagePath: dimensionValues[0]?.value || "",
      entrances: Math.round(getValue(0)),
      users: Math.round(getValue(1)),
      bounceRate: formatPercentageFromDecimal(getValue(2)),
      avgSessionDuration: formatDuration(getValue(3)),
    });
  }

  return { landingPages };
}

src/types.ts:253-269 (schema)

TypeScript type definitions for GetLandingPagesInput, LandingPage interface, and GetLandingPagesOutput.

// get_landing_pages
export interface GetLandingPagesInput extends PropertyId {
  period: ShortPeriod;
  limit?: number;
}

export interface LandingPage {
  pagePath: string;
  entrances: number;
  users: number;
  bounceRate: string;
  avgSessionDuration: string;
}

export interface GetLandingPagesOutput {
  landingPages: LandingPage[];
}

src/server.ts:357-377 (registration)

MCP tool registration entry defining name 'get_landing_pages', description, and inputSchema for validation.

{
  name: "get_landing_pages",
  description:
    "ランディングページ（ユーザーが最初にアクセスしたページ）の分析結果を取得します。",
  inputSchema: {
    type: "object" as const,
    properties: {
      propertyId: { type: "string", description: "GA4プロパティID" },
      period: {
        type: "string",
        enum: ["7days", "28days", "30days"],
        description: "集計期間",
      },
      limit: {
        type: "number",
        description: "取得件数（デフォルト: 10）",
      },
    },
    required: ["period"],
  },
},

src/server.ts:688-693 (registration)

Switch case in tool call handler that routes 'get_landing_pages' calls to the getLandingPages function with argument parsing.

case "get_landing_pages":
  return await getLandingPages({
    propertyId: args.propertyId as string | undefined,
    period: args.period as "7days" | "28days" | "30days",
    limit: args.limit as number | undefined,
  });

src/server.ts:26-26 (registration)
Import of getLandingPages handler from analytics tools index.
```
getLandingPages,
```

GA4 MCP Server