research-powerpack-mcp 3.0.0

package/dist/tools/search.js

@@ -0,0 +1,121 @@
+/**
+ * Web Search Tool Handler
+ */
+import { SearchClient } from '../clients/search.js';
+import { aggregateAndRank, buildUrlLookup, lookupUrl, generateEnhancedOutput, markConsensus, } from '../utils/url-aggregator.js';
+import { CTR_WEIGHTS } from '../config/index.js';
+function getPositionScore(position) {
+    if (position >= 1 && position <= 10) {
+        return CTR_WEIGHTS[position] ?? 0;
+    }
+    return Math.max(0, 10 - (position - 10) * 0.5);
+}
+export async function handleWebSearch(params, options = {}) {
+    const { sessionId, logger } = options;
+    const startTime = Date.now();
+    try {
+        if (sessionId && logger) {
+            await logger('info', `Searching for ${params.keywords.length} keyword(s)`, sessionId);
+        }
+        const client = new SearchClient();
+        const response = await client.searchMultiple(params.keywords);
+        const aggregation = aggregateAndRank(response.searches, 5);
+        const urlLookup = buildUrlLookup(aggregation.rankedUrls);
+        const consensusUrls = aggregation.rankedUrls.filter(url => url.frequency >= aggregation.frequencyThreshold);
+        let markdown = '';
+        if (consensusUrls.length > 0) {
+            markdown += generateEnhancedOutput(consensusUrls, params.keywords, aggregation.totalUniqueUrls, aggregation.frequencyThreshold, aggregation.thresholdNote);
+            markdown += '\n---\n\n';
+        }
+        else {
+            markdown += `## The Perfect Search Results (Aggregated from ${response.totalKeywords} Queries)\n\n`;
+            markdown += `> *No high-consensus URLs found across searches. Results may be highly diverse.*\n\n`;
+            markdown += `---\n\n`;
+        }
+        // Limit output based on number of queries to keep under ~20k tokens
+        const MAX_QUERIES_SHOWN = 15;
+        const MAX_RESULTS_PER_QUERY = response.totalKeywords > 10 ? 5 : 10;
+        const queriesToShow = response.searches.slice(0, MAX_QUERIES_SHOWN);
+        const queriesOmitted = response.searches.length - queriesToShow.length;
+        markdown += `## 📊 Full Search Results by Query`;
+        if (queriesOmitted > 0) {
+            markdown += ` (showing ${queriesToShow.length} of ${response.searches.length})`;
+        }
+        markdown += `\n\n`;
+        let totalResults = 0;
+        queriesToShow.forEach((search, index) => {
+            markdown += `### Query ${index + 1}: "${search.keyword}"\n\n`;
+            search.results.slice(0, MAX_RESULTS_PER_QUERY).forEach((result, resultIndex) => {
+                const position = resultIndex + 1;
+                const positionScore = getPositionScore(position);
+                const rankedUrl = lookupUrl(result.link, urlLookup);
+                const frequency = rankedUrl?.frequency ?? 1;
+                const consensusMark = markConsensus(frequency);
+                const consensusInfo = rankedUrl
+                    ? `${consensusMark} (${frequency} searches)`
+                    : `${consensusMark} (1 search)`;
+                markdown += `${position}. **[${result.title}](${result.link})** — Position ${position} | Score: ${positionScore.toFixed(1)} | Consensus: ${consensusInfo}\n`;
+                if (result.snippet) {
+                    let snippet = result.snippet;
+                    if (snippet.length > 150) {
+                        snippet = snippet.substring(0, 147) + '...';
+                    }
+                    if (result.date) {
+                        markdown += `   - *${result.date}* — ${snippet}\n`;
+                    }
+                    else {
+                        markdown += `   - ${snippet}\n`;
+                    }
+                }
+                markdown += '\n';
+                totalResults++;
+            });
+            if (search.related && search.related.length > 0) {
+                const relatedSuggestions = search.related
+                    .slice(0, 5)
+                    .map((r) => `\`${r}\``)
+                    .join(', ');
+                markdown += `*Related:* ${relatedSuggestions}\n\n`;
+            }
+            if (index < queriesToShow.length - 1) {
+                markdown += `---\n\n`;
+            }
+        });
+        if (queriesOmitted > 0) {
+            markdown += `\n---\n\n> *${queriesOmitted} additional queries not shown. Consensus URLs above include all ${response.searches.length} queries.*\n`;
+        }
+        const executionTime = Date.now() - startTime;
+        if (sessionId && logger) {
+            await logger('info', `Search completed: ${totalResults} results, ${aggregation.totalUniqueUrls} unique URLs, ${consensusUrls.length} consensus URLs in ${executionTime}ms`, sessionId);
+        }
+        const metadata = {
+            total_keywords: response.totalKeywords,
+            total_results: totalResults,
+            execution_time_ms: executionTime,
+            total_unique_urls: aggregation.totalUniqueUrls,
+            consensus_url_count: consensusUrls.length,
+            frequency_threshold: aggregation.frequencyThreshold,
+        };
+        return { content: markdown, structuredContent: { content: markdown, metadata } };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (sessionId && logger) {
+            await logger('error', errorMessage, sessionId);
+        }
+        const executionTime = Date.now() - startTime;
+        const errorContent = `# ❌ Search Failed\n\n${errorMessage}\n\n**Tip:** Make sure SERPER_API_KEY is set in your environment variables.`;
+        return {
+            content: errorContent,
+            structuredContent: {
+                content: errorContent,
+                metadata: {
+                    total_keywords: params.keywords.length,
+                    total_results: 0,
+                    execution_time_ms: executionTime,
+                },
+            },
+        };
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Simple error handling for API requests
+ */
+export declare function createSimpleError(error: unknown): {
+    message: string;
+    code: string;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA6BnF"}

package/dist/utils/errors.js

@@ -0,0 +1,30 @@
+/**
+ * Simple error handling for API requests
+ */
+export function createSimpleError(error) {
+    const err = error;
+    // Missing API key
+    if (err.message?.includes('API_KEY')) {
+        return { message: 'OPENROUTER_API_KEY environment variable required', code: 'AUTH_ERROR' };
+    }
+    // HTTP errors
+    if (err.response?.status) {
+        const status = err.response.status;
+        switch (status) {
+            case 401:
+                return { message: 'Invalid API key', code: 'AUTH_ERROR' };
+            case 429:
+                return { message: 'Rate limit exceeded - try again later', code: 'RATE_LIMIT' };
+            case 403:
+                return { message: 'API quota exceeded', code: 'QUOTA_ERROR' };
+            default:
+                return { message: `API error: ${status}`, code: 'API_ERROR' };
+        }
+    }
+    // Network/timeout errors
+    if (err.code === 'ECONNABORTED' || err.message?.includes('timeout')) {
+        return { message: 'Request timeout - research may take up to 30 minutes', code: 'TIMEOUT' };
+    }
+    return { message: err.message || 'Unknown error occurred', code: 'UNKNOWN_ERROR' };
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,MAAM,GAAG,GAAG,KAA4E,CAAC;IAEzF,kBAAkB;IAClB,IAAI,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,OAAO,EAAE,kDAAkD,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAC7F,CAAC;IAED,cAAc;IACd,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;QACnC,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,GAAG;gBACN,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;YAC5D,KAAK,GAAG;gBACN,OAAO,EAAE,OAAO,EAAE,uCAAuC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;YAClF,KAAK,GAAG;gBACN,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;YAChE;gBACE,OAAO,EAAE,OAAO,EAAE,cAAc,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAClE,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACpE,OAAO,EAAE,OAAO,EAAE,sDAAsD,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC9F,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,wBAAwB,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;AACrF,CAAC"}

package/dist/utils/markdown-formatter.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Markdown formatting utilities
+ */
+export declare function removeMetaTags(content: string): string;
+//# sourceMappingURL=markdown-formatter.d.ts.map

package/dist/utils/markdown-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/markdown-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYtD"}

package/dist/utils/markdown-formatter.js

@@ -0,0 +1,15 @@
+/**
+ * Markdown formatting utilities
+ */
+export function removeMetaTags(content) {
+    if (!content || typeof content !== 'string') {
+        return content;
+    }
+    const lines = content.split('\n');
+    const filteredLines = lines.filter(line => {
+        const trimmed = line.trim();
+        return !trimmed.startsWith('- Meta:') && !trimmed.startsWith('Meta:');
+    });
+    return filteredLines.join('\n');
+}
+//# sourceMappingURL=markdown-formatter.js.map

package/dist/utils/markdown-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-formatter.js","sourceRoot":"","sources":["../../src/utils/markdown-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/dist/utils/url-aggregator.d.ts

@@ -0,0 +1,55 @@
+/**
+ * URL Aggregator Utility
+ * Aggregates search results across multiple queries, calculates CTR-weighted scores,
+ * and generates consensus-based rankings.
+ */
+import type { KeywordSearchResult } from '../clients/search.js';
+/**
+ * Ranked URL with normalized score
+ */
+export interface RankedUrl {
+    url: string;
+    title: string;
+    snippet: string;
+    rank: number;
+    score: number;
+    frequency: number;
+    positions: number[];
+    queries: string[];
+    bestPosition: number;
+    isConsensus: boolean;
+}
+/**
+ * Aggregation result containing all processed data
+ */
+interface AggregationResult {
+    rankedUrls: RankedUrl[];
+    totalUniqueUrls: number;
+    totalQueries: number;
+    frequencyThreshold: number;
+    thresholdNote?: string;
+}
+/**
+ * Mark consensus status for a URL
+ * Returns "✓" if frequency >= 3, else "✗"
+ */
+export declare function markConsensus(frequency: number): string;
+/**
+ * Generate enhanced narrative output for consensus URLs
+ */
+export declare function generateEnhancedOutput(rankedUrls: RankedUrl[], allKeywords: string[], totalUniqueUrls: number, frequencyThreshold: number, thresholdNote?: string): string;
+/**
+ * Full aggregation pipeline with fallback thresholds
+ * Tries ≥3, falls back to ≥2, then ≥1 if needed
+ */
+export declare function aggregateAndRank(searches: KeywordSearchResult[], minConsensusUrls?: number): AggregationResult;
+/**
+ * Build URL lookup map for quick consensus checking during result formatting
+ */
+export declare function buildUrlLookup(rankedUrls: RankedUrl[]): Map<string, RankedUrl>;
+/**
+ * Look up a URL in the ranked results
+ */
+export declare function lookupUrl(url: string, lookup: Map<string, RankedUrl>): RankedUrl | undefined;
+export {};
+//# sourceMappingURL=url-aggregator.d.ts.map

package/dist/utils/url-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-aggregator.d.ts","sourceRoot":"","sources":["../../src/utils/url-aggregator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAgBhE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,UAAU,iBAAiB;IACzB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAqHD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAyBD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,SAAS,EAAE,EACvB,WAAW,EAAE,MAAM,EAAE,EACrB,eAAe,EAAE,MAAM,EACvB,kBAAkB,EAAE,MAAM,EAC1B,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAiER;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,gBAAgB,GAAE,MAAU,GAC3B,iBAAiB,CA+BnB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAW9E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,GAAG,SAAS,CAG5F"}

package/dist/utils/url-aggregator.js

@@ -0,0 +1,246 @@
+/**
+ * URL Aggregator Utility
+ * Aggregates search results across multiple queries, calculates CTR-weighted scores,
+ * and generates consensus-based rankings.
+ */
+import { CTR_WEIGHTS } from '../config/index.js';
+/**
+ * Get CTR weight for a position (1-10)
+ * Positions beyond 10 get minimal weight
+ */
+function getCtrWeight(position) {
+    if (position >= 1 && position <= 10) {
+        return CTR_WEIGHTS[position] ?? 0;
+    }
+    // Positions beyond 10 get diminishing returns
+    return Math.max(0, 10 - (position - 10) * 0.5);
+}
+/**
+ * Aggregate results from multiple searches
+ * Flattens all results, deduplicates by URL, and tracks frequency/positions
+ */
+function aggregateResults(searches) {
+    const urlMap = new Map();
+    for (const search of searches) {
+        for (const result of search.results) {
+            const normalizedUrl = normalizeUrl(result.link);
+            const existing = urlMap.get(normalizedUrl);
+            if (existing) {
+                existing.frequency += 1;
+                existing.positions.push(result.position);
+                existing.queries.push(search.keyword);
+                existing.bestPosition = Math.min(existing.bestPosition, result.position);
+                existing.totalScore += getCtrWeight(result.position);
+                // Keep best title/snippet (from highest position)
+                if (result.position < existing.positions[0]) {
+                    existing.title = result.title;
+                    existing.snippet = result.snippet;
+                }
+            }
+            else {
+                urlMap.set(normalizedUrl, {
+                    url: result.link,
+                    title: result.title,
+                    snippet: result.snippet,
+                    frequency: 1,
+                    positions: [result.position],
+                    queries: [search.keyword],
+                    bestPosition: result.position,
+                    totalScore: getCtrWeight(result.position),
+                });
+            }
+        }
+    }
+    return urlMap;
+}
+/**
+ * Normalize URL for deduplication
+ * Removes trailing slashes, www prefix, and normalizes protocol
+ */
+function normalizeUrl(url) {
+    try {
+        const parsed = new URL(url);
+        let host = parsed.hostname.replace(/^www\./, '');
+        let path = parsed.pathname.replace(/\/$/, '') || '/';
+        return `${host}${path}${parsed.search}`.toLowerCase();
+    }
+    catch {
+        return url.toLowerCase().replace(/\/$/, '');
+    }
+}
+/**
+ * Filter URLs by minimum frequency
+ * Returns URLs appearing in at least minFrequency searches
+ */
+function filterByFrequency(urlMap, minFrequency) {
+    const filtered = [];
+    for (const url of urlMap.values()) {
+        if (url.frequency >= minFrequency) {
+            filtered.push(url);
+        }
+    }
+    return filtered;
+}
+/**
+ * Calculate weighted scores and normalize to 100.0
+ * Returns sorted array with rank assignments
+ */
+function calculateWeightedScores(urls) {
+    if (urls.length === 0)
+        return [];
+    // Sort by total score descending
+    const sorted = [...urls].sort((a, b) => b.totalScore - a.totalScore);
+    // Find max score for normalization
+    const maxScore = sorted[0].totalScore;
+    // Map to ranked URLs with normalized scores
+    return sorted.map((url, index) => ({
+        url: url.url,
+        title: url.title,
+        snippet: url.snippet,
+        rank: index + 1,
+        score: maxScore > 0 ? (url.totalScore / maxScore) * 100 : 0,
+        frequency: url.frequency,
+        positions: url.positions,
+        queries: url.queries,
+        bestPosition: url.bestPosition,
+        isConsensus: url.frequency >= 3,
+    }));
+}
+/**
+ * Mark consensus status for a URL
+ * Returns "✓" if frequency >= 3, else "✗"
+ */
+export function markConsensus(frequency) {
+    return frequency >= 3 ? '✓' : '✗';
+}
+/**
+ * Generate justification for why a URL is ranked at its position
+ */
+function generateJustification(url, rank) {
+    const parts = [];
+    if (url.frequency >= 4) {
+        parts.push(`Appeared in ${url.frequency} different searches showing strong cross-query relevance`);
+    }
+    else if (url.frequency >= 3) {
+        parts.push(`Found across ${url.frequency} searches indicating solid topical coverage`);
+    }
+    else {
+        parts.push(`Appeared in ${url.frequency} search${url.frequency > 1 ? 'es' : ''}`);
+    }
+    if (url.bestPosition === 1) {
+        parts.push('ranked #1 in at least one search');
+    }
+    else if (url.bestPosition <= 3) {
+        parts.push(`best position was top-3 (#${url.bestPosition})`);
+    }
+    return parts.join(', ') + '.';
+}
+/**
+ * Generate enhanced narrative output for consensus URLs
+ */
+export function generateEnhancedOutput(rankedUrls, allKeywords, totalUniqueUrls, frequencyThreshold, thresholdNote) {
+    const lines = [];
+    // Header
+    lines.push(`## The Perfect Search Results (Aggregated from ${allKeywords.length} Queries)`);
+    lines.push('');
+    lines.push(`Based on ${allKeywords.length} distinct searches, we identified **${rankedUrls.length} high-consensus resources**. Here's what the data reveals:`);
+    lines.push('');
+    if (thresholdNote) {
+        lines.push(`> ${thresholdNote}`);
+        lines.push('');
+    }
+    // Top Consensus Resources
+    lines.push('### 🥇 Top Consensus Resources');
+    lines.push('');
+    for (const url of rankedUrls.slice(0, 20)) {
+        const highConsensus = url.frequency >= 4 ? ' ⭐ HIGHEST CONSENSUS' : '';
+        lines.push(`#### #${url.rank}: ${url.title} (Score: ${url.score.toFixed(1)})${highConsensus}`);
+        // Appeared in queries
+        const queriesList = url.queries.map(q => `"${q}"`).join(', ');
+        lines.push(`- **Appeared in:** ${url.frequency} queries (${queriesList})`);
+        // Best ranking
+        lines.push(`- **Best ranking:** Position ${url.bestPosition}`);
+        // Description (truncated snippet)
+        const description = url.snippet.length > 200
+            ? url.snippet.substring(0, 197) + '...'
+            : url.snippet;
+        lines.push(`- **Description:** ${description}`);
+        // Justification
+        lines.push(`- **Why it's #${url.rank}:** ${generateJustification(url, url.rank)}`);
+        // URL
+        lines.push(`- **URL:** ${url.url}`);
+        lines.push('');
+    }
+    // Metadata section
+    lines.push('---');
+    lines.push('');
+    lines.push('### 📈 Metadata');
+    lines.push('');
+    lines.push(`- **Total Queries:** ${allKeywords.length} (${allKeywords.join(', ')})`);
+    // Sort all URLs by frequency for the unique URLs list
+    const sortedByFreq = [...rankedUrls].sort((a, b) => b.frequency - a.frequency);
+    const urlFreqList = sortedByFreq
+        .slice(0, 30)
+        .map(u => {
+        const shortUrl = u.url.length > 40 ? u.url.substring(0, 37) + '...' : u.url;
+        return `${shortUrl} (${u.frequency}x)`;
+    })
+        .join(', ');
+    lines.push(`- **Unique URLs Found:** ${totalUniqueUrls} — top by frequency: ${urlFreqList}`);
+    lines.push(`- **Consensus Threshold:** ≥${frequencyThreshold} appearances`);
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Full aggregation pipeline with fallback thresholds
+ * Tries ≥3, falls back to ≥2, then ≥1 if needed
+ */
+export function aggregateAndRank(searches, minConsensusUrls = 5) {
+    const urlMap = aggregateResults(searches);
+    const totalUniqueUrls = urlMap.size;
+    const totalQueries = searches.length;
+    // Try thresholds in order: 3, 2, 1
+    const thresholds = [3, 2, 1];
+    let rankedUrls = [];
+    let usedThreshold = 3;
+    let thresholdNote;
+    for (const threshold of thresholds) {
+        const filtered = filterByFrequency(urlMap, threshold);
+        rankedUrls = calculateWeightedScores(filtered);
+        if (rankedUrls.length >= minConsensusUrls || threshold === 1) {
+            usedThreshold = threshold;
+            if (threshold < 3) {
+                thresholdNote = `Note: Frequency filter lowered to ≥${threshold} due to result diversity.`;
+            }
+            break;
+        }
+    }
+    return {
+        rankedUrls,
+        totalUniqueUrls,
+        totalQueries,
+        frequencyThreshold: usedThreshold,
+        thresholdNote,
+    };
+}
+/**
+ * Build URL lookup map for quick consensus checking during result formatting
+ */
+export function buildUrlLookup(rankedUrls) {
+    const lookup = new Map();
+    for (const url of rankedUrls) {
+        const normalized = normalizeUrl(url.url);
+        lookup.set(normalized, url);
+        // Also store original URL
+        lookup.set(url.url.toLowerCase(), url);
+    }
+    return lookup;
+}
+/**
+ * Look up a URL in the ranked results
+ */
+export function lookupUrl(url, lookup) {
+    const normalized = normalizeUrl(url);
+    return lookup.get(normalized) || lookup.get(url.toLowerCase());
+}
+//# sourceMappingURL=url-aggregator.js.map

package/dist/utils/url-aggregator.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "research-powerpack-mcp",
+  "version": "3.0.0",
+  "description": "The ultimate research MCP toolkit: Reddit mining, web search with CTR aggregation, AI-powered deep research, and intelligent web scraping - all in one modular package",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "research-powerpack-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "mcp",
+    "research",
+    "reddit",
+    "serper",
+    "search",
+    "ai",
+    "model-context-protocol",
+    "deep-research",
+    "web-scraping",
+    "claude",
+    "anthropic",
+    "openrouter",
+    "scraping",
+    "research-powerpack"
+  ],
+  "author": "Yiğit Konur <yigit35@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yigitkonur/research-powerpack-mcp"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.18.1",
+    "openai": "^4.77.0",
+    "zod": "^3.24.1",
+    "zod-to-json-schema": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}