peeptrend-mcp 0.1.0

package/dist/tools.js

@@ -0,0 +1,198 @@
+import { z } from "zod";
+import { authStatus } from "./config.js";
+import { PeepTrendClient, youtubeResearchPaths } from "./client.js";
+import { PeepTrendApiError } from "./types.js";
+import { formatChannelNameResult, formatConnectionStatus, formatGameCheckerResult, formatOpportunities, formatOpportunityDetail, formatTitleResult, formatYoutubeResearchResult } from "./format.js";
+const periodSchema = z.enum(["7d", "30d", "90d", "180d", "365d"]).default("30d");
+const marketRegionSchema = z.string().min(2).max(12).default("US");
+const marketLanguageSchema = z.string().min(2).max(12).default("en");
+function ok(text, data) {
+    return {
+        content: [{ type: "text", text }],
+        structuredContent: data === undefined ? undefined : { data }
+    };
+}
+function fail(error) {
+    if (error instanceof PeepTrendApiError) {
+        const hint = error.upgradeUrl ? `\n\nContinue in PeepTrend: ${error.upgradeUrl}` : "";
+        return {
+            isError: true,
+            content: [{ type: "text", text: `${error.message}${hint}` }],
+            structuredContent: {
+                error: {
+                    status: error.status,
+                    code: error.code ?? error.name,
+                    upgradeUrl: error.upgradeUrl ?? null
+                }
+            }
+        };
+    }
+    return {
+        isError: true,
+        content: [{ type: "text", text: error instanceof Error ? error.message : "PeepTrend MCP tool failed." }]
+    };
+}
+async function safeRun(fn) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        return fail(error);
+    }
+}
+export function registerPeepTrendTools(server, config) {
+    const client = new PeepTrendClient(config);
+    server.registerTool("get_peeptrend_connection_status", {
+        title: "PeepTrend connection status",
+        description: "Show whether this MCP server is connected anonymously or with a PeepTrend API key."
+    }, async () => ok(formatConnectionStatus({
+        authenticated: authStatus(config) === "authenticated",
+        apiBaseUrl: config.apiBaseUrl,
+        websiteBaseUrl: config.websiteBaseUrl
+    }), {
+        authenticated: authStatus(config) === "authenticated",
+        apiBaseUrl: config.apiBaseUrl,
+        websiteBaseUrl: config.websiteBaseUrl
+    }));
+    server.registerTool("check_youtube_channel_name", {
+        title: "Check YouTube channel name",
+        description: "Check whether a channel name or handle collides with returned YouTube channel results.",
+        inputSchema: {
+            query: z.string().trim().min(1).max(60).describe("Channel name or handle idea, for example 'CozyPixel'.")
+        }
+    }, async ({ query }) => safeRun(async () => {
+        const result = await client.checkYoutubeChannelName(query);
+        return ok(formatChannelNameResult(result), result);
+    }));
+    server.registerTool("check_youtube_title", {
+        title: "Check YouTube video title",
+        description: "Compare a gaming video title or keyword against recent YouTube videos, demand, competition, and title overlap.",
+        inputSchema: {
+            query: z.string().trim().min(1).max(100).describe("Video title or keyword idea."),
+            period: periodSchema.describe("Recent search window.")
+        }
+    }, async ({ query, period }) => safeRun(async () => {
+        const result = await client.checkYoutubeTitle(query, period);
+        return ok(formatTitleResult(result), result);
+    }));
+    server.registerTool("check_youtube_shelf_saturation", {
+        title: "Check YouTube shelf saturation",
+        description: "Check whether a gaming topic shelf is already crowded or still has room for a sharper angle.",
+        inputSchema: {
+            query: z.string().trim().min(1).max(180),
+            period: periodSchema
+        }
+    }, async ({ query, period }) => safeRun(async () => {
+        const result = await client.checkYoutubeResearchTool(youtubeResearchPaths.shelf, query, period);
+        return ok(formatYoutubeResearchResult(result), result);
+    }));
+    server.registerTool("check_gaming_niche", {
+        title: "Check gaming niche",
+        description: "Evaluate a gaming niche for demand, creator pressure, opportunity, and small-channel fit.",
+        inputSchema: {
+            query: z.string().trim().min(1).max(180),
+            period: periodSchema
+        }
+    }, async ({ query, period }) => safeRun(async () => {
+        const result = await client.checkYoutubeResearchTool(youtubeResearchPaths.niche, query, period);
+        return ok(formatYoutubeResearchResult(result), result);
+    }));
+    server.registerTool("check_steam_update_opportunity", {
+        title: "Check Steam update opportunity",
+        description: "Check whether a Steam update, patch, DLC, comeback, or event may be worth covering on YouTube.",
+        inputSchema: {
+            query: z.string().trim().min(1).max(180),
+            period: periodSchema
+        }
+    }, async ({ query, period }) => safeRun(async () => {
+        const result = await client.checkYoutubeResearchTool(youtubeResearchPaths.steamUpdate, query, period);
+        return ok(formatYoutubeResearchResult(result), result);
+    }));
+    server.registerTool("check_small_youtuber_game_fit", {
+        title: "Check small YouTuber game fit",
+        description: "Check whether a game or gaming topic looks realistic for a smaller YouTube channel.",
+        inputSchema: {
+            query: z.string().trim().min(1).max(180),
+            period: periodSchema,
+            channelSize: z.enum(["under_1k", "one_to_10k", "ten_to_50k", "over_50k"]).default("one_to_10k")
+        }
+    }, async ({ query, period, channelSize }) => safeRun(async () => {
+        const result = await client.checkYoutubeResearchTool(youtubeResearchPaths.smallYoutuberFit, query, period, { channelSize });
+        return ok(formatYoutubeResearchResult(result), result);
+    }));
+    server.registerTool("check_game_for_youtube", {
+        title: "Check Steam game for YouTube channel",
+        description: "Check whether one Steam game is a good YouTube opportunity for one creator channel.",
+        inputSchema: {
+            steamUrl: z.string().trim().min(10).max(500).describe("Steam store app URL."),
+            youtubeChannelUrl: z.string().trim().min(8).max(500).describe("YouTube channel URL."),
+            region: marketRegionSchema,
+            language: marketLanguageSchema
+        }
+    }, async (input) => safeRun(async () => {
+        const result = await client.checkGameForYoutube(input);
+        return ok(formatGameCheckerResult(result), result);
+    }));
+    server.registerTool("find_youtube_gaming_opportunities", {
+        title: "Find YouTube gaming opportunities",
+        description: "Return PeepTrend's ranked Steam and YouTube opportunity feed for a market. Requires a PeepTrend API key.",
+        inputSchema: {
+            region: marketRegionSchema,
+            language: marketLanguageSchema,
+            mode: z.enum(["qualified", "steam-only", "watchlist"]).default("qualified")
+        }
+    }, async (input) => safeRun(async () => {
+        const result = await client.findOpportunities(input);
+        return ok(formatOpportunities(result), result);
+    }));
+    server.registerTool("get_opportunity_detail", {
+        title: "Get opportunity detail",
+        description: "Open a full opportunity report with score breakdown, Steam/YouTube evidence, crowding estimate, and creator brief. Requires a PeepTrend API key.",
+        inputSchema: {
+            slug: z.string().trim().min(1).max(120),
+            region: marketRegionSchema,
+            language: marketLanguageSchema
+        }
+    }, async (input) => safeRun(async () => {
+        const result = await client.getOpportunityDetail(input);
+        return ok(formatOpportunityDetail(result), result);
+    }));
+    server.registerTool("generate_creator_ideas", {
+        title: "Generate creator ideas",
+        description: "Generate PeepTrend content ideas for an opportunity. Requires an active PeepTrend subscription.",
+        inputSchema: {
+            slug: z.string().trim().min(1).max(120),
+            region: marketRegionSchema,
+            language: marketLanguageSchema,
+            regenerate: z.boolean().default(false)
+        }
+    }, async (input) => safeRun(async () => {
+        const result = await client.generateCreatorIdeas(input);
+        return ok("Generated PeepTrend creator ideas. Use the structured data for titles, hooks, risks, and descriptions.", result);
+    }));
+    server.registerTool("save_opportunity_workflow", {
+        title: "Save opportunity workflow",
+        description: "Save, plan, dismiss, publish, or clear a PeepTrend opportunity workflow status. Requires an active PeepTrend subscription.",
+        inputSchema: {
+            gameId: z.string().trim().min(1).max(80),
+            status: z.enum(["none", "saved", "dismissed", "planned", "published"]),
+            note: z.string().trim().max(1000).optional()
+        }
+    }, async (input) => safeRun(async () => {
+        const result = await client.setWorkflow(input);
+        return ok(`Workflow updated to "${input.status}".`, result);
+    }));
+    server.registerTool("send_opportunity_feedback", {
+        title: "Send opportunity feedback",
+        description: "Tell PeepTrend whether an opportunity was useful, wrong, saturated, off-niche, or used for a video. Requires an active PeepTrend subscription.",
+        inputSchema: {
+            gameId: z.string().trim().min(1).max(80),
+            type: z.enum(["useful", "not_useful", "wrong_match", "too_saturated", "not_my_niche", "made_video"]),
+            message: z.string().trim().max(1000).optional()
+        }
+    }, async (input) => safeRun(async () => {
+        const result = await client.sendFeedback(input);
+        return ok(`Feedback recorded as "${input.type}".`, result);
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,252 @@
+export type PeriodId = "7d" | "30d" | "90d" | "180d" | "365d";
+export type ChannelSize = "under_1k" | "one_to_10k" | "ten_to_50k" | "over_50k";
+export type OpportunityMode = "qualified" | "steam-only" | "watchlist";
+export type ApiEnvelope<T> = {
+    data: T;
+};
+export type ApiErrorPayload = {
+    error?: string;
+    message?: string;
+};
+export type ToolLimit = {
+    limit: number | null;
+    used: number | null;
+    remaining: number | null;
+    resetAt: string | null;
+    scope: string;
+    unlimited?: boolean;
+};
+export type YoutubeChannelResult = {
+    query: string;
+    handleCandidate: string;
+    verdict: "taken" | "close" | "available";
+    channels: Array<{
+        title: string;
+        handle: string;
+        youtubeUrl: string;
+        subscribers: number | null;
+        exactHandleMatch: boolean;
+        exactTitleMatch: boolean;
+        containsMatch: boolean;
+    }>;
+};
+export type YoutubeTitleResult = {
+    query: string;
+    period: {
+        id: PeriodId;
+        label: string;
+    };
+    videos: Array<{
+        title: string;
+        author: string;
+        youtubeUrl: string;
+        viewCount: number;
+        viewsPerDay: number;
+        publishedText: string;
+        exactTitleMatch: boolean;
+    }>;
+    summary: {
+        videosAnalyzed: number;
+        averageViews: number;
+        topViews: number;
+        averageViewsPerDay: number;
+        uniqueChannels: number;
+        demandScore: number;
+        competitionScore: number;
+        opportunityScore: number;
+        recommendation: string;
+        warnings: string[];
+    };
+};
+export type YoutubeResearchResult = {
+    tool: string;
+    query: string;
+    searchQuery: string;
+    period: {
+        id: PeriodId;
+        label: string;
+    };
+    videos: YoutubeTitleResult["videos"];
+    summary: {
+        verdictLabel: string;
+        headline: string;
+        recommendation: string;
+        nextStep: string;
+        scoreCards: Array<{
+            label: string;
+            score: number | null;
+            tone: string;
+        }>;
+        metrics: Array<{
+            label: string;
+            value: string;
+            detail: string;
+        }>;
+        insights: string[];
+        angles: Array<{
+            title: string;
+            text: string;
+        }>;
+        warnings: string[];
+        videosAnalyzed: number;
+        demandScore: number;
+        competitionScore: number;
+        opportunityScore: number;
+        saturationScore: number;
+        smallCreatorFitScore: number;
+    };
+};
+export type GameCheckerResult = {
+    checkId: string;
+    limit: ToolLimit;
+    game: {
+        tracked: boolean;
+        name: string;
+        steamUrl: string | null;
+        imageUrl: string | null;
+        currentPlayers: number | null;
+        peakPlayers24h: number | null;
+        genres: string[];
+        tags: string[];
+    };
+    channel: {
+        channelTitle: string;
+        youtubeUrl: string;
+        subscriberCount: number;
+        averageViews: number;
+        sizeSegment: string;
+    };
+    score: {
+        opportunityScore: number | null;
+        fitScore: number | null;
+        verdict: string;
+        verdictLabel: string;
+        explanation: string;
+        fitReason: string;
+        riskFlags: string[];
+    };
+    youtube: {
+        videosCount7d: number | null;
+        views7d: number | null;
+        uniqueChannelsCount: number | null;
+        evidenceVideos: Array<{
+            title: string;
+            url: string;
+            channelTitle: string | null;
+            viewCount: number;
+        }>;
+    };
+    ideas: Array<{
+        title: string;
+        angle: string;
+        reason: string;
+        difficulty: string;
+        urgency: string;
+    }>;
+};
+export type OpportunityListResult = {
+    data: OpportunityPreview[];
+    lockedOpportunities: Array<{
+        id: string;
+        gameName: string;
+        gameImageUrl: string | null;
+    }>;
+    locked: boolean;
+    preview: boolean;
+    lockedCount?: number;
+    subscription?: SubscriptionStatus;
+};
+export type SubscriptionStatus = {
+    status: string;
+    canAccess: boolean;
+    requiresSubscription: boolean;
+    previewAccess: boolean;
+    previewAccessExpired: boolean;
+    freeOpportunityUnlockLimit: number;
+    freeOpportunityUnlocksUsed: number;
+    freeOpportunityUnlocksRemaining: number;
+};
+export type OpportunityPreview = {
+    gameId: string;
+    slug: string;
+    gameName: string;
+    gameImageUrl: string | null;
+    region: string;
+    language: string;
+    finalScore: number;
+    momentumScore: number;
+    saturationScore: number;
+    opportunityGapScore: number;
+    queryPrecisionScore: number;
+    crowdingVelocityScore: number;
+    crowdingWindowHours: number | null;
+    confidenceScore: number;
+    riskFlags: string[];
+    explanation: string;
+    suggestedVideoAngle: string;
+    suggestedVideoReason: string;
+    suggestedVideoUrgency: string;
+    currentPlayers: number | null;
+    videosCount7d: number | null;
+    evidenceVideos: Array<{
+        title: string;
+        url: string;
+        channelTitle: string | null;
+        viewCount: number;
+    }>;
+};
+export type OpportunityDetail = {
+    game: {
+        id: string;
+        name: string;
+        slug: string;
+        steamUrl: string | null;
+        imageUrl: string | null;
+        genres: string[];
+        tags: string[];
+    };
+    score: {
+        finalScore: number;
+        gameMomentumScore: number;
+        youtubeSaturationScore: number;
+        opportunityGapScore: number;
+        timingScore: number;
+        confidenceScore: number;
+        queryPrecisionScore: number;
+        crowdingVelocityScore: number;
+        crowdingWindowHours: number | null;
+        riskFlags: string[];
+        explanation: string;
+    };
+    videoIdeas: Array<{
+        title: string;
+        angle: string;
+        reason: string;
+        difficulty: string;
+        urgency: string;
+    }>;
+    evidenceVideos: Array<{
+        title: string;
+        url: string;
+        channelTitle: string | null;
+        viewCount: number;
+    }>;
+    creatorBrief: {
+        action: string;
+        recommendedFormat: string;
+        suggestedTitle: string;
+        hook: string;
+        whatToCheck: string;
+        deadline: string;
+    };
+};
+export declare class PeepTrendApiError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly upgradeUrl?: string;
+    constructor(message: string, options: {
+        status: number;
+        code?: string;
+        upgradeUrl?: string;
+    });
+}

package/dist/types.js

@@ -0,0 +1,13 @@
+export class PeepTrendApiError extends Error {
+    status;
+    code;
+    upgradeUrl;
+    constructor(message, options) {
+        super(message);
+        this.name = "PeepTrendApiError";
+        this.status = options.status;
+        this.code = options.code;
+        this.upgradeUrl = options.upgradeUrl;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAyOA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,MAAM,CAAS;IACf,IAAI,CAAU;IACd,UAAU,CAAU;IAE7B,YAAY,OAAe,EAAE,OAA+D;QAC1F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACvC,CAAC;CACF"}

package/integrations/claude/README.md

@@ -0,0 +1,23 @@
+# PeepTrend for Claude
+
+Add PeepTrend to Claude Desktop as an MCP server:
+
+```json
+{
+  "mcpServers": {
+    "peeptrend": {
+      "command": "npx",
+      "args": ["-y", "peeptrend-mcp"],
+      "env": {
+        "PEEPTREND_API_KEY": "pt_key_from_profile"
+      }
+    }
+  }
+}
+```
+
+Suggested first prompt:
+
+"Use PeepTrend to find a gaming topic I can record this week. Prefer lower saturation and explain the evidence."
+
+The portable Claude skill prompt is in `skills/claude/peeptrend-youtube-gaming-trend-finder/SKILL.md`.

package/integrations/codex/README.md

@@ -0,0 +1,27 @@
+# PeepTrend for Codex
+
+PeepTrend can be used in Codex through the MCP server or the bundled Codex plugin scaffold in this repository.
+
+## MCP Config
+
+```json
+{
+  "mcpServers": {
+    "peeptrend": {
+      "command": "npx",
+      "args": ["-y", "peeptrend-mcp"],
+      "env": {
+        "PEEPTREND_API_KEY": "pt_key_from_profile"
+      }
+    }
+  }
+}
+```
+
+## Plugin Scaffold
+
+The Codex plugin manifest lives at:
+
+`plugins/peeptrend-youtube-gaming-trend-finder/.codex-plugin/plugin.json`
+
+It declares the same MCP server and a focused PeepTrend skill for YouTube gaming trend research.

package/integrations/mcp/README.md

@@ -0,0 +1,25 @@
+# PeepTrend MCP
+
+Use this for any MCP-compatible client.
+
+```json
+{
+  "mcpServers": {
+    "peeptrend": {
+      "command": "npx",
+      "args": ["-y", "peeptrend-mcp"],
+      "env": {
+        "PEEPTREND_API_KEY": "pt_key_from_profile"
+      }
+    }
+  }
+}
+```
+
+Good starter prompts:
+
+- "Find gaming opportunities for US English creators and explain the top 3."
+- "Check whether this YouTube title is crowded: Minecraft update explained."
+- "Check if this Steam game is worth covering for my channel."
+
+Create and revoke API keys at https://peeptrend.com/profile.

package/integrations/openclaw/README.md

@@ -0,0 +1,23 @@
+# PeepTrend for OpenClaw
+
+Add the PeepTrend MCP server to OpenClaw's MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "peeptrend": {
+      "command": "npx",
+      "args": ["-y", "peeptrend-mcp"],
+      "env": {
+        "PEEPTREND_API_KEY": "pt_key_from_profile"
+      }
+    }
+  }
+}
+```
+
+Suggested first prompt:
+
+"Use PeepTrend to check whether this Steam update is worth covering on YouTube and suggest a safe angle."
+
+The portable OpenClaw skill prompt is in `skills/openclaw/youtube-gaming-trend-finder/SKILL.md`.

package/mcp-registry/server.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.peeptrend/youtube-gaming-trend-finder",
+  "title": "PeepTrend: YouTube Gaming Trend Finder",
+  "description": "Find rising Steam games and YouTube content opportunities before the niche gets crowded.",
+  "repository": {
+    "url": "https://github.com/PeepTrend/PeepTrend.MCP",
+    "source": "github"
+  },
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "peeptrend-mcp",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "PEEPTREND_API_KEY",
+          "description": "Optional PeepTrend API key from Profile > AI integrations. Required for account-aware limits, full reports, ideas, workflow actions, and subscription features.",
+          "format": "string",
+          "isRequired": false,
+          "isSecret": true
+        }
+      ]
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "peeptrend-mcp",
+  "version": "0.1.0",
+  "description": "PeepTrend MCP server for finding rising Steam games and YouTube gaming content opportunities before niches get crowded.",
+  "mcpName": "io.github.peeptrend/youtube-gaming-trend-finder",
+  "type": "module",
+  "license": "MIT",
+  "author": "PeepTrend <support@peeptrend.com>",
+  "homepage": "https://peeptrend.com/integrations/mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/PeepTrend/PeepTrend.MCP.git"
+  },
+  "bugs": {
+    "url": "https://github.com/PeepTrend/PeepTrend.MCP/issues"
+  },
+  "keywords": [
+    "mcp",
+    "youtube",
+    "gaming",
+    "steam",
+    "creator-tools",
+    "peeptrend"
+  ],
+  "bin": {
+    "peeptrend-mcp": "dist/server.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "integrations",
+    "plugins",
+    "skills",
+    "mcp-registry"
+  ],
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && tsc -p tsconfig.build.json",
+    "prepare": "npm run build",
+    "dev": "tsx src/server.ts",
+    "start": "node dist/server.js",
+    "test": "node --import tsx --test \"src/**/*.test.ts\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "validate": "npm run typecheck && npm test && npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}