import { TrendsMcpClient } from "trendsmcp";

const client = new TrendsMcpClient({ apiKey: "YOUR_API_KEY" });

// 5-year weekly time series
const series = await client.getTrends({
  source: "google search",
  keyword: "bitcoin",
});
// [{ date: "2026-03-21", value: 47, volume: 25853617, keyword: "bitcoin", source: "google search" }, ...]

// Growth across multiple periods
const growth = await client.getGrowth({
  source: "google search",
  keyword: "nike",
  percent_growth: ["12M", "3M", "YTD"],
});
// { search_term: "nike", data_source: "google search", results: [...], metadata: {...} }

interface TrendsDataPoint {
  date: string;       // ISO 8601 e.g. "2026-03-21"
  value: number;      // Normalized score, 0–100
  volume: number | null; // Absolute volume where available
  keyword: string;
  source: string;
}

// Google Search — weekly
const weekly = await client.getTrends({
  source: "google search",
  keyword: "bitcoin",
});

// Reddit — daily granularity
const daily = await client.getTrends({
  source: "reddit",
  keyword: "AI agents",
  data_mode: "daily",
});

// Amazon product demand
const amazon = await client.getTrends({
  source: "amazon",
  keyword: "standing desk",
});

// YouTube search volume
const yt = await client.getTrends({
  source: "youtube",
  keyword: "rust programming",
});

// npm weekly downloads
const pkg = await client.getTrends({
  source: "npm",
  keyword: "react",
});

interface CustomGrowthPeriod {
  name?: string;     // Optional label returned in results
  recent: string;    // More recent date, YYYY-MM-DD
  baseline: string;  // Baseline date, YYYY-MM-DD
}

interface GetGrowthResponse {
  search_term: string;
  data_source: string;
  results: GrowthResult[];
  metadata: GrowthMetadata;
}

interface GrowthResult {
  period: string;
  growth: number;              // Percentage change, positive or negative
  direction: "increase" | "decrease";
  recent_date: string;
  baseline_date: string;
  recent_value: number;
  baseline_value: number;
  volume_available: boolean;
  recent_volume: number | null;
  baseline_volume: number | null;
  volume_growth: number | null;
}

// Preset periods
const growth = await client.getGrowth({
  source: "google search",
  keyword: "nike",
  percent_growth: ["12M", "3M", "YTD"],
});

// Custom date comparison
const custom = await client.getGrowth({
  source: "amazon",
  keyword: "air fryer",
  percent_growth: [
    { name: "holiday lift", recent: "2025-12-31", baseline: "2025-10-01" }
  ],
});

// Multiple sources in parallel
const [googleGrowth, redditGrowth] = await Promise.all([
  client.getGrowth({ source: "google search", keyword: "typescript", percent_growth: ["1Y", "3Y"] }),
  client.getGrowth({ source: "reddit", keyword: "typescript", percent_growth: ["1Y", "3Y"] }),
]);

import { TrendsMcpClient, TrendsMcpError } from "trendsmcp";

const client = new TrendsMcpClient({ apiKey: "YOUR_API_KEY" });

try {
  const series = await client.getTrends({ source: "google search", keyword: "bitcoin" });
} catch (err) {
  if (err instanceof TrendsMcpError) {
    console.error(err.status); // HTTP status code, e.g. 429
    console.error(err.code);   // API error code, e.g. "rate_limited"
    console.error(err.message); // Human-readable message
  }
}

import type {
  TrendsSource,
  GetTrendsParams,
  GetTrendsResponse,
  TrendsDataPoint,
  GrowthPreset,
  CustomGrowthPeriod,
  GetGrowthParams,
  GetGrowthResponse,
  GrowthResult,
} from "trendsmcp";