@frase/mcp-server 0.1.0

package/dist/tools/audits.js

@@ -0,0 +1,345 @@
+/**
+ * Audit tools
+ */
+import { z } from "zod";
+import { CACHE_TTL } from "../cache.js";
+import { formatTable, formatStatus, formatDate, formatPagination, formatKeyValue, truncate, } from "../formatter.js";
+// ============================================
+// list_audits
+// ============================================
+const listAuditsInputSchema = z.object({
+    page: z.number().min(1).optional().default(1),
+    page_size: z.number().min(1).max(100).optional().default(20),
+    status: z.enum(["pending", "crawling", "analyzing", "completed", "failed", "archived"]).optional(),
+    site_id: z.string().optional(),
+});
+export const listAuditsTool = {
+    name: "list_audits",
+    description: "List site audits in your account. Audits analyze your website for SEO issues, content quality, and technical problems.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            page: {
+                type: "number",
+                description: "Page number (default: 1)",
+            },
+            page_size: {
+                type: "number",
+                description: "Items per page, max 100 (default: 20)",
+            },
+            status: {
+                type: "string",
+                enum: ["pending", "crawling", "analyzing", "completed", "failed", "archived"],
+                description: "Filter by audit status",
+            },
+            site_id: {
+                type: "string",
+                description: "Filter by site ID",
+            },
+        },
+    },
+};
+export async function executeListAudits(input, context) {
+    const parsed = listAuditsInputSchema.safeParse(input || {});
+    if (!parsed.success) {
+        return {
+            success: false,
+            markdown: `**Error:** Invalid input - ${parsed.error.message}`,
+        };
+    }
+    const { page, page_size, status, site_id } = parsed.data;
+    try {
+        const params = { page, page_size };
+        if (status)
+            params.status = status;
+        if (site_id)
+            params.site_id = site_id;
+        const response = await context.client.get("/audits", params, CACHE_TTL.lists);
+        const headers = ["Site", "Name", "Status", "Score", "Issues", "Created"];
+        const rows = response.data.map((audit) => [
+            audit.site?.domain || "-",
+            truncate(audit.name || "Audit", 30),
+            formatStatus(audit.status),
+            audit.overall_score !== null ? `${audit.overall_score}%` : "-",
+            audit.total_issues !== null ? audit.total_issues.toString() : "-",
+            formatDate(audit.created_at),
+        ]);
+        const table = formatTable(headers, rows);
+        const pagination = formatPagination(response.pagination);
+        return {
+            success: true,
+            markdown: `## Audits (Page ${page})\n\n${table}${pagination}`,
+            data: response,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            success: false,
+            markdown: `**Error:** Failed to list audits - ${message}`,
+        };
+    }
+}
+// ============================================
+// start_audit
+// ============================================
+const startAuditInputSchema = z.object({
+    site_id: z.string().min(1),
+    name: z.string().optional(),
+    type: z.enum(["full", "technical", "content", "quick"]).optional().default("full"),
+    max_pages: z.number().min(1).max(1000).optional().default(100),
+});
+export const startAuditTool = {
+    name: "start_audit",
+    description: "Start a new site audit. The audit will crawl your site and analyze it for SEO issues, content quality, and technical problems.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "The ID of the site to audit (required)",
+            },
+            name: {
+                type: "string",
+                description: "Optional name for the audit",
+            },
+            type: {
+                type: "string",
+                enum: ["full", "technical", "content", "quick"],
+                description: "Type of audit to run (default: full)",
+            },
+            max_pages: {
+                type: "number",
+                description: "Maximum pages to crawl, 1-1000 (default: 100)",
+            },
+        },
+        required: ["site_id"],
+    },
+};
+export async function executeStartAudit(input, context) {
+    const parsed = startAuditInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return {
+            success: false,
+            markdown: `**Error:** Invalid input - ${parsed.error.message}`,
+        };
+    }
+    const { site_id, name, type, max_pages } = parsed.data;
+    try {
+        const response = await context.client.post("/audits", {
+            site_id,
+            name,
+            type,
+            max_pages,
+        });
+        const audit = response.data;
+        const details = formatKeyValue({
+            id: audit.id,
+            name: audit.name || "Audit",
+            type: audit.type,
+            status: audit.status,
+            site: audit.site?.domain,
+        });
+        return {
+            success: true,
+            markdown: `## Audit Started\n\n${details}\n\n**Note:** The audit is now crawling your site. Use \`get_job_status\` with id \`${audit.id}\` to check progress.`,
+            data: response,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            success: false,
+            markdown: `**Error:** Failed to start audit - ${message}`,
+        };
+    }
+}
+// ============================================
+// get_audit
+// ============================================
+const getAuditInputSchema = z.object({
+    id: z.string().min(1),
+    include_pages: z.boolean().optional().default(false),
+});
+export const getAuditTool = {
+    name: "get_audit",
+    description: "Get details of a specific audit, including summary statistics and optionally page-level data.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            id: {
+                type: "string",
+                description: "The audit ID (required)",
+            },
+            include_pages: {
+                type: "boolean",
+                description: "Include page-level audit data (default: false)",
+            },
+        },
+        required: ["id"],
+    },
+};
+export async function executeGetAudit(input, context) {
+    const parsed = getAuditInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return {
+            success: false,
+            markdown: `**Error:** Invalid input - ${parsed.error.message}`,
+        };
+    }
+    const { id, include_pages } = parsed.data;
+    try {
+        const params = {};
+        if (include_pages)
+            params.include_pages = true;
+        const response = await context.client.get(`/audits/${id}`, params, CACHE_TTL.resources);
+        const audit = response.data;
+        let markdown = `## Audit: ${audit.name || "Site Audit"}\n\n`;
+        markdown += formatKeyValue({
+            id: audit.id,
+            site: audit.site?.domain,
+            type: audit.type,
+            status: audit.status,
+            overall_score: audit.overall_score !== null ? `${audit.overall_score}%` : null,
+            pages_audited: audit.pages_audited,
+            total_issues: audit.total_issues,
+            critical_issues: audit.critical_issues,
+            created: formatDate(audit.created_at),
+            completed: audit.completed_at ? formatDate(audit.completed_at) : null,
+        });
+        if (audit.summary) {
+            markdown += "\n\n### Summary\n\n";
+            markdown += formatKeyValue({
+                total_pages: audit.summary.total_pages,
+                crawled_pages: audit.summary.crawled_pages,
+                avg_word_count: audit.summary.avg_word_count,
+                total_issues: audit.summary.total_issues,
+                critical_issues: audit.summary.critical_issues,
+                warning_issues: audit.summary.warning_issues,
+            });
+        }
+        if (audit.pages && audit.pages.length > 0) {
+            markdown += "\n\n### Pages\n\n";
+            const headers = ["URL", "Title", "Status", "Score"];
+            const rows = audit.pages.slice(0, 20).map((page) => [
+                truncate(page.url, 50),
+                truncate(page.title || "-", 30),
+                page.status_code?.toString() || "-",
+                page.score !== null ? `${page.score}%` : "-",
+            ]);
+            markdown += formatTable(headers, rows);
+            if (audit.pages.length > 20) {
+                markdown += `\n\n_Showing first 20 of ${audit.pages.length} pages. Use \`export_audit\` for full data._`;
+            }
+        }
+        return {
+            success: true,
+            markdown,
+            data: response,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            success: false,
+            markdown: `**Error:** Failed to get audit - ${message}`,
+        };
+    }
+}
+// ============================================
+// export_audit
+// ============================================
+const exportAuditInputSchema = z.object({
+    id: z.string().min(1),
+    format: z.enum(["json", "csv"]).optional().default("json"),
+});
+export const exportAuditTool = {
+    name: "export_audit",
+    description: "Export audit data. Returns detailed page-level data for analysis.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            id: {
+                type: "string",
+                description: "The audit ID (required)",
+            },
+            format: {
+                type: "string",
+                enum: ["json", "csv"],
+                description: "Export format (default: json)",
+            },
+        },
+        required: ["id"],
+    },
+};
+export async function executeExportAudit(input, context) {
+    const parsed = exportAuditInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return {
+            success: false,
+            markdown: `**Error:** Invalid input - ${parsed.error.message}`,
+        };
+    }
+    const { id, format } = parsed.data;
+    try {
+        const response = await context.client.get(`/audits/${id}/export`, { format }, 0 // No caching for exports
+        );
+        const audit = response.data;
+        let markdown = `## Audit Export\n\n`;
+        markdown += formatKeyValue({
+            id: audit.id,
+            site: audit.site_domain,
+            type: audit.type,
+            status: audit.status,
+            total_pages: audit.summary.total_pages,
+            total_issues: audit.summary.total_issues,
+            critical_issues: audit.summary.critical_issues,
+        });
+        markdown += `\n\n### Pages (${audit.pages.length} total)\n\n`;
+        if (audit.pages.length > 0) {
+            const headers = ["URL", "Title", "Status", "Words", "H1", "H2", "Issues"];
+            const rows = audit.pages.slice(0, 30).map((page) => [
+                truncate(page.url, 40),
+                truncate(page.title || "-", 25),
+                page.status_code?.toString() || "-",
+                page.word_count?.toString() || "-",
+                page.h1_count.toString(),
+                page.h2_count.toString(),
+                page.issues.length.toString(),
+            ]);
+            markdown += formatTable(headers, rows);
+            if (audit.pages.length > 30) {
+                markdown += `\n\n_Showing first 30 of ${audit.pages.length} pages._`;
+            }
+        }
+        markdown += `\n\n**Full data available in the \`data\` field of this response.**`;
+        return {
+            success: true,
+            markdown,
+            data: response,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            success: false,
+            markdown: `**Error:** Failed to export audit - ${message}`,
+        };
+    }
+}
+// ============================================
+// Export all
+// ============================================
+export const auditTools = [
+    listAuditsTool,
+    startAuditTool,
+    getAuditTool,
+    exportAuditTool,
+];
+export const auditExecutors = {
+    list_audits: executeListAudits,
+    start_audit: executeStartAudit,
+    get_audit: executeGetAudit,
+    export_audit: executeExportAudit,
+};
+//# sourceMappingURL=audits.js.map

package/dist/tools/audits.js.map

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

package/dist/tools/briefs.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Brief tools
+ */
+import { z } from "zod";
+import type { McpToolDefinition, ToolContext, ToolResult } from "../types.js";
+declare const listBriefsInputSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    page_size: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    status: z.ZodOptional<z.ZodEnum<["draft", "pending", "research", "ready", "generating", "completed"]>>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    page_size: number;
+    status?: "draft" | "generating" | "pending" | "research" | "ready" | "completed" | undefined;
+}, {
+    page?: number | undefined;
+    page_size?: number | undefined;
+    status?: "draft" | "generating" | "pending" | "research" | "ready" | "completed" | undefined;
+}>;
+export type ListBriefsInput = z.infer<typeof listBriefsInputSchema>;
+export declare const listBriefsTool: McpToolDefinition;
+export declare function executeListBriefs(input: unknown, context: ToolContext): Promise<ToolResult>;
+declare const createBriefInputSchema: z.ZodObject<{
+    topic: z.ZodString;
+    target_keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    content_type: z.ZodDefault<z.ZodOptional<z.ZodEnum<["blog", "guide", "landing", "product", "comparison", "listicle"]>>>;
+    search_intent: z.ZodOptional<z.ZodString>;
+    target_word_count: z.ZodOptional<z.ZodNumber>;
+    generate_outline: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    competitor_urls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    topic: string;
+    content_type: "blog" | "guide" | "landing" | "product" | "comparison" | "listicle";
+    generate_outline: boolean;
+    target_keywords?: string[] | undefined;
+    search_intent?: string | undefined;
+    target_word_count?: number | undefined;
+    competitor_urls?: string[] | undefined;
+}, {
+    topic: string;
+    target_keywords?: string[] | undefined;
+    content_type?: "blog" | "guide" | "landing" | "product" | "comparison" | "listicle" | undefined;
+    search_intent?: string | undefined;
+    target_word_count?: number | undefined;
+    generate_outline?: boolean | undefined;
+    competitor_urls?: string[] | undefined;
+}>;
+export type CreateBriefInput = z.infer<typeof createBriefInputSchema>;
+export declare const createBriefTool: McpToolDefinition;
+export declare function executeCreateBrief(input: unknown, context: ToolContext): Promise<ToolResult>;
+declare const getBriefInputSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export type GetBriefInput = z.infer<typeof getBriefInputSchema>;
+export declare const getBriefTool: McpToolDefinition;
+export declare function executeGetBrief(input: unknown, context: ToolContext): Promise<ToolResult>;
+export declare const briefTools: McpToolDefinition[];
+export declare const briefExecutors: Record<string, (input: unknown, context: ToolContext) => Promise<ToolResult>>;
+export {};
+//# sourceMappingURL=briefs.d.ts.map

package/dist/tools/briefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"briefs.d.ts","sourceRoot":"","sources":["../../src/tools/briefs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAA+B,MAAM,aAAa,CAAC;AAe3G,QAAA,MAAM,qBAAqB;;;;;;;;;;;;EAMzB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,cAAc,EAAE,iBAsB5B,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA6CrB;AAMD,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;EAW1B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,eAAe,EAAE,iBAyC7B,CAAC;AAYF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAkDrB;AAMD,QAAA,MAAM,mBAAmB;;;;;;EAEvB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,YAAY,EAAE,iBAa1B,CAAC;AAUF,wBAAsB,eAAe,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA0ErB;AAMD,eAAO,MAAM,UAAU,EAAE,iBAAiB,EAIzC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CACjC,MAAM,EACN,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAK9D,CAAC"}