@unclick/mcp-server 0.2.3 → 0.2.4

package/dist/openai-tool.js

@@ -0,0 +1,227 @@
+// OpenAI API integration for the UnClick MCP server.
+// Uses the OpenAI REST API via fetch - no external dependencies.
+// Users must supply an API key from platform.openai.com.
+const OPENAI_API_BASE = "https://api.openai.com/v1";
+// ─── Auth validation ──────────────────────────────────────────────────────────
+function requireKey(args) {
+    const key = String(args.api_key ?? "").trim();
+    if (!key)
+        throw new Error("api_key is required. Get one at platform.openai.com/api-keys.");
+    return key;
+}
+// ─── API helpers ──────────────────────────────────────────────────────────────
+async function openaiPost(apiKey, path, body, orgId) {
+    const headers = {
+        Authorization: `Bearer ${apiKey}`,
+        "Content-Type": "application/json",
+    };
+    if (orgId)
+        headers["OpenAI-Organization"] = orgId;
+    const res = await fetch(`${OPENAI_API_BASE}${path}`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body),
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const err = data.error;
+        const msg = err?.message ?? `HTTP ${res.status}`;
+        const code = err?.code ? ` (${err.code})` : "";
+        const type = err?.type ? ` [${err.type}]` : "";
+        throw new Error(`OpenAI error${type}${code}: ${msg}`);
+    }
+    return data;
+}
+async function openaiGet(apiKey, path) {
+    const res = await fetch(`${OPENAI_API_BASE}${path}`, {
+        headers: { Authorization: `Bearer ${apiKey}` },
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const err = data.error;
+        const msg = err?.message ?? `HTTP ${res.status}`;
+        throw new Error(`OpenAI error: ${msg}`);
+    }
+    return data;
+}
+// ─── Operations ───────────────────────────────────────────────────────────────
+export async function openaiChatCompletion(args) {
+    const apiKey = requireKey(args);
+    const model = String(args.model ?? "gpt-4o-mini");
+    const orgId = args.org_id ? String(args.org_id) : undefined;
+    // Parse messages
+    let messages;
+    if (Array.isArray(args.messages)) {
+        messages = args.messages;
+    }
+    else if (typeof args.messages === "string") {
+        try {
+            messages = JSON.parse(args.messages);
+        }
+        catch {
+            throw new Error("messages must be a JSON array of {role, content} objects.");
+        }
+    }
+    else if (args.prompt) {
+        // Convenience: single user message via 'prompt'
+        const systemPrompt = args.system_prompt ? String(args.system_prompt) : undefined;
+        messages = [];
+        if (systemPrompt)
+            messages.push({ role: "system", content: systemPrompt });
+        messages.push({ role: "user", content: String(args.prompt) });
+    }
+    else {
+        throw new Error("Either messages (array) or prompt (string) is required.");
+    }
+    if (messages.length === 0)
+        throw new Error("messages array must not be empty.");
+    const body = { model, messages };
+    if (args.max_tokens)
+        body.max_tokens = Number(args.max_tokens);
+    if (args.temperature !== undefined)
+        body.temperature = Number(args.temperature);
+    if (args.top_p !== undefined)
+        body.top_p = Number(args.top_p);
+    if (args.n !== undefined)
+        body.n = Number(args.n);
+    if (args.stop)
+        body.stop = args.stop;
+    if (args.response_format)
+        body.response_format = args.response_format;
+    if (args.seed !== undefined)
+        body.seed = Number(args.seed);
+    const result = await openaiPost(apiKey, "/chat/completions", body, orgId);
+    return {
+        id: result.id,
+        model: result.model,
+        created: new Date(result.created * 1000).toISOString(),
+        message: result.choices[0]?.message.content ?? null,
+        finish_reason: result.choices[0]?.finish_reason ?? null,
+        choices: result.choices.map((c) => ({
+            content: c.message.content,
+            finish_reason: c.finish_reason,
+        })),
+        usage: result.usage,
+    };
+}
+export async function openaiCreateEmbedding(args) {
+    const apiKey = requireKey(args);
+    const model = String(args.model ?? "text-embedding-3-small");
+    const orgId = args.org_id ? String(args.org_id) : undefined;
+    let input;
+    if (typeof args.input === "string") {
+        input = args.input;
+    }
+    else if (Array.isArray(args.input)) {
+        input = args.input;
+    }
+    else {
+        throw new Error("input is required (a string or array of strings to embed).");
+    }
+    const body = { model, input };
+    if (args.dimensions)
+        body.dimensions = Number(args.dimensions);
+    const result = await openaiPost(apiKey, "/embeddings", body, orgId);
+    return {
+        model: result.model,
+        embeddings: result.data.map((d) => ({
+            index: d.index,
+            dimensions: d.embedding.length,
+            embedding: d.embedding,
+        })),
+        usage: result.usage,
+    };
+}
+export async function openaiGenerateImage(args) {
+    const apiKey = requireKey(args);
+    const prompt = String(args.prompt ?? "").trim();
+    if (!prompt)
+        throw new Error("prompt is required.");
+    const model = String(args.model ?? "dall-e-3");
+    const n = Math.min(10, Math.max(1, Number(args.n ?? 1)));
+    const size = String(args.size ?? "1024x1024");
+    const quality = String(args.quality ?? "standard");
+    const style = args.style ? String(args.style) : undefined;
+    const responseFormat = String(args.response_format ?? "url");
+    const body = { model, prompt, n, size, quality, response_format: responseFormat };
+    if (style)
+        body.style = style;
+    const result = await openaiPost(apiKey, "/images/generations", body);
+    return {
+        count: result.data.length,
+        images: result.data.map((img) => ({
+            url: img.url ?? null,
+            b64_json: img.b64_json ?? null,
+            revised_prompt: img.revised_prompt ?? null,
+        })),
+    };
+}
+export async function openaiCreateTranscription(args) {
+    const apiKey = requireKey(args);
+    const audioUrl = String(args.audio_url ?? "").trim();
+    if (!audioUrl)
+        throw new Error("audio_url is required (URL of the audio file to transcribe).");
+    const model = String(args.model ?? "whisper-1");
+    const language = args.language ? String(args.language) : undefined;
+    const responseFormat = String(args.response_format ?? "json");
+    // Fetch the audio file
+    const audioRes = await fetch(audioUrl);
+    if (!audioRes.ok)
+        throw new Error(`Failed to fetch audio_url: HTTP ${audioRes.status}`);
+    const audioBlob = await audioRes.blob();
+    const filename = args.filename ? String(args.filename) : "audio.mp3";
+    const form = new FormData();
+    form.append("file", audioBlob, filename);
+    form.append("model", model);
+    form.append("response_format", responseFormat);
+    if (language)
+        form.append("language", language);
+    if (args.prompt)
+        form.append("prompt", String(args.prompt));
+    if (args.temperature !== undefined)
+        form.append("temperature", String(args.temperature));
+    const res = await fetch(`${OPENAI_API_BASE}/audio/transcriptions`, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${apiKey}` },
+        body: form,
+    });
+    if (!res.ok) {
+        let msg = `HTTP ${res.status}`;
+        try {
+            const data = await res.json();
+            const err = data.error;
+            msg = err?.message ?? msg;
+        }
+        catch { /* ignore */ }
+        throw new Error(`OpenAI transcription error: ${msg}`);
+    }
+    if (responseFormat === "json" || responseFormat === "verbose_json") {
+        const data = await res.json();
+        return {
+            text: data.text,
+            language: data.language ?? null,
+            duration: data.duration ?? null,
+            model,
+        };
+    }
+    else {
+        const text = await res.text();
+        return { text, model };
+    }
+}
+export async function openaiListModels(args) {
+    const apiKey = requireKey(args);
+    const data = await openaiGet(apiKey, "/models");
+    const models = data.data ?? [];
+    // Sort by creation date descending
+    models.sort((a, b) => b.created - a.created);
+    return {
+        count: models.length,
+        models: models.map((m) => ({
+            id: m.id,
+            created: new Date(m.created * 1000).toISOString(),
+            owned_by: m.owned_by,
+        })),
+    };
+}
+//# sourceMappingURL=openai-tool.js.map

package/dist/openai-tool.js.map

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

package/dist/paypal-tool.d.ts

@@ -0,0 +1,3 @@
+export declare function paypalOrders(args: Record<string, unknown>): Promise<unknown>;
+export declare function paypalInvoices(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=paypal-tool.d.ts.map

package/dist/paypal-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paypal-tool.d.ts","sourceRoot":"","sources":["../src/paypal-tool.ts"],"names":[],"mappings":"AAoHA,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAuBlF;AAID,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA6BpF"}

package/dist/paypal-tool.js

@@ -0,0 +1,157 @@
+// ─── PayPal REST API Tool ────────────────────────────────────────────────────
+// Covers orders, payments, and invoices.
+// Auth: OAuth 2.0 client credentials (client_id + client_secret).
+//   Access token is fetched automatically per request.
+// Base URLs:
+//   Live:    https://api-m.paypal.com
+//   Sandbox: https://api-m.sandbox.paypal.com
+// No external dependencies - native fetch only.
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function requireConfig(args) {
+    const client_id = String(args.client_id ?? "").trim();
+    const client_secret = String(args.client_secret ?? "").trim();
+    if (!client_id)
+        return { error: "client_id is required (PayPal application Client ID)." };
+    if (!client_secret)
+        return { error: "client_secret is required (PayPal application Client Secret)." };
+    return {
+        client_id,
+        client_secret,
+        sandbox: args.sandbox === true || String(args.sandbox) === "true",
+    };
+}
+function baseUrl(cfg) {
+    return cfg.sandbox ? "https://api-m.sandbox.paypal.com" : "https://api-m.paypal.com";
+}
+async function getPayPalToken(cfg) {
+    const credentials = Buffer.from(`${cfg.client_id}:${cfg.client_secret}`).toString("base64");
+    let response;
+    try {
+        response = await fetch(`${baseUrl(cfg)}/v1/oauth2/token`, {
+            method: "POST",
+            headers: {
+                Authorization: `Basic ${credentials}`,
+                "Content-Type": "application/x-www-form-urlencoded",
+                "Accept": "application/json",
+            },
+            body: "grant_type=client_credentials",
+        });
+    }
+    catch (err) {
+        return { error: `Network error fetching PayPal token: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    let data;
+    try {
+        data = await response.json();
+    }
+    catch {
+        return { error: "Non-JSON response from PayPal token endpoint." };
+    }
+    if (!response.ok) {
+        const d = data;
+        return { error: `PayPal auth failed (${response.status}): ${d["error_description"] ?? d["message"] ?? "unknown"}` };
+    }
+    return String(data["access_token"] ?? "");
+}
+async function paypalFetch(cfg, method, path, body, query) {
+    const tokenResult = await getPayPalToken(cfg);
+    if (typeof tokenResult === "object" && "error" in tokenResult)
+        return tokenResult;
+    const url = new URL(`${baseUrl(cfg)}${path}`);
+    if (query) {
+        for (const [k, v] of Object.entries(query)) {
+            if (v !== undefined)
+                url.searchParams.set(k, String(v));
+        }
+    }
+    let response;
+    try {
+        response = await fetch(url.toString(), {
+            method,
+            headers: {
+                Authorization: `Bearer ${tokenResult}`,
+                "Content-Type": "application/json",
+                "Accept": "application/json",
+            },
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+    }
+    catch (err) {
+        return { error: `Network error: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (response.status === 429) {
+        return { error: "PayPal rate limit reached. Wait before retrying.", status: 429 };
+    }
+    if (response.status === 204) {
+        return { success: true };
+    }
+    let data;
+    try {
+        data = await response.json();
+    }
+    catch {
+        return { error: `Non-JSON response (HTTP ${response.status})`, status: response.status };
+    }
+    if (!response.ok) {
+        const d = data;
+        return { error: d["message"] ?? d["error_description"] ?? "PayPal API error", status: response.status, detail: d };
+    }
+    return data;
+}
+// ─── paypal_orders ────────────────────────────────────────────────────────────
+export async function paypalOrders(args) {
+    const cfg = requireConfig(args);
+    if ("error" in cfg)
+        return cfg;
+    const action = String(args.action ?? "get");
+    switch (action) {
+        case "create": {
+            const intent = String(args.intent ?? "CAPTURE");
+            const purchase_units = args.purchase_units;
+            if (!purchase_units || !Array.isArray(purchase_units)) {
+                return { error: "purchase_units (array) is required for action='create'." };
+            }
+            return paypalFetch(cfg, "POST", "/v2/checkout/orders", { intent, purchase_units });
+        }
+        case "get": {
+            const order_id = String(args.order_id ?? "").trim();
+            if (!order_id)
+                return { error: "order_id is required for action='get'." };
+            return paypalFetch(cfg, "GET", `/v2/checkout/orders/${encodeURIComponent(order_id)}`);
+        }
+        default:
+            return { error: `Unknown action "${action}". Valid: create, get.` };
+    }
+}
+// ─── paypal_invoices ──────────────────────────────────────────────────────────
+export async function paypalInvoices(args) {
+    const cfg = requireConfig(args);
+    if ("error" in cfg)
+        return cfg;
+    const action = String(args.action ?? "list");
+    switch (action) {
+        case "list": {
+            return paypalFetch(cfg, "GET", "/v2/invoicing/invoices", undefined, {
+                page: args.page ? Number(args.page) : 1,
+                page_size: args.page_size ? Number(args.page_size) : 20,
+            });
+        }
+        case "create": {
+            if (!args.invoice || typeof args.invoice !== "object") {
+                return { error: "invoice object is required for action='create'." };
+            }
+            return paypalFetch(cfg, "POST", "/v2/invoicing/invoices", args.invoice);
+        }
+        case "send": {
+            const invoice_id = String(args.invoice_id ?? "").trim();
+            if (!invoice_id)
+                return { error: "invoice_id is required for action='send'." };
+            return paypalFetch(cfg, "POST", `/v2/invoicing/invoices/${encodeURIComponent(invoice_id)}/send`, {
+                send_to_invoicer: args.send_to_invoicer !== false,
+            });
+        }
+        default:
+            return { error: `Unknown action "${action}". Valid: list, create, send.` };
+    }
+}
+//# sourceMappingURL=paypal-tool.js.map

package/dist/paypal-tool.js.map

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

package/dist/pinterest-tool.d.ts

@@ -0,0 +1,7 @@
+export declare function listPinterestBoards(args: Record<string, unknown>): Promise<unknown>;
+export declare function getPinterestBoard(args: Record<string, unknown>): Promise<unknown>;
+export declare function listPinterestPins(args: Record<string, unknown>): Promise<unknown>;
+export declare function createPinterestPin(args: Record<string, unknown>): Promise<unknown>;
+export declare function searchPinterestPins(args: Record<string, unknown>): Promise<unknown>;
+export declare function getPinterestUser(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=pinterest-tool.d.ts.map

package/dist/pinterest-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinterest-tool.d.ts","sourceRoot":"","sources":["../src/pinterest-tool.ts"],"names":[],"mappings":"AAiEA,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA2BzF;AAGD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CASvF;AAGD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA4BvF;AAGD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBxF;AAGD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BzF;AAGD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBtF"}

package/dist/pinterest-tool.js

@@ -0,0 +1,219 @@
+// Pinterest visual discovery API.
+// Docs: https://developers.pinterest.com/docs/api/v5/
+// Auth: PINTEREST_ACCESS_TOKEN (Bearer)
+// Base: https://api.pinterest.com/v5
+const PINTEREST_BASE = "https://api.pinterest.com/v5";
+function getToken(args) {
+    const token = String(args.access_token ?? process.env.PINTEREST_ACCESS_TOKEN ?? "").trim();
+    if (!token)
+        throw new Error("access_token is required (or set PINTEREST_ACCESS_TOKEN env var).");
+    return token;
+}
+async function pinterestGet(token, path, params) {
+    const url = new URL(`${PINTEREST_BASE}${path}`);
+    if (params) {
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined && v !== "")
+                url.searchParams.set(k, v);
+        }
+    }
+    const res = await fetch(url.toString(), {
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+        },
+    });
+    if (res.status === 401)
+        throw new Error("Invalid Pinterest access token.");
+    if (res.status === 403)
+        throw new Error("Pinterest: access forbidden. Ensure your token has the required scopes.");
+    if (res.status === 404)
+        throw new Error(`Pinterest: resource not found at ${path}.`);
+    if (res.status === 429)
+        throw new Error("Pinterest rate limit exceeded.");
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`Pinterest HTTP ${res.status}: ${body || res.statusText}`);
+    }
+    return res.json();
+}
+async function pinterestPost(token, path, body) {
+    const res = await fetch(`${PINTEREST_BASE}${path}`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    if (res.status === 401)
+        throw new Error("Invalid Pinterest access token.");
+    if (res.status === 403)
+        throw new Error("Pinterest: access forbidden.");
+    if (res.status === 429)
+        throw new Error("Pinterest rate limit exceeded.");
+    if (!res.ok) {
+        const b = await res.text().catch(() => "");
+        throw new Error(`Pinterest HTTP ${res.status}: ${b || res.statusText}`);
+    }
+    return res.json();
+}
+// list_pinterest_boards
+export async function listPinterestBoards(args) {
+    try {
+        const token = getToken(args);
+        const params = {};
+        if (args.page_size)
+            params.page_size = String(args.page_size);
+        if (args.bookmark)
+            params.bookmark = String(args.bookmark);
+        if (args.privacy)
+            params.privacy = String(args.privacy);
+        const json = await pinterestGet(token, "/boards", params);
+        const items = (json.items ?? []);
+        return {
+            count: items.length,
+            bookmark: json.bookmark,
+            boards: items.map((b) => ({
+                id: b.id,
+                name: b.name,
+                description: b.description,
+                privacy: b.privacy,
+                pin_count: b.pin_count,
+                follower_count: b.follower_count,
+                created_at: b.created_at,
+                media: b.media,
+            })),
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// get_pinterest_board
+export async function getPinterestBoard(args) {
+    try {
+        const token = getToken(args);
+        const boardId = String(args.board_id ?? "").trim();
+        if (!boardId)
+            return { error: "board_id is required." };
+        return pinterestGet(token, `/boards/${boardId}`);
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// list_pinterest_pins
+export async function listPinterestPins(args) {
+    try {
+        const token = getToken(args);
+        const boardId = String(args.board_id ?? "").trim();
+        if (!boardId)
+            return { error: "board_id is required." };
+        const params = {};
+        if (args.page_size)
+            params.page_size = String(args.page_size);
+        if (args.bookmark)
+            params.bookmark = String(args.bookmark);
+        if (args.creative_types)
+            params.creative_types = String(args.creative_types);
+        const json = await pinterestGet(token, `/boards/${boardId}/pins`, params);
+        const items = (json.items ?? []);
+        return {
+            count: items.length,
+            bookmark: json.bookmark,
+            pins: items.map((p) => ({
+                id: p.id,
+                title: p.title,
+                description: p.description,
+                link: p.link,
+                media: p.media,
+                board_id: p.board_id,
+                created_at: p.created_at,
+            })),
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// create_pinterest_pin
+export async function createPinterestPin(args) {
+    try {
+        const token = getToken(args);
+        const boardId = String(args.board_id ?? "").trim();
+        if (!boardId)
+            return { error: "board_id is required." };
+        const mediaSourceUrl = String(args.media_source_url ?? "").trim();
+        if (!mediaSourceUrl)
+            return { error: "media_source_url is required." };
+        const body = {
+            board_id: boardId,
+            media_source: { source_type: "image_url", url: mediaSourceUrl },
+        };
+        if (args.title)
+            body.title = String(args.title);
+        if (args.description)
+            body.description = String(args.description);
+        if (args.link)
+            body.link = String(args.link);
+        if (args.board_section_id)
+            body.board_section_id = String(args.board_section_id);
+        return pinterestPost(token, "/pins", body);
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// search_pinterest_pins
+export async function searchPinterestPins(args) {
+    try {
+        const token = getToken(args);
+        const query = String(args.query ?? "").trim();
+        if (!query)
+            return { error: "query is required." };
+        const params = { query };
+        if (args.page_size)
+            params.page_size = String(args.page_size);
+        if (args.bookmark)
+            params.bookmark = String(args.bookmark);
+        const json = await pinterestGet(token, "/pins/search", params);
+        const items = (json.items ?? []);
+        return {
+            count: items.length,
+            bookmark: json.bookmark,
+            pins: items.map((p) => ({
+                id: p.id,
+                title: p.title,
+                description: p.description,
+                link: p.link,
+                media: p.media,
+                board_id: p.board_id,
+            })),
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// get_pinterest_user
+export async function getPinterestUser(args) {
+    try {
+        const token = getToken(args);
+        const json = await pinterestGet(token, "/user_account");
+        return {
+            username: json.username,
+            account_type: json.account_type,
+            profile_image: json.profile_image,
+            website_url: json.website_url,
+            pin_count: json.pin_count,
+            follower_count: json.follower_count,
+            following_count: json.following_count,
+            board_count: json.board_count,
+        };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=pinterest-tool.js.map