mcp-meupc

Instructions

Implementation Reference

• src/tools/get-component-details.ts:11-104 (handler)

  Main handler function getComponentDetails that fetches and parses component details from meupc.net. Extracts name, category, image, technical specifications, prices from multiple stores, and calculates the lowest price. Returns a JSON string with all component details.
  export async function getComponentDetails(params: GetComponentDetailsParams): Promise<string> { const { url } = params; const $ = await fetchPage(url); const name = $("h1.title").first().text().trim(); // Extrair categoria do breadcrumb const breadcrumbs = $("nav.breadcrumb li a"); let category: string | null = null; breadcrumbs.each((_, el) => { const href = $(el).attr("href") ?? ""; if (href.match(/meupc\.net\/\w/) && !href.includes("/peca/")) { category = $(el).text().trim(); } }); // Imagem principal const image = $("div.glide ul.glide__slides li.glide__slide figure img").first().attr("src") ?? $("figure.image img").first().attr("src") ?? null; // Especificações técnicas (primeira table.table.is-striped) const specs: Record<string, string> = {}; $("table.table.is-striped tr").each((_, row) => { const label = $(row).find("th").text().trim(); if (!label) return; const td = $(row).find("td"); // Verificar valores booleanos (ícones sim/não) const yesIcon = td.find('span.icon[title="Sim"]'); const noIcon = td.find('span.icon[title="Não"], span.icon[title="Nao"], span.icon[title="Não/Nenhum"], span.icon[title="Nao/Nenhum"]'); let value: string; if (yesIcon.length > 0) { value = "Sim"; } else if (noIcon.length > 0) { value = "Não"; } else { value = td.text().trim(); } if (label && value) { specs[label] = value; } }); // Preços por loja (table.table.is-responsive) const prices: StorePrice[] = []; $("table.table.is-responsive tbody tr").each((_, row) => { const $row = $(row); const storeImg = $row.find("th a.loja-img img"); const store = storeImg.attr("alt")?.trim() ?? storeImg.attr("title")?.trim() ?? ""; if (!store) return; const priceTd = $row.find('td[data-label="Preco"], td.table-responsive-fullwidth.has-text-right'); const priceText = priceTd.find("a.has-text-weight-bold").first().text().trim(); const price = parsePrice(priceText); const pixTd = $row.find('td[data-label="Preco PIX"]'); const pixText = pixTd.find("a.has-text-weight-bold").first().text().trim(); const pricePix = parsePrice(pixText); const buyLink = $row.find("a.button.is-buy").attr("href") ?? null; // Verificar disponibilidade — se não tem preço, não está disponível const available = price !== null || pricePix !== null; prices.push({ store, price: price ?? 0, pricePix, url: buyLink ? absoluteUrl(buyLink) : null, available, }); }); // Menor preço (PIX se disponível, senão normal) const allPrices = prices .filter(p => p.available) .flatMap(p => [p.pricePix, p.price].filter((v): v is number => v !== null && v > 0)); const lowestPrice = allPrices.length > 0 ? Math.min(...allPrices) : null; const result: ComponentDetails = { name, category, specs, prices, lowestPrice, url: absoluteUrl(url), image: image ? absoluteUrl(image) : null, }; return JSON.stringify(result, null, 2); }
• src/tools/get-component-details.ts:5-9 (schema)

  Zod schema definition for input validation. getComponentDetailsSchema defines a single 'url' parameter accepting either a relative path or full URL to a component page.
  export const getComponentDetailsSchema = z.object({ url: z.string().describe("URL do componente (ex: '/peca/W6UIQZ/processador-amd-ryzen-7-5800x3d' ou URL completa)"), }); export type GetComponentDetailsParams = z.infer<typeof getComponentDetailsSchema>;
• src/index.ts:34-41 (registration)

  MCP tool registration for 'get_component_details'. Registers the handler with the server using the schema shape and async handler that returns the result as text content.
  server.tool( "get_component_details", "Detalhes completos de um componente: especificações técnicas, preços por loja (PIX e normal), menor preço", getComponentDetailsSchema.shape, async (params) => ({ content: [{ type: "text", text: await getComponentDetails(params) }], }) );
• src/scraper.ts:11-49 (helper)

  Helper utilities used by getComponentDetails: fetchPage (fetches and parses HTML), absoluteUrl (converts relative URLs to absolute), and parsePrice (extracts numeric values from price strings).
  export async function fetchPage(path: string): Promise<CheerioAPI> { const url = path.startsWith("http") ? path : `${BASE_URL}${path.startsWith("/") ? "" : "/"}${path}`; const controller = new AbortController(); const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT); try { const response = await fetch(url, { headers: { "User-Agent": USER_AGENT, "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8", "Accept-Language": "pt-BR,pt;q=0.9,en-US;q=0.8,en;q=0.7", }, signal: controller.signal, }); if (!response.ok) { throw new Error(`HTTP ${response.status}: ${response.statusText} — ${url}`); } const html = await response.text(); return cheerio.load(html); } finally { clearTimeout(timeout); } } export function absoluteUrl(path: string | undefined | null): string { if (!path) return ""; if (path.startsWith("http")) return path; return `${BASE_URL}${path.startsWith("/") ? "" : "/"}${path}`; } export function parsePrice(text: string | undefined | null): number | null { if (!text) return null; const cleaned = text.replace(/[R$\s.]/g, "").replace(",", "."); const num = parseFloat(cleaned); return isNaN(num) ? null : num; }
• src/types.ts:9-25 (schema)

  Type definitions for ComponentDetails and StorePrice interfaces that define the structure of the data returned by getComponentDetails handler.
  export interface ComponentDetails { name: string; category: string | null; specs: Record<string, string>; prices: StorePrice[]; lowestPrice: number | null; url: string; image: string | null; } export interface StorePrice { store: string; price: number; pricePix: number | null; url: string | null; available: boolean; }