@striderlabs/mcp-thumbtack 1.0.0

package/dist/tools/get-projects.js

@@ -0,0 +1,180 @@
+import { getBrowserManager } from "../browser.js";
+import { loadSession, saveSession } from "../session.js";
+export async function getProjects(params) {
+    const manager = getBrowserManager();
+    await manager.init();
+    const page = await manager.getPage();
+    const context = manager.getContext();
+    const sessionLoaded = await loadSession(page, context);
+    // Navigate to projects page
+    await page.goto("https://www.thumbtack.com/projects", {
+        waitUntil: "domcontentloaded",
+        timeout: 30000,
+    });
+    await page.waitForTimeout(3000);
+    // Check if redirected to login
+    const currentUrl = page.url();
+    const requiresLogin = currentUrl.includes("/login") ||
+        currentUrl.includes("/signup") ||
+        !sessionLoaded;
+    if (requiresLogin) {
+        // Also check page content for auth wall
+        const hasAuthWall = await page.evaluate(() => {
+            return (!!document.querySelector('[class*="AuthWall"], [class*="LoginWall"]') ||
+                window.location.href.includes("/login"));
+        });
+        if (hasAuthWall) {
+            return {
+                projects: [],
+                totalCount: 0,
+                requiresLogin: true,
+                message: "Authentication required. Please log in to Thumbtack first. Visit https://www.thumbtack.com/login to sign in.",
+            };
+        }
+    }
+    // Apply status filter if provided
+    if (params.status && params.status !== "all") {
+        try {
+            const filterMap = {
+                active: ["Active", "In Progress", "active"],
+                completed: ["Completed", "Done", "completed"],
+            };
+            const filterTexts = filterMap[params.status] || [];
+            for (const filterText of filterTexts) {
+                try {
+                    const btn = await page.$(`button:has-text("${filterText}"), [role="tab"]:has-text("${filterText}")`);
+                    if (btn) {
+                        await btn.click();
+                        await page.waitForTimeout(1500);
+                        break;
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+        catch {
+            // Filter may not be available
+        }
+    }
+    // Extract projects from the page
+    const projects = await page.evaluate(() => {
+        const results = [];
+        // Look for project cards
+        const cardSelectors = [
+            '[data-test="project-card"]',
+            '[class*="ProjectCard"]',
+            '[class*="ProjectItem"]',
+            '[class*="project-card"]',
+            "article[class*='Project']",
+        ];
+        let cards = [];
+        for (const selector of cardSelectors) {
+            const found = document.querySelectorAll(selector);
+            if (found.length > 0) {
+                cards = found;
+                break;
+            }
+        }
+        cards.forEach((card) => {
+            try {
+                // Extract project title
+                const titleEl = card.querySelector('[data-test="project-title"], [class*="ProjectTitle"], h3, h2');
+                const title = titleEl?.textContent?.trim() || "Untitled Project";
+                // Extract provider name
+                const providerNameEl = card.querySelector('[data-test="pro-name"], [class*="ProviderName"]');
+                const providerName = providerNameEl?.textContent?.trim() || "Unknown Provider";
+                // Extract provider URL
+                const linkEl = card.querySelector('a[href*="/ca/"], a[href*="/pro/"]');
+                const providerUrl = linkEl?.href || null;
+                // Extract project URL
+                const projectLinkEl = card.querySelector('a[href*="/projects/"]');
+                const projectUrl = projectLinkEl?.href || null;
+                // Extract project ID
+                const idFromData = card.getAttribute("data-project-id") || card.getAttribute("data-id");
+                const idFromUrl = projectUrl?.match(/\/projects\/(\w+)/)?.[1];
+                const id = idFromData || idFromUrl || Math.random().toString(36).substr(2, 9);
+                // Extract service type
+                const serviceTypeEl = card.querySelector('[data-test="service-type"], [class*="ServiceType"], [class*="Category"]');
+                const serviceType = serviceTypeEl?.textContent?.trim() || "Service";
+                // Extract status
+                const statusEl = card.querySelector('[data-test="status"], [class*="Status"], [class*="badge"]');
+                const status = statusEl?.textContent?.trim() || "active";
+                // Extract dates
+                const startDateEl = card.querySelector('[data-test="start-date"], [class*="StartDate"], time');
+                const startDate = startDateEl?.getAttribute("datetime") || startDateEl?.textContent?.trim() || null;
+                const completedDateEl = card.querySelector('[data-test="completed-date"], [class*="CompletedDate"]');
+                const completedDate = completedDateEl?.getAttribute("datetime") || completedDateEl?.textContent?.trim() || null;
+                // Extract price
+                const priceEl = card.querySelector('[data-test="price"], [class*="Price"], [class*="Amount"]');
+                const price = priceEl?.textContent?.trim() || null;
+                // Extract location
+                const locationEl = card.querySelector('[data-test="location"], [class*="Location"]');
+                const location = locationEl?.textContent?.trim() || null;
+                // Extract description
+                const descEl = card.querySelector('[data-test="description"], [class*="Description"], p');
+                const description = descEl?.textContent?.trim() || null;
+                // Check if has review
+                const reviewEl = card.querySelector('[data-test="review-badge"], [class*="ReviewBadge"], [class*="Reviewed"]');
+                const hasReview = !!reviewEl;
+                // Extract rating if reviewed
+                const ratingEl = card.querySelector('[aria-label*="star"], [class*="Rating"]');
+                const ratingText = ratingEl?.getAttribute("aria-label") || ratingEl?.textContent || "";
+                const ratingMatch = ratingText.match(/(\d+\.?\d*)/);
+                const rating = ratingMatch ? parseFloat(ratingMatch[1]) : null;
+                // Provider image
+                const imgEl = card.querySelector("img");
+                const providerImageUrl = imgEl?.src || null;
+                results.push({
+                    id,
+                    title,
+                    providerName,
+                    providerUrl,
+                    providerImageUrl,
+                    serviceType,
+                    status,
+                    startDate,
+                    completedDate,
+                    price,
+                    location,
+                    description,
+                    hasReview,
+                    rating,
+                    projectUrl,
+                });
+            }
+            catch {
+                // Skip malformed cards
+            }
+        });
+        return results;
+    });
+    // Apply status filter in JS if server-side filter didn't work
+    let filteredProjects = projects;
+    if (params.status && params.status !== "all") {
+        filteredProjects = projects.filter((p) => {
+            const statusLower = p.status.toLowerCase();
+            if (params.status === "active") {
+                return (statusLower.includes("active") ||
+                    statusLower.includes("progress") ||
+                    statusLower.includes("open"));
+            }
+            else if (params.status === "completed") {
+                return (statusLower.includes("complete") ||
+                    statusLower.includes("done") ||
+                    statusLower.includes("finished"));
+            }
+            return true;
+        });
+    }
+    await saveSession(page, context).catch(() => { });
+    return {
+        projects: filteredProjects,
+        totalCount: filteredProjects.length,
+        requiresLogin: false,
+        message: filteredProjects.length > 0
+            ? `Found ${filteredProjects.length} project(s).`
+            : "No projects found for the specified filter.",
+    };
+}

package/dist/tools/get-provider.d.ts

@@ -0,0 +1,40 @@
+export interface GetProviderParams {
+    provider_id?: string;
+    provider_url?: string;
+}
+export interface Review {
+    author: string;
+    rating: number;
+    date: string;
+    text: string;
+    serviceType: string | null;
+}
+export interface ProviderDetails {
+    id: string;
+    name: string;
+    url: string;
+    profileImageUrl: string | null;
+    coverImageUrl: string | null;
+    rating: number | null;
+    reviewCount: number | null;
+    description: string;
+    location: string | null;
+    yearsInBusiness: number | null;
+    employees: string | null;
+    verified: boolean;
+    backgroundChecked: boolean;
+    licenseInfo: string | null;
+    insuranceInfo: string | null;
+    services: string[];
+    specialties: string[];
+    hireCount: number | null;
+    responseTime: string | null;
+    priceRange: string | null;
+    reviews: Review[];
+    contact: {
+        phone: string | null;
+        website: string | null;
+    };
+    socialLinks: Record<string, string>;
+}
+export declare function getProvider(params: GetProviderParams): Promise<ProviderDetails>;

package/dist/tools/get-provider.js

@@ -0,0 +1,186 @@
+import { getBrowserManager } from "../browser.js";
+import { loadSession, saveSession } from "../session.js";
+export async function getProvider(params) {
+    if (!params.provider_id && !params.provider_url) {
+        throw new Error("Either provider_id or provider_url must be provided");
+    }
+    const manager = getBrowserManager();
+    await manager.init();
+    const page = await manager.getPage();
+    const context = manager.getContext();
+    await loadSession(page, context);
+    // Build provider URL
+    let providerUrl = params.provider_url;
+    if (!providerUrl && params.provider_id) {
+        providerUrl = `https://www.thumbtack.com/pro/${params.provider_id}`;
+    }
+    await page.goto(providerUrl, {
+        waitUntil: "domcontentloaded",
+        timeout: 30000,
+    });
+    await page.waitForTimeout(3000);
+    // Extract provider details from the page
+    const details = await page.evaluate(() => {
+        // Helper to safely query text content
+        const getText = (selector) => {
+            const el = document.querySelector(selector);
+            return el?.textContent?.trim() || "";
+        };
+        const getAttr = (selector, attr) => {
+            const el = document.querySelector(selector);
+            return el?.getAttribute(attr) || null;
+        };
+        // Name
+        const name = getText("h1") ||
+            getText('[data-test="pro-name"]') ||
+            getText('[class*="BusinessName"]') ||
+            "";
+        // Profile image
+        const profileImageUrl = getAttr('img[data-test="profile-image"]', "src") ||
+            getAttr('[class*="ProfileImage"] img', "src") ||
+            getAttr(".profile-image img", "src") ||
+            null;
+        // Cover/header image
+        const coverImageUrl = getAttr('[class*="CoverImage"] img', "src") ||
+            getAttr('[class*="hero"] img', "src") ||
+            null;
+        // Rating
+        const ratingEl = document.querySelector('[aria-label*="star"], [data-test="rating-score"], [class*="RatingScore"]');
+        const ratingText = ratingEl?.getAttribute("aria-label") || ratingEl?.textContent || "";
+        const ratingMatch = ratingText.match(/(\d+\.?\d*)/);
+        const rating = ratingMatch ? parseFloat(ratingMatch[1]) : null;
+        // Review count
+        const reviewCountEl = document.querySelector('[data-test="review-count"], [class*="ReviewCount"]');
+        const reviewCountText = reviewCountEl?.textContent || "";
+        const reviewCountMatch = reviewCountText.match(/(\d+)/);
+        const reviewCount = reviewCountMatch ? parseInt(reviewCountMatch[1]) : null;
+        // Description/intro
+        const description = getText('[data-test="intro-text"]') ||
+            getText('[class*="Introduction"]') ||
+            getText('[class*="Bio"]') ||
+            getText(".introduction") ||
+            "";
+        // Location
+        const location = getText('[data-test="location"]') ||
+            getText('[class*="Location"]') ||
+            getText('[class*="ServiceArea"]') ||
+            null;
+        // Years in business
+        const yearsEl = document.querySelector('[data-test="years-in-business"], [class*="YearsInBusiness"]');
+        const yearsText = yearsEl?.textContent || "";
+        const yearsMatch = yearsText.match(/(\d+)/);
+        const yearsInBusiness = yearsMatch ? parseInt(yearsMatch[1]) : null;
+        // Employees
+        const employees = getText('[data-test="employees"]') ||
+            getText('[class*="Employees"]') ||
+            null;
+        // Verification badges
+        const verified = !!document.querySelector('[data-test="verified-badge"], [aria-label*="verified"], [class*="Verified"]');
+        const backgroundChecked = !!document.querySelector('[data-test="background-check"], [aria-label*="background"], [class*="BackgroundCheck"]');
+        // License info
+        const licenseInfo = getText('[data-test="license"]') ||
+            getText('[class*="License"]') ||
+            null;
+        // Insurance info
+        const insuranceInfo = getText('[data-test="insurance"]') ||
+            getText('[class*="Insurance"]') ||
+            null;
+        // Services offered
+        const serviceEls = document.querySelectorAll('[data-test="service-item"], [class*="ServiceItem"], [class*="service-tag"]');
+        const services = [];
+        serviceEls.forEach((el) => {
+            const text = el.textContent?.trim();
+            if (text)
+                services.push(text);
+        });
+        // Specialties
+        const specialtyEls = document.querySelectorAll('[data-test="specialty"], [class*="Specialty"]');
+        const specialties = [];
+        specialtyEls.forEach((el) => {
+            const text = el.textContent?.trim();
+            if (text)
+                specialties.push(text);
+        });
+        // Hire count
+        const hireEl = document.querySelector('[data-test="hire-count"], [class*="HireCount"]');
+        const hireText = hireEl?.textContent || "";
+        const hireMatch = hireText.match(/(\d+)/);
+        const hireCount = hireMatch ? parseInt(hireMatch[1]) : null;
+        // Response time
+        const responseTime = getText('[data-test="response-time"]') ||
+            getText('[class*="ResponseTime"]') ||
+            null;
+        // Price range
+        const priceRange = getText('[data-test="price-range"]') ||
+            getText('[class*="PriceRange"]') ||
+            null;
+        // Extract reviews
+        const reviews = [];
+        const reviewEls = document.querySelectorAll('[data-test="review"], [class*="ReviewItem"], [class*="review-card"]');
+        reviewEls.forEach((reviewEl) => {
+            const author = reviewEl.querySelector('[class*="author"], [data-test="reviewer-name"]')?.textContent?.trim() || "Anonymous";
+            const reviewRatingEl = reviewEl.querySelector('[aria-label*="star"], [class*="rating"]');
+            const reviewRatingText = reviewRatingEl?.getAttribute("aria-label") || reviewRatingEl?.textContent || "";
+            const reviewRatingMatch = reviewRatingText.match(/(\d+\.?\d*)/);
+            const reviewRating = reviewRatingMatch ? parseFloat(reviewRatingMatch[1]) : 5;
+            const date = reviewEl.querySelector('[class*="date"], time')?.textContent?.trim() || "";
+            const text = reviewEl.querySelector('[class*="body"], [data-test="review-text"], p')?.textContent?.trim() || "";
+            const serviceType = reviewEl.querySelector('[class*="service"], [data-test="service-type"]')?.textContent?.trim() || null;
+            if (author || text) {
+                reviews.push({ author, rating: reviewRating, date, text, serviceType });
+            }
+        });
+        // Contact info
+        const phoneEl = document.querySelector('a[href^="tel:"], [data-test="phone-number"]');
+        const phone = phoneEl?.href?.replace("tel:", "") || phoneEl?.textContent?.trim() || null;
+        const websiteEl = document.querySelector('[data-test="website-link"], a[data-test="external-link"]');
+        const website = websiteEl?.href || null;
+        // Social links
+        const socialLinks = {};
+        const socialSelectors = {
+            facebook: 'a[href*="facebook.com"]',
+            instagram: 'a[href*="instagram.com"]',
+            twitter: 'a[href*="twitter.com"]',
+            linkedin: 'a[href*="linkedin.com"]',
+            yelp: 'a[href*="yelp.com"]',
+        };
+        for (const [platform, selector] of Object.entries(socialSelectors)) {
+            const el = document.querySelector(selector);
+            if (el?.href) {
+                socialLinks[platform] = el.href;
+            }
+        }
+        return {
+            name,
+            profileImageUrl,
+            coverImageUrl,
+            rating,
+            reviewCount,
+            description,
+            location: location || null,
+            yearsInBusiness,
+            employees: employees || null,
+            verified,
+            backgroundChecked,
+            licenseInfo: licenseInfo || null,
+            insuranceInfo: insuranceInfo || null,
+            services,
+            specialties,
+            hireCount,
+            responseTime: responseTime || null,
+            priceRange: priceRange || null,
+            reviews: reviews.slice(0, 10),
+            contact: { phone, website },
+            socialLinks,
+        };
+    });
+    // Extract ID from URL
+    const urlMatch = page.url().match(/\/(\d+)\/?(?:\?.*)?$/);
+    const id = urlMatch ? urlMatch[1] : params.provider_id || "";
+    await saveSession(page, context).catch(() => { });
+    return {
+        id,
+        url: page.url(),
+        ...details,
+    };
+}

package/dist/tools/hire-provider.d.ts

@@ -0,0 +1,13 @@
+export interface HireProviderParams {
+    quote_id: string;
+    provider_id: string;
+}
+export interface HireProviderResult {
+    success: boolean;
+    message: string;
+    projectId: string | null;
+    providerName: string | null;
+    requiresLogin: boolean;
+    nextSteps: string[];
+}
+export declare function hireProvider(params: HireProviderParams): Promise<HireProviderResult>;

package/dist/tools/hire-provider.js

@@ -0,0 +1,195 @@
+import { getBrowserManager } from "../browser.js";
+import { loadSession, saveSession } from "../session.js";
+export async function hireProvider(params) {
+    const manager = getBrowserManager();
+    await manager.init();
+    const page = await manager.getPage();
+    const context = manager.getContext();
+    const sessionLoaded = await loadSession(page, context);
+    if (!sessionLoaded) {
+        return {
+            success: false,
+            message: "Authentication required. Please log in to Thumbtack first.",
+            projectId: null,
+            providerName: null,
+            requiresLogin: true,
+            nextSteps: [
+                "Visit https://www.thumbtack.com/login to sign in",
+                "Once logged in, navigate to your inbox to find the quote",
+                "Click 'Hire' on the provider's quote",
+            ],
+        };
+    }
+    // Navigate to the inbox/quote thread
+    await page.goto("https://www.thumbtack.com/inbox", {
+        waitUntil: "domcontentloaded",
+        timeout: 30000,
+    });
+    await page.waitForTimeout(2000);
+    // Check if redirected to login
+    const currentUrl = page.url();
+    if (currentUrl.includes("/login") || currentUrl.includes("/signup")) {
+        return {
+            success: false,
+            message: "Authentication required. Your session may have expired.",
+            projectId: null,
+            providerName: null,
+            requiresLogin: true,
+            nextSteps: [
+                "Visit https://www.thumbtack.com/login to sign in again",
+                "Then retry hiring the provider",
+            ],
+        };
+    }
+    // Try to find and click on the specific quote/conversation
+    let providerName = null;
+    let foundQuote = false;
+    // Look for the quote with matching ID
+    try {
+        const quoteSelectors = [
+            `[data-quote-id="${params.quote_id}"]`,
+            `[data-id="${params.quote_id}"]`,
+            `a[href*="${params.quote_id}"]`,
+            `a[href*="${params.provider_id}"]`,
+        ];
+        for (const selector of quoteSelectors) {
+            try {
+                const el = await page.$(selector);
+                if (el) {
+                    await el.click();
+                    foundQuote = true;
+                    await page.waitForTimeout(2000);
+                    break;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        if (!foundQuote) {
+            // Try navigating directly to the conversation
+            await page.goto(`https://www.thumbtack.com/inbox/${params.quote_id}`, { waitUntil: "domcontentloaded", timeout: 15000 });
+            await page.waitForTimeout(2000);
+        }
+    }
+    catch {
+        // Navigation may have worked partially
+    }
+    // Get provider name from current page context
+    providerName = await page.evaluate(() => {
+        return (document.querySelector('[data-test="pro-name"], h1, h2')?.textContent?.trim() || null);
+    });
+    // Find and click the "Hire" button
+    try {
+        const hireButtonSelectors = [
+            'button[data-test="hire-button"]',
+            'button:has-text("Hire")',
+            'button:has-text("Hire this pro")',
+            'button:has-text("Mark as hired")',
+            '[class*="HireButton"]',
+            'a[data-test="hire-cta"]',
+        ];
+        let hireClicked = false;
+        for (const selector of hireButtonSelectors) {
+            try {
+                const btn = await page.$(selector);
+                if (btn) {
+                    await btn.click();
+                    hireClicked = true;
+                    await page.waitForTimeout(2000);
+                    break;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        if (!hireClicked) {
+            return {
+                success: false,
+                message: "Could not find the 'Hire' button. The quote may have already been acted upon or the page structure has changed.",
+                projectId: null,
+                providerName,
+                requiresLogin: false,
+                nextSteps: [
+                    "Visit https://www.thumbtack.com/inbox to find your quotes manually",
+                    "Look for the provider's quote and click 'Hire' directly",
+                ],
+            };
+        }
+        // Handle confirmation dialog if it appears
+        await page.waitForTimeout(1000);
+        try {
+            const confirmBtn = await page.$('button[data-test="confirm-hire"], button:has-text("Confirm"), button:has-text("Yes, hire")');
+            if (confirmBtn) {
+                await confirmBtn.click();
+                await page.waitForTimeout(2000);
+            }
+        }
+        catch {
+            // No confirmation dialog
+        }
+        // Check for success state
+        const result = await page.evaluate(() => {
+            const successEl = document.querySelector('[data-test="hire-success"], [class*="HireSuccess"], [class*="HiredBadge"]');
+            const bodyText = document.body.textContent || "";
+            const isSuccess = !!successEl ||
+                bodyText.toLowerCase().includes("you hired") ||
+                bodyText.toLowerCase().includes("hired!") ||
+                bodyText.toLowerCase().includes("project created");
+            const projectIdEl = document.querySelector("[data-project-id]");
+            const projectId = projectIdEl?.getAttribute("data-project-id") || null;
+            // Extract next steps / success message
+            const nextStepsEls = document.querySelectorAll('[class*="NextStep"], [data-test="next-step"]');
+            const nextSteps = [];
+            nextStepsEls.forEach((el) => {
+                const text = el.textContent?.trim();
+                if (text)
+                    nextSteps.push(text);
+            });
+            return { isSuccess, projectId, nextSteps };
+        });
+        await saveSession(page, context).catch(() => { });
+        if (result.isSuccess) {
+            return {
+                success: true,
+                message: `Successfully hired ${providerName || "the provider"}! A project has been created.`,
+                projectId: result.projectId,
+                providerName,
+                requiresLogin: false,
+                nextSteps: result.nextSteps.length > 0
+                    ? result.nextSteps
+                    : [
+                        "Communicate with your provider through the Thumbtack inbox",
+                        "Agree on project details, timeline, and payment",
+                        "Leave a review after the project is complete",
+                    ],
+            };
+        }
+        else {
+            return {
+                success: false,
+                message: "Hire action was attempted but confirmation could not be verified. Please check your Thumbtack account.",
+                projectId: null,
+                providerName,
+                requiresLogin: false,
+                nextSteps: [
+                    "Visit https://www.thumbtack.com/projects to check if the project was created",
+                ],
+            };
+        }
+    }
+    catch (error) {
+        const err = error;
+        return {
+            success: false,
+            message: `Error during hire process: ${err.message}`,
+            projectId: null,
+            providerName,
+            requiresLogin: false,
+            nextSteps: [
+                "Try again or visit https://www.thumbtack.com/inbox to hire manually",
+            ],
+        };
+    }
+}

package/dist/tools/request-quote.d.ts

@@ -0,0 +1,20 @@
+export interface RequestQuoteParams {
+    provider_id: string;
+    service_type: string;
+    description: string;
+    location: string;
+    contact_info: {
+        name?: string;
+        email?: string;
+        phone?: string;
+    };
+}
+export interface QuoteRequestResult {
+    success: boolean;
+    message: string;
+    quoteId: string | null;
+    providerName: string | null;
+    estimatedResponseTime: string | null;
+    requiresLogin: boolean;
+}
+export declare function requestQuote(params: RequestQuoteParams): Promise<QuoteRequestResult>;