@sellable/mcp 0.1.269 → 0.1.272

package/dist/tools/engage-discovery.d.ts

@@ -1,3 +1,14 @@
+type FollowerBandFit = "in_target_band" | "below_target_band" | "above_target_band" | "unknown";
+type ReachSignals = {
+    targetFollowerMin?: number;
+    targetFollowerMax?: number;
+    followerBandFit: FollowerBandFit;
+    engagementPer1kFollowers: number | null;
+    weightedEngagementPer1kFollowers: number | null;
+    reachPenaltyMultiplier: number;
+    reachAdjustedScore: number;
+    confidence: "high" | "medium" | "low";
+};
 export type EngagementPost = {
     postId: string;
     url: string;
@@ -7,6 +18,7 @@ export type EngagementPost = {
         name: string;
         headline: string;
         profileUrl: string;
+        followerCount?: number;
     };
     engagement: {
         likes: number;
@@ -14,6 +26,7 @@ export type EngagementPost = {
         shares: number;
         total: number;
     };
+    reachSignals?: ReachSignals;
     contentPreview: string;
 };
 export type SearchEngagementPostsInput = {
@@ -23,6 +36,8 @@ export type SearchEngagementPostsInput = {
     minTotalEngagement?: number;
     maxPosts?: number;
     excludePostUrls?: string[];
+    targetFollowerMin?: number;
+    targetFollowerMax?: number;
 };
 export type SearchEngagementPostsResponse = {
     success: boolean;
@@ -70,9 +85,18 @@ export declare const engageDiscoveryToolDefinitions: {
                 };
                 description: string;
             };
+            targetFollowerMin: {
+                type: string;
+                description: string;
+            };
+            targetFollowerMax: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
         additionalProperties: boolean;
     };
 }[];
 export declare function searchEngagementPosts(input: SearchEngagementPostsInput): Promise<SearchEngagementPostsResponse>;
+export {};

package/dist/tools/engage-discovery.js

@@ -32,6 +32,14 @@ export const engageDiscoveryToolDefinitions = [
                     items: { type: "string" },
                     description: "Optional list of post URLs to exclude (e.g. already engaged/scheduled).",
                 },
+                targetFollowerMin: {
+                    type: "number",
+                    description: "Optional lower bound for creator follower count when reach-normalizing hook/source quality.",
+                },
+                targetFollowerMax: {
+                    type: "number",
+                    description: "Optional upper bound for creator follower count when reach-normalizing hook/source quality.",
+                },
             },
             required: ["keywords"],
             additionalProperties: false,
@@ -63,6 +71,79 @@ function safeNumber(value) {
     const n = typeof value === "number" ? value : Number(value);
     return Number.isFinite(n) ? n : 0;
 }
+function round3(value) {
+    return Number(value.toFixed(3));
+}
+function parseFollowerCount(author) {
+    const direct = safeNumber(author?.followerCount);
+    if (direct > 0)
+        return direct;
+    const text = String(author?.followers || author?.followerCountText || "");
+    const match = text.match(/([\d,.]+)\s*([kKmM])?/);
+    if (!match)
+        return undefined;
+    const base = Number(match[1].replace(/,/g, ""));
+    if (!Number.isFinite(base) || base <= 0)
+        return undefined;
+    const suffix = match[2]?.toLowerCase();
+    if (suffix === "m")
+        return Math.round(base * 1_000_000);
+    if (suffix === "k")
+        return Math.round(base * 1_000);
+    return Math.round(base);
+}
+function reachPenaltyMultiplier(followerCount, targetFollowerMin, targetFollowerMax) {
+    if (!followerCount || !targetFollowerMin || !targetFollowerMax)
+        return 0.4;
+    if (followerCount >= targetFollowerMin && followerCount <= targetFollowerMax) {
+        return 1;
+    }
+    if (followerCount < targetFollowerMin)
+        return 0.75;
+    if (followerCount <= targetFollowerMax * 2)
+        return 0.65;
+    if (followerCount <= targetFollowerMax * 5)
+        return 0.35;
+    return 0.15;
+}
+function followerBandFit(followerCount, targetFollowerMin, targetFollowerMax) {
+    if (!followerCount || !targetFollowerMin || !targetFollowerMax) {
+        return "unknown";
+    }
+    if (followerCount >= targetFollowerMin && followerCount <= targetFollowerMax) {
+        return "in_target_band";
+    }
+    if (followerCount < targetFollowerMin)
+        return "below_target_band";
+    return "above_target_band";
+}
+function buildReachSignals(params) {
+    const { followerCount, likes, comments, shares, total } = params;
+    const hasTarget = Boolean(params.targetFollowerMin && params.targetFollowerMax);
+    if (!hasTarget && !followerCount)
+        return undefined;
+    const weightedEngagement = likes + comments * 4 + shares * 12;
+    const penalty = reachPenaltyMultiplier(followerCount, params.targetFollowerMin, params.targetFollowerMax);
+    const engagementPer1kFollowers = followerCount
+        ? round3((total / followerCount) * 1000)
+        : null;
+    const weightedEngagementPer1kFollowers = followerCount
+        ? round3((weightedEngagement / followerCount) * 1000)
+        : null;
+    const reachAdjustedScore = weightedEngagementPer1kFollowers === null
+        ? 0
+        : round3(weightedEngagementPer1kFollowers * penalty);
+    return {
+        targetFollowerMin: params.targetFollowerMin,
+        targetFollowerMax: params.targetFollowerMax,
+        followerBandFit: followerBandFit(followerCount, params.targetFollowerMin, params.targetFollowerMax),
+        engagementPer1kFollowers,
+        weightedEngagementPer1kFollowers,
+        reachPenaltyMultiplier: penalty,
+        reachAdjustedScore,
+        confidence: followerCount ? (hasTarget ? "high" : "medium") : "low",
+    };
+}
 export async function searchEngagementPosts(input) {
     const api = getApi();
     const keywords = (input.keywords || [])
@@ -79,6 +160,12 @@ export async function searchEngagementPosts(input) {
     const maxPosts = typeof input.maxPosts === "number" && input.maxPosts > 0
         ? Math.min(50, input.maxPosts)
         : 25;
+    const targetFollowerMin = typeof input.targetFollowerMin === "number" && input.targetFollowerMin > 0
+        ? input.targetFollowerMin
+        : undefined;
+    const targetFollowerMax = typeof input.targetFollowerMax === "number" && input.targetFollowerMax > 0
+        ? input.targetFollowerMax
+        : undefined;
     const exclude = new Set((input.excludePostUrls || [])
         .map((u) => normalizePostUrl(u))
         .filter(Boolean));
@@ -87,10 +174,10 @@ export async function searchEngagementPosts(input) {
         keywords: keywords.map((keyword) => ({ keyword })),
         page,
     });
-    const rawPosts = Array.isArray(response?.topPostsForLLM)
-        ? response.topPostsForLLM
-        : Array.isArray(response?.posts)
-            ? response.posts
+    const rawPosts = Array.isArray(response?.posts)
+        ? response.posts
+        : Array.isArray(response?.topPostsForLLM)
+            ? response.topPostsForLLM
             : [];
     const now = Date.now();
     const oldestMs = now - maxAgeDays * 24 * 60 * 60 * 1000;
@@ -121,6 +208,16 @@ export async function searchEngagementPosts(input) {
             tooOld += 1;
             continue;
         }
+        const followerCount = parseFollowerCount(p?.author);
+        const reachSignals = buildReachSignals({
+            followerCount,
+            likes,
+            comments,
+            shares,
+            total,
+            targetFollowerMin,
+            targetFollowerMax,
+        });
         kept.push({
             postId: String(p?.id || ""),
             url,
@@ -132,18 +229,26 @@ export async function searchEngagementPosts(input) {
                 name: String(p?.author?.name || ""),
                 headline: String(p?.author?.headline || ""),
                 profileUrl: String(p?.author?.profileUrl || ""),
+                ...(followerCount ? { followerCount } : {}),
             },
             engagement: { likes, comments, shares, total },
+            ...(reachSignals ? { reachSignals } : {}),
             contentPreview: previewText(String(p?.content || ""), 220),
         });
-        if (kept.length >= maxPosts)
-            break;
     }
-    // Sort by total engagement desc for a predictable shortlist.
-    kept.sort((a, b) => b.engagement.total - a.engagement.total);
+    const hasReachTarget = Boolean(targetFollowerMin && targetFollowerMax);
+    kept.sort((a, b) => {
+        if (hasReachTarget) {
+            const reachDelta = (b.reachSignals?.reachAdjustedScore || 0) -
+                (a.reachSignals?.reachAdjustedScore || 0);
+            if (reachDelta !== 0)
+                return reachDelta;
+        }
+        return b.engagement.total - a.engagement.total;
+    });
     return {
         success: true,
-        posts: kept,
+        posts: kept.slice(0, maxPosts),
         totalReturned: rawPosts.length,
         filteredOut: { tooOld, excluded, tooLowEngagement },
     };

package/dist/tools/leads.js

@@ -1813,7 +1813,7 @@ export const leadToolDefinitions = [
     },
     {
         name: "search_prospeo",
-        description: 'Search Prospeo for people using filters and optional domainFilterId. Requires get_provider_prompt({ provider: "prospeo" }) first. Use Prospeo first for hiring-led targeting because it supports company_job_posting_hiring_for and company_job_posting_quantity; Sales Nav does not filter companies by hiring role. When targeting known accounts, call load_csv_domains for CSV-on-disk workflows or save_domain_filters for pasted/raw domain lists, then pass domainFilterId. For current LinkedIn job-post account-source asks, call search_harvest_jobs first, review the artifact, then confirm_harvest_job_companies to create a domainFilterId before using search_prospeo for people. For company lookalike/account asks, call search_prospeo_companies first, review accounts, then confirm_prospeo_company_accounts to create a domainFilterId before using search_prospeo for people. Raw domain inputs, LinkedIn company URLs as domains, and company-name targeting are NOT supported in this MCP tool. Strategy: start with 2-3 high-signal filters (title/seniority + industry or domainFilterId + headcount), add job-posting filters for hiring-led campaigns, then tighten one filter at a time. For security, AppSec, SOC, RevOps, Demand Gen, and similar function-specific lanes, do not widen with bare seniority labels like "Head" or "Director" alone; pair them with explicit function-title keywords and inspect the sample for off-function `Head of X` leakage. If output includes warnings/fallback, report that the MCP retried a rejected precise title request with a safer domain-filter people search instead of claiming the original precise filter succeeded. Prefer person location over company HQ unless HQ is explicitly needed. `campaignOfferId` routing rule: OMIT campaignOfferId ONLY in pre-mint Phase 84 `find leads` discovery mode (validating ICP before the commit gate). In every other context — post-mint lead additions, operator-driven searches on a live campaign, any search where the intent is to persist results to a specific campaign — you MUST pass campaignOfferId so the search shows up in that campaign\'s Contact Search panel. Post-mint create-campaign-v2 watch runs MUST pass currentStep: "prospeo". Omitting campaignOfferId post-mint orphans the search from the UI. Returns normalized results with pagination.',
+        description: 'Search Prospeo for people using filters and optional domainFilterId. Requires get_provider_prompt({ provider: "prospeo" }) first. Use Prospeo first for hiring-led targeting because it supports company_job_posting_hiring_for and company_job_posting_quantity; Sales Nav does not filter companies by hiring role. When targeting known accounts, call load_csv_domains for CSV-on-disk workflows or save_domain_filters for pasted/raw domain lists, then pass domainFilterId. For company lookalike/account asks, call search_prospeo_companies first, review accounts, then confirm_prospeo_company_accounts to create a domainFilterId before using search_prospeo for people. Raw domain inputs and company-name targeting are NOT supported in this MCP tool. Strategy: start with 2-3 high-signal filters (title/seniority + industry or domainFilterId + headcount), add job-posting filters for hiring-led campaigns, then tighten one filter at a time. For security, AppSec, SOC, RevOps, Demand Gen, and similar function-specific lanes, do not widen with bare seniority labels like "Head" or "Director" alone; pair them with explicit function-title keywords and inspect the sample for off-function `Head of X` leakage. If output includes warnings/fallback, report that the MCP retried a rejected precise title request with a safer domain-filter people search instead of claiming the original precise filter succeeded. Prefer person location over company HQ unless HQ is explicitly needed. `campaignOfferId` routing rule: OMIT campaignOfferId ONLY in pre-mint Phase 84 `find leads` discovery mode (validating ICP before the commit gate). In every other context — post-mint lead additions, operator-driven searches on a live campaign, any search where the intent is to persist results to a specific campaign — you MUST pass campaignOfferId so the search shows up in that campaign\'s Contact Search panel. Post-mint create-campaign-v2 watch runs MUST pass currentStep: "prospeo". Omitting campaignOfferId post-mint orphans the search from the UI. Returns normalized results with pagination.',
         inputSchema: {
             type: "object",
             properties: {

package/dist/tools/registry.d.ts

@@ -1260,6 +1260,19 @@ export declare const allTools: ({
             body?: undefined;
             validationReceipt?: undefined;
             status?: undefined;
+            postText?: undefined;
+            sourceLabel?: undefined;
+            measurementMode?: undefined;
+            requireBrowserMeasurement?: undefined;
+            clampLines?: undefined;
+            mobileClampLines?: undefined;
+            desktopClampLines?: undefined;
+            mobileTextWidthPx?: undefined;
+            desktopTextWidthPx?: undefined;
+            renderId?: undefined;
+            renderScreenshots?: undefined;
+            requireScreenshots?: undefined;
+            reviewClampLines?: undefined;
             updatedAt?: undefined;
             publishUrl?: undefined;
             activityId?: undefined;
@@ -1295,6 +1308,7 @@ export declare const allTools: ({
         properties: {
             draftId: {
                 type: string;
+                description?: undefined;
             };
             ideaId: {
                 type: string;
@@ -1339,6 +1353,19 @@ export declare const allTools: ({
             selectedPatterns?: undefined;
             previewBudget?: undefined;
             notes?: undefined;
+            postText?: undefined;
+            sourceLabel?: undefined;
+            measurementMode?: undefined;
+            requireBrowserMeasurement?: undefined;
+            clampLines?: undefined;
+            mobileClampLines?: undefined;
+            desktopClampLines?: undefined;
+            mobileTextWidthPx?: undefined;
+            desktopTextWidthPx?: undefined;
+            renderId?: undefined;
+            renderScreenshots?: undefined;
+            requireScreenshots?: undefined;
+            reviewClampLines?: undefined;
             updatedAt?: undefined;
             publishUrl?: undefined;
             activityId?: undefined;
@@ -1361,6 +1388,7 @@ export declare const allTools: ({
         properties: {
             draftId: {
                 type: string;
+                description?: undefined;
             };
             hookResearchId: {
                 type: string;
@@ -1403,6 +1431,19 @@ export declare const allTools: ({
             previewBudget?: undefined;
             notes?: undefined;
             createdAt?: undefined;
+            postText?: undefined;
+            sourceLabel?: undefined;
+            measurementMode?: undefined;
+            requireBrowserMeasurement?: undefined;
+            clampLines?: undefined;
+            mobileClampLines?: undefined;
+            desktopClampLines?: undefined;
+            mobileTextWidthPx?: undefined;
+            desktopTextWidthPx?: undefined;
+            renderId?: undefined;
+            renderScreenshots?: undefined;
+            requireScreenshots?: undefined;
+            reviewClampLines?: undefined;
             publishUrl?: undefined;
             activityId?: undefined;
             publishedAt?: undefined;
@@ -1424,6 +1465,7 @@ export declare const allTools: ({
         properties: {
             draftId: {
                 type: string;
+                description?: undefined;
             };
             publishUrl: {
                 type: string;
@@ -1464,6 +1506,19 @@ export declare const allTools: ({
             body?: undefined;
             validationReceipt?: undefined;
             status?: undefined;
+            postText?: undefined;
+            sourceLabel?: undefined;
+            measurementMode?: undefined;
+            requireBrowserMeasurement?: undefined;
+            clampLines?: undefined;
+            mobileClampLines?: undefined;
+            desktopClampLines?: undefined;
+            mobileTextWidthPx?: undefined;
+            desktopTextWidthPx?: undefined;
+            renderId?: undefined;
+            renderScreenshots?: undefined;
+            requireScreenshots?: undefined;
+            reviewClampLines?: undefined;
             updatedAt?: undefined;
             publishedPostId?: undefined;
             year?: undefined;
@@ -1516,6 +1571,19 @@ export declare const allTools: ({
             body?: undefined;
             validationReceipt?: undefined;
             status?: undefined;
+            postText?: undefined;
+            sourceLabel?: undefined;
+            measurementMode?: undefined;
+            requireBrowserMeasurement?: undefined;
+            clampLines?: undefined;
+            mobileClampLines?: undefined;
+            desktopClampLines?: undefined;
+            mobileTextWidthPx?: undefined;
+            desktopTextWidthPx?: undefined;
+            renderId?: undefined;
+            renderScreenshots?: undefined;
+            requireScreenshots?: undefined;
+            reviewClampLines?: undefined;
             updatedAt?: undefined;
             publishUrl?: undefined;
             activityId?: undefined;
@@ -1749,6 +1817,14 @@ export declare const allTools: ({
                 };
                 description: string;
             };
+            targetFollowerMin: {
+                type: string;
+                description: string;
+            };
+            targetFollowerMax: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
         additionalProperties: boolean;
@@ -1880,53 +1956,6 @@ export declare const allTools: ({
         };
         required: never[];
     };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            searchToken: {
-                type: string;
-                description: string;
-            };
-            selectedJobIds: {
-                type: string;
-                items: {
-                    type: string;
-                };
-                description: string;
-            };
-            name: {
-                type: string;
-            };
-            outputDir: {
-                type: string;
-                description: string;
-            };
-            fileBaseName: {
-                type: string;
-                description: string;
-            };
-            search?: undefined;
-            searches?: undefined;
-            location?: undefined;
-            geoId?: undefined;
-            postedLimit?: undefined;
-            sortBy?: undefined;
-            workplaceType?: undefined;
-            employmentType?: undefined;
-            experienceLevel?: undefined;
-            easyApply?: undefined;
-            under10Applicants?: undefined;
-            salary?: undefined;
-            pages?: undefined;
-            maxRows?: undefined;
-            artifactFormat?: undefined;
-        };
-        required: string[];
-        additionalProperties: boolean;
-    };
 } | {
     name: string;
     description: string;

package/dist/tools/registry.js

@@ -14,7 +14,6 @@ import { engageMemoryToolDefinitions } from "./engage-memory.js";
 import { engageStateToolDefinitions } from "./engage-state.js";
 import { enrichmentToolDefinitions } from "./enrichment.js";
 import { frameworkToolDefinitions } from "./framework.js";
-import { harvestJobToolDefinitions } from "./harvest-jobs.js";
 import { leadToolDefinitions } from "./leads.js";
 import { linkedinToolDefinitions } from "./linkedin.js";
 import { navigationToolDefinitions } from "./navigation.js";
@@ -44,7 +43,6 @@ export const allTools = [
     ...contentPostToolDefinitions,
     ...navigationToolDefinitions,
     ...leadToolDefinitions,
-    ...harvestJobToolDefinitions,
     ...enrichmentToolDefinitions,
     ...processingToolDefinitions,
     ...rubricToolDefinitions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/mcp",
-  "version": "0.1.269",
+  "version": "0.1.272",
   "type": "module",
   "description": "Sellable MCP server for Claude Code and Codex campaign workflows",
   "main": "dist/index.js",

package/skills/create-campaign/SKILL.md

@@ -29,8 +29,6 @@ allowed-tools:
   - mcp__sellable__search_prospeo
   - mcp__sellable__search_prospeo_companies
   - mcp__sellable__confirm_prospeo_company_accounts
-  - mcp__sellable__search_harvest_jobs
-  - mcp__sellable__confirm_harvest_job_companies
   - mcp__sellable__search_signals
   - mcp__sellable__fetch_post_engagers
   - mcp__sellable__enrich_with_prospeo
@@ -229,14 +227,6 @@ are likely. Sales Nav is useful for recent LinkedIn activity, role/title
 precision, and referral paths, but it does not provide hiring-by-role filters;
 say that distinction plainly in the source-plan gate.
 
-When the brief asks for current LinkedIn job-post intent, such as companies
-hiring Power BI developers this month, use Harvest jobs as the account source:
-`search_harvest_jobs -> confirm_harvest_job_companies -> search_prospeo`.
-First write and review the Harvest job artifact. Then confirm selected Harvest
-job IDs into a `domainFilterId`; Prospeo remains the people-search provider.
-Do not paste LinkedIn company URLs as domains. Do not fetch full job details for
-every search row by default; selected batches only.
-
 For company lookalikes, best-customer lookalikes, "companies like X",
 lookalike accounts, companies that use AI, companies with API/SSO/Chrome
 extension, news/award/integration/key-customer filters, or account discovery

package/skills/create-campaign/core/providers/prospeo.json

@@ -7,8 +7,6 @@
   "requiredTools": [
     "update_campaign",
     "get_provider_prompt",
-    "search_harvest_jobs",
-    "confirm_harvest_job_companies",
     "search_prospeo_companies",
     "confirm_prospeo_company_accounts",
     "search_prospeo",
@@ -26,14 +24,13 @@
     "useWhen": [
       "You want Prospeo filters or domain-based search",
       "You need company lookalike account discovery before finding people",
-      "You need current LinkedIn job-post evidence before finding hiring stakeholders",
       "You want companies like X, target-domain, best-customer/top-customer, or job-search employer lookalikes, or accounts using AI/API/SSO/Chrome extensions",
       "You need companies hiring for specific roles using job-posting filters",
       "You need high deliverability from Prospeo"
     ],
     "avoidWhen": ["You need LinkedIn activity filters"],
-    "reason": "Strong for hiring-led search, current LinkedIn job-post account sourcing, company/account lookalikes, Prospeo-specific filters, verified contacts, and domain lists.",
-    "prose": "Since you're targeting **{icp}**, I'd recommend **Prospeo**.\n\nHere's why:\n- Prospeo can discover lookalike accounts first, then turn approved accounts into a domainFilterId for people search\n- Harvest job search can source companies from current LinkedIn job posts, then confirm selected jobs into a domainFilterId for Prospeo people search\n- Prospeo can filter for companies hiring specific roles with job-posting filters\n- We can pair those company signals with buyer/referrer titles and verified-contact coverage\n\nFor current LinkedIn job-post evidence, I will use search_harvest_jobs -> confirm_harvest_job_companies -> search_prospeo. I will not paste LinkedIn company URLs as domains, and I will only fetch job details for selected batches. For lookalike accounts, I will show an account sample first; those account rows are not people leads yet. After approval, I will use the companySearchToken to confirm the accounts, then search people at the returned domainFilterId. For outbound lookalikes, I will use target/account/customer domains or verified past-customer accounts, not the sender's company. For job-search/application lookalikes, I can use current or past employers as existing-company seeds.\n\nShould I search Prospeo for {icp}?"
+    "reason": "Strong for hiring-led search, company/account lookalikes, Prospeo-specific filters, verified contacts, and domain lists.",
+    "prose": "Since you're targeting **{icp}**, I'd recommend **Prospeo**.\n\nHere's why:\n- Prospeo can discover lookalike accounts first, then turn approved accounts into a domainFilterId for people search\n- Prospeo can filter for companies hiring specific roles with job-posting filters\n- We can pair those company signals with buyer/referrer titles and verified-contact coverage\n\nFor lookalike accounts, I will show an account sample first; those account rows are not people leads yet. After approval, I will use the companySearchToken to confirm the accounts, then search people at the returned domainFilterId. For outbound lookalikes, I will use target/account/customer domains or verified past-customer accounts, not the sender's company. For job-search/application lookalikes, I can use current or past employers as existing-company seeds.\n\nShould I search Prospeo for {icp}?"
   },
   "askOption": {
     "label": "Prospeo",