@reaudit/mcp-server 1.0.0

package/dist/lib/api-client.d.ts

@@ -0,0 +1,970 @@
+/**
+ * Reaudit API Client
+ *
+ * HTTP client for communicating with the Reaudit MCP API.
+ */
+export interface Project {
+    id: string;
+    name: string;
+    domain: string | null;
+    brandName: string;
+    industry: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AccountInfo {
+    user: {
+        id: string;
+        email: string;
+        name: string | null;
+    };
+    subscription: {
+        tier: string;
+        status: string;
+        currentPeriodEnd: string;
+    };
+    usage: {
+        prompts: {
+            used: number;
+            limit: number;
+            resetsAt: string;
+            unlimited: boolean;
+        };
+        content: {
+            used: number;
+            limit: number;
+            resetsAt: string;
+            unlimited: boolean;
+        };
+        images: {
+            used: number;
+            limit: number;
+            resetsAt: string;
+            unlimited: boolean;
+        };
+        audits: {
+            used: number;
+            limit: number;
+            resetsAt: string;
+            unlimited: boolean;
+        };
+    };
+}
+export interface VisibilityScore {
+    brandName: string;
+    visibilityScore: number;
+    period: string;
+    metrics: {
+        totalMentions: number;
+        citationsReceived: number;
+        citationRate: number;
+        avgSentiment: number;
+    };
+    platformBreakdown: Array<{
+        platform: string;
+        mentions: number;
+        avgSentiment: number;
+    }>;
+    sentimentDistribution: {
+        positive: number;
+        neutral: number;
+        negative: number;
+    };
+}
+export interface BrandMention {
+    id: string;
+    platform: string;
+    prompt: string;
+    excerpt: string;
+    sentiment: number;
+    sentimentLabel: string;
+    citationCount: number;
+    timestamp: string;
+}
+export interface CompetitorComparison {
+    brandName: string;
+    yourMetrics: {
+        mentions: number;
+        avgSentiment: number;
+        citations: number;
+        rank: number;
+        totalCompetitors: number;
+    };
+    competitors: Array<{
+        name: string;
+        domain: string;
+        mentions: number;
+        avgSentiment: number;
+        citations: number;
+    }>;
+    period: string;
+}
+export interface AuditSummary {
+    id: string;
+    url: string;
+    domain: string;
+    status: string;
+    pageTitle: string | null;
+    currentScore: number | null;
+    potentialScore: number | null;
+    processingTime: string | null;
+    createdAt: string;
+}
+export interface AuditDetails {
+    id: string;
+    url: string;
+    domain: string;
+    status: string;
+    pageTitle: string;
+    pageDescription: string;
+    scores: {
+        current: number;
+        potential: number;
+        pageSpeed: number | null;
+        accessibility: number | null;
+    };
+    focusKeyphrase: string;
+    metaDescription: string;
+    recommendations: Array<{
+        title: string;
+        description: string;
+        priority: number;
+        impact: string;
+        category: string;
+        effort: string;
+    }>;
+    technicalIssues: Array<{
+        issue: string;
+        impact: string;
+        solution: string;
+    }>;
+    contentSuggestions: Array<{
+        suggestion: string;
+        benefit: string;
+    }>;
+    pageSpeed: {
+        performance: number;
+        fcp: string;
+        lcp: string;
+        tbt: string;
+        cls: string;
+    } | null;
+    contentQuality: {
+        overall: number;
+        clarity: number;
+        factuality: number;
+        answerability: number;
+    } | null;
+    createdAt: string;
+    processingTime: string | null;
+}
+export interface KnowledgeBaseResult {
+    projectId: string;
+    query: string;
+    results: Array<{
+        rank: number;
+        content: string;
+        source: string | null;
+        title: string | null;
+    }>;
+    stats: {
+        totalPages: number;
+        totalChunks: number;
+    };
+    message?: string;
+}
+export interface ContentSuggestion {
+    id: string;
+    title: string;
+    description: string;
+    type: string;
+    priority: number;
+    status: string;
+    targetKeywords: string[];
+    estimatedImpact: string;
+    createdAt: string;
+}
+export interface CalendarEvent {
+    id: string;
+    type: 'social_media' | 'wordpress' | 'blog' | 'strategy_planned';
+    platform: string;
+    title: string;
+    status: string;
+    date: string;
+    url?: string;
+    strategyName?: string;
+    weekNumber?: number;
+    pillar?: string;
+    funnelStage?: string;
+}
+export interface CalendarStats {
+    total: number;
+    socialMedia: number;
+    wordpress: number;
+    blog: number;
+    strategyPlanned: number;
+    planned: number;
+    scheduled: number;
+    published: number;
+}
+export interface Strategy {
+    id: string;
+    name: string;
+    description?: string;
+    status: 'draft' | 'in_progress' | 'completed' | 'archived';
+    currentModule: number;
+    currentStep: number;
+    completionPercentage: number;
+    businessContext: {
+        companyName: string;
+        industry: string;
+        productService: string;
+        targetMarket: string;
+    };
+    projectId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface StrategyContentItem {
+    id: string;
+    platform: string;
+    format?: string;
+    topic: string;
+    pillar?: string;
+    funnelStage?: string;
+    status: 'planned' | 'draft' | 'scheduled' | 'published';
+    plannedDate: string;
+    weekNumber?: number;
+    dayOfWeek?: string;
+    weekTheme?: string;
+    notes?: string;
+    hasGeneratedContent: boolean;
+    generatedContentId?: string;
+}
+export interface GeneratedContent {
+    id: string;
+    title: string;
+    slug: string;
+    content?: string;
+    markdownContent?: string;
+    excerpt: string;
+    metaTitle?: string;
+    metaDescription: string;
+    contentType: string;
+    keyword: string;
+    topic: string;
+    wordCount: number;
+    seoScore?: number;
+    readabilityScore?: number;
+    keywordDensity?: number;
+    sentiment?: string;
+    suggestedTags?: string[];
+    suggestedCategories?: string[];
+    focusKeyphrase?: string;
+    schemaMarkup?: string;
+    structuredData?: Record<string, unknown>;
+    headings?: {
+        h1?: string[];
+        h2?: string[];
+        h3?: string[];
+    };
+    internalLinks?: Array<{
+        text: string;
+        url: string;
+    }>;
+    imagePrompts?: string[];
+    faq?: Array<{
+        question: string;
+        answer: string;
+    }>;
+    hasSchemaMarkup?: boolean;
+    knowledgeBaseContext?: Array<{
+        content: string;
+        source: string | null;
+        title: string | null;
+    }>;
+    internalLinkSuggestionsUsed?: number;
+    semanticVariantsUsed?: number;
+    webSearchUsed?: {
+        citationsCount: number;
+        researchLength: number;
+    };
+    language: string;
+    provider: string;
+    projectId?: string;
+    generatedAt: string;
+}
+export interface CitationSource {
+    url: string;
+    title: string;
+    domain: string;
+    type: 'Brand' | 'Third-party';
+    frequency: number;
+    models: string[];
+    prompts: string[];
+    promptCount: number;
+    lastCited: string;
+}
+export interface AuthorInfo {
+    name?: string;
+    email?: string;
+    bio?: string;
+    imageUrl?: string;
+    socialLinks?: Record<string, string>;
+    articleTitle?: string;
+    articleExcerpt?: string;
+    confidence?: number;
+}
+export interface OutreachOpportunity {
+    id: string;
+    articleUrl: string;
+    articleTitle: string;
+    articleDomain: string;
+    authorName?: string;
+    authorEmail?: string;
+    authorBio?: string;
+    authorSocialLinks?: Record<string, string>;
+    status: string;
+    discoveredFrom: string;
+    notes?: string;
+    tags?: string[];
+    createdAt: string;
+}
+export interface IndexingConnection {
+    id: string;
+    siteUrl: string;
+    siteName: string;
+    sitemapUrl?: string;
+    sourceType: string;
+    indexNowEnabled: boolean;
+    indexNowKeyVerified: boolean;
+    indexNowKey?: string;
+    gscEnabled: boolean;
+    stats?: {
+        totalUrls: number;
+        indexedUrls: number;
+        lastSyncAt?: string;
+    };
+    isActive: boolean;
+    lastError?: string;
+    lastErrorAt?: string;
+    project?: {
+        id: string;
+        name: string;
+    };
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SocialConnection {
+    id: string;
+    platform: string;
+    platformUsername?: string;
+    platformUserId?: string;
+    isVerified: boolean;
+    totalPublished: number;
+    totalScheduled: number;
+    totalFailed: number;
+    lastPublishedAt?: string;
+    createdAt: string;
+}
+export interface SocialPost {
+    id: string;
+    platform: string;
+    text: string;
+    status: string;
+    scheduledFor?: string;
+    publishedAt?: string;
+    platformUrl?: string;
+    createdAt: string;
+}
+/**
+ * API Client class
+ */
+export declare class ReauditAPIClient {
+    private baseUrl;
+    private oauthClient;
+    private httpClient;
+    constructor(baseUrl: string);
+    /**
+     * Make an authenticated API request with automatic retry
+     */
+    private request;
+    listProjects(): Promise<{
+        projects: Project[];
+        count: number;
+    }>;
+    getAccount(): Promise<AccountInfo>;
+    getVisibilityScore(projectId: string): Promise<VisibilityScore>;
+    getBrandMentions(projectId: string, options?: {
+        platform?: string;
+        limit?: number;
+        days?: number;
+    }): Promise<{
+        brandName: string;
+        mentions: BrandMention[];
+        count: number;
+        period: string;
+    }>;
+    getCompetitorComparison(projectId: string): Promise<CompetitorComparison>;
+    listAudits(options?: {
+        projectId?: string;
+        limit?: number;
+        status?: string;
+    }): Promise<{
+        audits: AuditSummary[];
+        count: number;
+    }>;
+    getAuditDetails(auditId: string): Promise<AuditDetails>;
+    getAuditRecommendations(auditId: string, options?: {
+        category?: string;
+        impact?: string;
+    }): Promise<{
+        auditId: string;
+        url: string;
+        currentScore: number;
+        totalRecommendations: number;
+        byImpact: {
+            critical: any[];
+            high: any[];
+            medium: any[];
+            low: any[];
+        };
+        summary: {
+            critical: number;
+            high: number;
+            medium: number;
+            low: number;
+        };
+    }>;
+    searchKnowledgeBase(projectId: string, query: string, topK?: number): Promise<KnowledgeBaseResult>;
+    getContentSuggestions(projectId: string, options?: {
+        status?: string;
+        limit?: number;
+    }): Promise<{
+        projectId: string;
+        suggestions: ContentSuggestion[];
+        count: number;
+    }>;
+    getCitationAnalytics(projectId: string, days?: number): Promise<{
+        brandName: string;
+        period: string;
+        summary: {
+            totalCitations: number;
+            mentionsWithCitations: number;
+            avgCitationsPerMention: number;
+        };
+        dailyTrends: Array<{
+            date: string;
+            citations: number;
+            mentions: number;
+        }>;
+        topCitedDomains: Array<{
+            domain: string;
+            count: number;
+        }>;
+        byPlatform: Array<{
+            platform: string;
+            citations: number;
+            mentions: number;
+        }>;
+    }>;
+    getWordPressAnalytics(projectId: string, days?: number): Promise<{
+        projectId: string;
+        domain: string;
+        period: string;
+        summary: {
+            totalBotVisits: number;
+            uniqueBotTypes: number;
+        };
+        botBreakdown: Array<{
+            botType: string;
+            visits: number;
+            uniquePages: number;
+        }>;
+        topCrawledPages: Array<{
+            url: string;
+            visits: number;
+            bots: string[];
+        }>;
+        dailyTrends: Array<Record<string, any>>;
+    }>;
+    getTokenUsage(days?: number): Promise<{
+        period: string;
+        totalTokens: number;
+        totalCost: number;
+        totalCostFormatted: string;
+        byOperation: Array<{
+            operation: string;
+            tokens: number;
+            cost: number;
+            count: number;
+        }>;
+        byDay: Array<{
+            date: string;
+            tokens: number;
+            cost: number;
+        }>;
+        budget?: {
+            tokenLimit?: number;
+            costLimit?: number;
+            percentUsed: number;
+            alertThreshold: number;
+        };
+    }>;
+    getBudgetStatus(): Promise<{
+        hasLimits: boolean;
+        settings: {
+            monthlyTokenLimit?: number;
+            monthlyCostLimit?: number;
+            monthlyCostLimitFormatted?: string;
+            alertThreshold: number;
+            pauseOnLimit: boolean;
+            notifyOnAlert: boolean;
+        } | null;
+        currentPeriod: string | null;
+        usage: {
+            tokens: number;
+            cost: number;
+            costFormatted: string;
+            tokenLimit?: number;
+            costLimit?: number;
+            percentUsed: number;
+        } | null;
+        status: {
+            allowed: boolean;
+            reason?: string;
+            alertSent: boolean;
+            limitReached: boolean;
+        };
+    }>;
+    updateBudgetSettings(settings: {
+        monthlyTokenLimit?: number | null;
+        monthlyCostLimit?: number | null;
+        alertThreshold?: number;
+        pauseOnLimit?: boolean;
+    }): Promise<{
+        message: string;
+        settings: any;
+    }>;
+    getContentCalendar(options?: {
+        projectId?: string;
+        startDate?: string;
+        endDate?: string;
+        limit?: number;
+    }): Promise<{
+        events: CalendarEvent[];
+        stats: CalendarStats;
+    }>;
+    listStrategies(options?: {
+        projectId?: string;
+        status?: string;
+        limit?: number;
+        page?: number;
+    }): Promise<{
+        strategies: Strategy[];
+        pagination: {
+            page: number;
+            limit: number;
+            total: number;
+            totalPages: number;
+        };
+    }>;
+    getStrategyDetails(strategyId: string): Promise<{
+        strategy: any;
+    }>;
+    createStrategy(data: {
+        name: string;
+        description?: string;
+        projectId?: string;
+        businessContext: {
+            companyName: string;
+            industry: string;
+            productService: string;
+            targetMarket: string;
+            currentChallenges?: string;
+            competitors?: string[];
+            uniqueValueProposition?: string;
+        };
+    }): Promise<{
+        strategy: Strategy;
+    }>;
+    getStrategyContentItems(strategyId: string, options?: {
+        status?: string;
+        weekNumber?: number;
+        platform?: string;
+    }): Promise<{
+        items: StrategyContentItem[];
+        stats: Record<string, number>;
+        count: number;
+    }>;
+    updateStrategyContentItem(strategyId: string, itemId: string, updates: {
+        status?: string;
+        notes?: string;
+        topic?: string;
+        platform?: string;
+        plannedDate?: string;
+    }): Promise<{
+        item: StrategyContentItem;
+    }>;
+    generateContent(data: {
+        contentType?: string;
+        keyword: string;
+        topic: string;
+        additionalContext?: string;
+        contentLength?: 'short' | 'medium' | 'long' | 'comprehensive';
+        tone?: string;
+        customTone?: string;
+        useProjectTone?: boolean;
+        projectId?: string;
+        language?: string;
+        useSemanticVariants?: boolean;
+        useWebSearch?: boolean;
+    }): Promise<{
+        content: GeneratedContent;
+    }>;
+    getContentHistory(options?: {
+        projectId?: string;
+        contentType?: string;
+        limit?: number;
+        skip?: number;
+    }): Promise<{
+        history: GeneratedContent[];
+        pagination: {
+            total: number;
+            limit: number;
+            skip: number;
+            hasMore: boolean;
+        };
+    }>;
+    getContentDetails(contentId: string): Promise<{
+        content: GeneratedContent;
+    }>;
+    getCitationSources(projectId: string, options?: {
+        type?: string;
+        limit?: number;
+    }): Promise<{
+        sources: CitationSource[];
+        stats: {
+            totalSources: number;
+            brandSources: number;
+            thirdPartySources: number;
+            totalCitations: number;
+            modelBreakdown: Record<string, number>;
+        };
+    }>;
+    extractAuthorInfo(url: string): Promise<{
+        found: boolean;
+        author?: AuthorInfo;
+        message?: string;
+    }>;
+    listOutreachOpportunities(projectId: string, options?: {
+        status?: string;
+        limit?: number;
+        page?: number;
+    }): Promise<{
+        opportunities: OutreachOpportunity[];
+        pagination: {
+            page: number;
+            limit: number;
+            total: number;
+            totalPages: number;
+        };
+        statusCounts: Record<string, number>;
+    }>;
+    createOutreachOpportunity(data: {
+        projectId: string;
+        articleUrl: string;
+        articleTitle: string;
+        authorName?: string;
+        authorEmail?: string;
+        authorBio?: string;
+        authorSocialLinks?: Record<string, string>;
+        notes?: string;
+        tags?: string[];
+    }): Promise<{
+        opportunity: OutreachOpportunity;
+    }>;
+    listIndexingConnections(options?: {
+        projectId?: string;
+        activeOnly?: boolean;
+    }): Promise<{
+        connections: IndexingConnection[];
+        count: number;
+    }>;
+    createIndexingConnection(data: {
+        siteUrl: string;
+        siteName: string;
+        sitemapUrl?: string;
+        projectId?: string;
+        indexNowEnabled?: boolean;
+    }): Promise<{
+        connection: IndexingConnection;
+        message: string;
+    }>;
+    syncIndexingConnection(connectionId: string): Promise<{
+        message: string;
+        connection: {
+            id: string;
+            siteUrl: string;
+            sitemapUrl: string;
+            stats: any;
+            lastSyncAt?: string;
+        };
+    }>;
+    listSocialConnections(): Promise<{
+        connections: SocialConnection[];
+        count: number;
+    }>;
+    listSocialPosts(options?: {
+        projectId?: string;
+        platform?: string;
+        status?: string;
+        limit?: number;
+        skip?: number;
+    }): Promise<{
+        posts: SocialPost[];
+        pagination: {
+            total: number;
+            limit: number;
+            skip: number;
+            hasMore: boolean;
+        };
+    }>;
+    generateSocialPosts(data: {
+        contentId: string;
+        platforms: string[];
+        tone?: string;
+        includeHashtags?: boolean;
+        includeLink?: boolean;
+    }): Promise<{
+        success: boolean;
+        posts?: Array<{
+            _id: string;
+            platform: string;
+            text: string;
+            hashtags?: string[];
+            status: string;
+        }>;
+        error?: string;
+    }>;
+    publishSocialPost(postId: string): Promise<{
+        success: boolean;
+        platform?: string;
+        platformUrl?: string;
+        error?: string;
+    }>;
+    scheduleSocialPost(postId: string, scheduledFor: string): Promise<{
+        success: boolean;
+        platform?: string;
+        error?: string;
+    }>;
+    listWordPressConnections(): Promise<{
+        connections: Array<{
+            id: string;
+            siteName: string;
+            siteUrl: string;
+            isVerified: boolean;
+            totalPublished: number;
+            totalDrafts: number;
+            lastPublishedAt?: string;
+        }>;
+    }>;
+    publishToWordPress(data: {
+        contentId: string;
+        connectionId: string;
+        status?: 'draft' | 'publish';
+        categories?: string[];
+        tags?: string[];
+    }): Promise<{
+        success: boolean;
+        post?: {
+            id: string;
+            wordpressPostId: number;
+            wordpressUrl: string;
+            title: string;
+            status: string;
+            publishedAt?: string;
+        };
+        error?: string;
+    }>;
+    listReactConnections(): Promise<{
+        connections: Array<{
+            id: string;
+            siteName: string;
+            siteUrl: string;
+            isActive: boolean;
+            webhookUrl?: string;
+            contentSections?: Array<{
+                id: string;
+                name: string;
+                route: string;
+            }>;
+        }>;
+    }>;
+    publishToReact(data: {
+        contentId: string;
+        connectionId: string;
+        section?: string;
+    }): Promise<{
+        success: boolean;
+        contentId?: string;
+        slug?: string;
+        section?: string;
+        webhookSent?: boolean;
+        error?: string;
+    }>;
+    generateLlmsTxt(projectId: string): Promise<{
+        success: boolean;
+        content?: string;
+        metadata?: {
+            generatedAt: string;
+            model: string;
+            hasKnowledgeBase: boolean;
+        };
+        error?: string;
+    }>;
+    translateContent(contentId: string, targetLanguage: string): Promise<{
+        success: boolean;
+        originalLanguage?: string;
+        content?: {
+            id: string;
+            title: string;
+            metaTitle: string;
+            metaDescription: string;
+            excerpt: string;
+            slug: string;
+            wordCount: number;
+        };
+        error?: string;
+    }>;
+    listPromptTopics(projectId: string): Promise<{
+        topics: Array<{
+            id: string;
+            name: string;
+            description?: string;
+            promptCount: number;
+            prompts: Array<{
+                _id: string;
+                text: string;
+                trackedToday?: boolean;
+            }>;
+            language?: string;
+            region?: string;
+            schedule?: string;
+            enabled: boolean;
+            lastExecutedAt?: string;
+        }>;
+    }>;
+    createPromptTopic(data: {
+        projectId: string;
+        name: string;
+        description?: string;
+        prompts: string[];
+        language?: string;
+        region?: string;
+    }): Promise<{
+        success: boolean;
+        topic?: {
+            id: string;
+            name: string;
+            promptCount: number;
+        };
+        error?: string;
+    }>;
+    addPromptsToTopic(topicId: string, prompts: string[]): Promise<{
+        success: boolean;
+        totalPrompts?: number;
+        error?: string;
+    }>;
+    trackPrompt(data: {
+        projectId: string;
+        promptText: string;
+        promptId?: string;
+        engines?: string[];
+    }): Promise<{
+        success: boolean;
+        queryId?: string;
+        status?: string;
+        estimatedTimeSeconds?: number;
+        error?: string;
+    }>;
+    getPromptAnalytics(projectId: string, days?: number): Promise<{
+        success: boolean;
+        summary?: {
+            totalPrompts: number;
+            totalQueries: number;
+            brandMentions: number;
+            avgSentiment: number;
+            visibilityRate: number;
+        };
+        platformBreakdown?: Array<{
+            platform: string;
+            mentions: number;
+            sentiment: number;
+        }>;
+        topPrompts?: Array<{
+            text: string;
+            mentions: number;
+            sentiment: number;
+        }>;
+        recentQueries?: Array<{
+            query: string;
+            status: string;
+            brandMentioned?: boolean;
+        }>;
+        error?: string;
+    }>;
+    generatePromptSuggestions(data: {
+        projectId: string;
+        topic?: string;
+        count?: number;
+    }): Promise<{
+        success: boolean;
+        suggestions?: Array<{
+            text: string;
+            searchIntent?: string;
+        }>;
+        error?: string;
+    }>;
+    queryAnalytics(params: {
+        projectId: string;
+        metrics: string[];
+        dimensions?: string[];
+        timeGrain?: string;
+        days?: number;
+        filters?: Record<string, any>;
+        limit?: number;
+    }): Promise<any>;
+    listReports(projectId?: string, pinned?: boolean, limit?: number): Promise<any>;
+    createReport(data: {
+        projectId: string;
+        name: string;
+        description?: string;
+        query: any;
+        visualization?: any;
+        schedule?: string;
+        tags?: string[];
+        pinned?: boolean;
+    }): Promise<any>;
+    getReport(id: string): Promise<any>;
+    updateReport(id: string, data: Record<string, any>): Promise<any>;
+    deleteReport(id: string): Promise<any>;
+    listActionGrids(projectId?: string, limit?: number): Promise<any>;
+    createActionGrid(data: {
+        projectId: string;
+        name: string;
+        description?: string;
+        items?: any[];
+        categories?: string[];
+        source?: string;
+        tags?: string[];
+    }): Promise<any>;
+    getActionGrid(id: string): Promise<any>;
+    updateActionGrid(id: string, data: Record<string, any>): Promise<any>;
+    deleteActionGrid(id: string): Promise<any>;
+    addActionGridItems(gridId: string, items: any[]): Promise<any>;
+    updateActionGridItem(gridId: string, itemId: string, data: Record<string, any>): Promise<any>;
+    isAuthenticated(): boolean;
+    logout(): Promise<void>;
+}
+//# sourceMappingURL=api-client.d.ts.map