@thenavidm/facebook-ad-library-mcp 0.1.0

package/dist/tools/search.js

@@ -0,0 +1,165 @@
+/**
+ * Finding ads and advertisers. The tools people actually reach for.
+ */
+import { z } from "zod";
+import { buildUrl } from "../adlibrary/url.js";
+import { detail, summarise } from "../format/ads.js";
+import { defineTool, searchArgs } from "./kit.js";
+const searchAds = defineTool({
+    name: "search_ads",
+    title: "Search the Ad Library",
+    description: "Search Meta's public Ad Library by keyword, or list every ad from one advertiser by " +
+        "passing page_id. Returns advertiser, copy, creative count, destination domain, call to " +
+        "action, platforms and how long each ad has run. Works for ordinary commercial " +
+        "advertisers in any country. Spend and reach are null outside the EU, which is correct " +
+        "rather than a failure: that data is only published for EU and political ads.",
+    schema: {
+        query: z
+            .string()
+            .optional()
+            .describe("Keyword: a brand, product or angle. Optional if page_id is given."),
+        page_id: z
+            .string()
+            .optional()
+            .describe("Advertiser Page ID. Returns that Page's ads instead of a keyword search. " +
+            "Use list_advertisers first if you only know the brand name."),
+        ...searchArgs,
+    },
+    handler: async (args, ctx) => {
+        const result = await ctx.backend.search({
+            query: args.query,
+            pageId: args.page_id,
+            country: args.country,
+            activeStatus: args.active_status,
+            adType: args.ad_type,
+            mediaType: args.media_type,
+            limit: args.limit,
+        });
+        // Record against the advertiser so diff_advertiser has a baseline later.
+        if (args.page_id && result.ads.length > 0) {
+            await ctx.store.record(args.page_id, result.ads);
+        }
+        return {
+            backend: result.backend,
+            count: result.count,
+            total_available: result.totalAvailable,
+            has_more: result.hasMore,
+            cursor: result.cursor,
+            url: result.url,
+            note: result.note,
+            ads: result.ads.map(summarise),
+        };
+    },
+});
+const listAdvertisers = defineTool({
+    name: "list_advertisers",
+    title: "Find advertisers",
+    description: "Resolve a brand name to the advertiser Pages actually running ads for it, ranked by how " +
+        "many ads each is running. Use this first when you know the brand but not its Page ID, " +
+        "then pass that ID to search_ads to get everything they run.",
+    schema: {
+        query: z.string().describe("Brand or company name to look up."),
+        country: z.string().length(2).optional().describe("Two-letter country code. Default US."),
+    },
+    handler: async (args, ctx) => {
+        const advertisers = await ctx.backend.listAdvertisers(args.query, args.country ?? "US");
+        return {
+            count: advertisers.length,
+            advertisers: advertisers.map((a) => ({
+                page_id: a.pageId,
+                name: a.pageName,
+                url: a.pageUrl,
+                likes: a.pageLikes,
+                verified: a.verified,
+                category: a.category,
+                ads_seen: a.adCount,
+            })),
+            note: advertisers.length === 0
+                ? "No advertisers found running ads for that term in this country. Try a broader " +
+                    "term, or active_status 'all' via search_ads."
+                : undefined,
+        };
+    },
+});
+const getAd = defineTool({
+    name: "get_ad",
+    title: "Get one ad in full",
+    description: "Fetch a single ad by its Ad Library ID, with every creative, all copy variants, the " +
+        "full destination URL and any transparency data. Use this after search_ads when one ad " +
+        "is worth studying properly.",
+    schema: {
+        library_id: z.string().describe("The Ad Library ID, the long number in an ad's URL."),
+        country: z.string().length(2).optional().describe("Two-letter country code. Default US."),
+    },
+    handler: async (args, ctx) => {
+        const ad = await ctx.backend.getAd(args.library_id, args.country ?? "US");
+        if (!ad) {
+            return {
+                found: false,
+                library_id: args.library_id,
+                note: "No ad with that ID came back. It may have been taken down, or the ID may be wrong.",
+            };
+        }
+        return { found: true, ad: detail(ad) };
+    },
+});
+const transcribeAd = defineTool({
+    name: "transcribe_ad",
+    title: "Transcribe a video ad",
+    description: "Speech to text for a video ad, so its spoken script becomes readable. Only the " +
+        "scrapecreators backend can do this. On any other backend it explains that rather than " +
+        "failing silently.",
+    schema: {
+        library_id: z.string().describe("The Ad Library ID of a video ad."),
+    },
+    handler: async (args, ctx) => {
+        if (!ctx.backend.transcribe) {
+            return {
+                available: false,
+                backend: ctx.backend.name,
+                note: "Transcription is only available on the scrapecreators backend. Set " +
+                    "SCRAPECREATORS_API_KEY and FBADS_BACKEND=scrapecreators to use it. The video URLs " +
+                    "from get_ad can be transcribed with your own tooling on any backend.",
+            };
+        }
+        const transcript = await ctx.backend.transcribe(args.library_id);
+        return {
+            available: true,
+            library_id: args.library_id,
+            transcript,
+            note: transcript ? undefined : "No transcript came back. The ad may not be a video.",
+        };
+    },
+});
+const adLibraryUrl = defineTool({
+    name: "ad_library_url",
+    title: "Build an Ad Library URL",
+    description: "Turn a set of filters into the public Ad Library URL, so a person can open the same " +
+        "search in a browser and check the results independently. Useful when a search comes " +
+        "back empty and you need to tell 'no results' apart from 'blocked'.",
+    schema: {
+        query: z.string().optional().describe("Keyword to search for."),
+        page_id: z.string().optional().describe("Advertiser Page ID, instead of a keyword."),
+        country: z.string().length(2).optional().describe("Two-letter country code. Default US."),
+        active_status: z.enum(["active", "inactive", "all"]).optional(),
+        media_type: z.enum(["all", "image", "meme", "video", "none"]).optional(),
+    },
+    touchesNetwork: false,
+    handler: async (args) => ({
+        url: buildUrl({
+            query: args.query,
+            pageId: args.page_id,
+            country: args.country,
+            activeStatus: args.active_status,
+            mediaType: args.media_type,
+        }),
+    }),
+});
+export const SEARCH_TOOLS = [
+    searchAds,
+    listAdvertisers,
+    getAd,
+    transcribeAd,
+    adLibraryUrl,
+];
+//# 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/tools/session.d.ts

@@ -0,0 +1,3 @@
+/** What this server is configured to do right now. */
+import { type AnyToolSpec } from "./kit.js";
+export declare const SESSION_TOOLS: AnyToolSpec[];

package/dist/tools/session.js

@@ -0,0 +1,23 @@
+/** What this server is configured to do right now. */
+import { defineTool } from "./kit.js";
+const backendStatus = defineTool({
+    name: "backend_status",
+    title: "Backend status",
+    description: "Which backend is serving requests, whether it costs money per call, and which optional " +
+        "features are available in this configuration. Call this when a tool reports something " +
+        "unavailable, before telling the user it cannot be done.",
+    schema: {},
+    touchesNetwork: false,
+    handler: async (_args, ctx) => ({
+        backend: ctx.backend.name,
+        needs_api_key: ctx.backend.needsKey,
+        costs_money_per_request: ctx.backend.needsKey,
+        transcription_available: typeof ctx.backend.transcribe === "function",
+        eu_transparency_available: Boolean(ctx.config.archiveToken),
+        tracked_advertisers: await ctx.store.trackedPages(),
+        note: "The browser backend is free and drives Chromium locally, so it cannot run in a " +
+            "serverless function. Provider backends bill per ad returned and run anywhere.",
+    }),
+});
+export const SESSION_TOOLS = [backendStatus];
+//# sourceMappingURL=session.js.map

package/dist/tools/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/tools/session.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,OAAO,EAAE,UAAU,EAAoB,MAAM,UAAU,CAAC;AAExD,MAAM,aAAa,GAAG,UAAU,CAAC;IAC/B,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,gBAAgB;IACvB,WAAW,EACT,yFAAyF;QACzF,wFAAwF;QACxF,yDAAyD;IAC3D,MAAM,EAAE,EAAE;IACV,cAAc,EAAE,KAAK;IACrB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9B,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI;QACzB,aAAa,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ;QACnC,uBAAuB,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ;QAC7C,uBAAuB,EAAE,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,UAAU;QACrE,yBAAyB,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC;QAC3D,mBAAmB,EAAE,MAAM,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE;QACnD,IAAI,EACF,iFAAiF;YACjF,+EAA+E;KAClF,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAkB,CAAC,aAAa,CAAkB,CAAC"}

package/dist/tools/track.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Change over time.
+ *
+ * Every other tool answers "what is running". This one answers "what changed",
+ * which is the question worth asking about a competitor and the one no snapshot
+ * can reach. It needs a baseline, so the first call records one.
+ */
+import { type AnyToolSpec } from "./kit.js";
+export declare const TRACK_TOOLS: AnyToolSpec[];

package/dist/tools/track.js

@@ -0,0 +1,68 @@
+/**
+ * Change over time.
+ *
+ * Every other tool answers "what is running". This one answers "what changed",
+ * which is the question worth asking about a competitor and the one no snapshot
+ * can reach. It needs a baseline, so the first call records one.
+ */
+import { z } from "zod";
+import { summarise } from "../format/ads.js";
+import { defineTool } from "./kit.js";
+const diffAdvertiser = defineTool({
+    name: "diff_advertiser",
+    title: "What changed for an advertiser",
+    description: "Compare an advertiser's ads now against the last time this server looked, and report " +
+        "what they started and stopped running. The first call on a Page records a baseline and " +
+        "reports nothing changed, which is expected: call it again later to see movement. This " +
+        "is the only tool here that answers 'what changed' rather than 'what is running'.",
+    schema: {
+        page_id: z.string().describe("Advertiser Page ID to compare. Get it from list_advertisers."),
+        country: z.string().length(2).optional().describe("Two-letter country code. Default US."),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("How many ads to pull for the comparison. Keep it consistent between calls."),
+    },
+    handler: async (args, ctx) => {
+        const before = await ctx.store.snapshot(args.page_id);
+        const result = await ctx.backend.search({
+            pageId: args.page_id,
+            country: args.country,
+            activeStatus: "all",
+            limit: args.limit ?? 60,
+        });
+        await ctx.store.record(args.page_id, result.ads);
+        if (before.size === 0) {
+            return {
+                baseline_created: true,
+                page_id: args.page_id,
+                tracked_now: result.count,
+                note: "No earlier snapshot existed, so this call recorded a baseline. Run it again later " +
+                    "to see what started and stopped.",
+            };
+        }
+        const now = new Map(result.ads.map((ad) => [ad.libraryId, ad]));
+        const started = result.ads.filter((ad) => !before.has(ad.libraryId));
+        const stopped = [...before.values()].filter((ad) => !now.has(ad.libraryId));
+        return {
+            baseline_created: false,
+            page_id: args.page_id,
+            previously_tracked: before.size,
+            running_now: now.size,
+            started_running: started.map(summarise),
+            no_longer_seen: stopped.map((ad) => ({
+                ...summarise(ad),
+                first_seen: new Date(ad.firstSeen).toISOString().slice(0, 10),
+                last_seen: new Date(ad.lastSeen).toISOString().slice(0, 10),
+            })),
+            note: "'no_longer_seen' means the ad was absent from this result set. That usually means it " +
+                "stopped, but a smaller limit or a different country explains it too. Keep both " +
+                "consistent between calls for a clean comparison.",
+        };
+    },
+});
+export const TRACK_TOOLS = [diffAdvertiser];
+//# sourceMappingURL=track.js.map

package/dist/tools/track.js.map

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

package/dist/tools/transparency.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Meta's official transparency data, layered on top of whichever backend is active.
+ */
+import { type AnyToolSpec } from "./kit.js";
+export declare const TRANSPARENCY_TOOLS: AnyToolSpec[];

package/dist/tools/transparency.js

@@ -0,0 +1,53 @@
+/**
+ * Meta's official transparency data, layered on top of whichever backend is active.
+ */
+import { z } from "zod";
+import { ArchiveClient } from "../archive/client.js";
+import { AdLibraryError } from "../errors.js";
+import { defineTool } from "./kit.js";
+const getEuTransparency = defineTool({
+    name: "get_eu_transparency",
+    title: "EU spend and reach",
+    description: "Spend, impressions, reach and demographic breakdown from Meta's official Ad Library API. " +
+        "Covers ads delivered in the EU and political or issue ads anywhere. Returns nothing for " +
+        "an ordinary US commercial ad because that data is not published, which is the correct " +
+        "answer rather than an error. Needs META_ADS_ARCHIVE_TOKEN, which is free.",
+    schema: {
+        query: z.string().optional().describe("Brand or advertiser name to look up."),
+        page_ids: z
+            .string()
+            .optional()
+            .describe("Comma-separated Page IDs, as a more precise alternative to query."),
+        country: z
+            .string()
+            .length(2)
+            .optional()
+            .describe("Two-letter EU country code, e.g. DE, FR, IE. Default DE."),
+        limit: z.number().int().min(1).max(100).optional().describe("Maximum ads to return."),
+    },
+    handler: async (args, ctx) => {
+        if (!ctx.config.archiveToken) {
+            throw new AdLibraryError("No Meta Ad Library API token is configured.", {
+                hint: "Set META_ADS_ARCHIVE_TOKEN. It is free: create a Meta app and generate a token. " +
+                    "Every other tool works without it, they just cannot return spend or reach.",
+            });
+        }
+        const client = new ArchiveClient(ctx.config.archiveToken);
+        const result = await client.search({
+            query: args.query,
+            pageIds: args.page_ids?.split(",").map((id) => id.trim()).filter(Boolean),
+            country: args.country,
+            limit: args.limit,
+        });
+        return {
+            count: result.count,
+            country: result.country,
+            fields_returned: result.fieldsReturned,
+            next: result.next,
+            note: result.note,
+            ads: result.ads,
+        };
+    },
+});
+export const TRANSPARENCY_TOOLS = [getEuTransparency];
+//# sourceMappingURL=transparency.js.map

package/dist/tools/transparency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transparency.js","sourceRoot":"","sources":["../../src/tools/transparency.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAoB,MAAM,UAAU,CAAC;AAExD,MAAM,iBAAiB,GAAG,UAAU,CAAC;IACnC,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EACT,2FAA2F;QAC3F,0FAA0F;QAC1F,wFAAwF;QACxF,2EAA2E;IAC7E,MAAM,EAAE;QACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QAC7E,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,mEAAmE,CAAC;QAChF,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,MAAM,CAAC,CAAC,CAAC;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,0DAA0D,CAAC;QACvE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;KACtF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAC7B,MAAM,IAAI,cAAc,CAAC,6CAA6C,EAAE;gBACtE,IAAI,EACF,kFAAkF;oBAClF,4EAA4E;aAC/E,CAAC,CAAC;QACL,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;YACjC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YACzE,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,eAAe,EAAE,MAAM,CAAC,cAAc;YACtC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,EAAE,MAAM,CAAC,GAAG;SAChB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAkB,CAAC,iBAAiB,CAAkB,CAAC"}

package/dist/transport/http.d.ts

@@ -0,0 +1,23 @@
+/**
+ * HTTP transport, for running the server somewhere always on.
+ *
+ * Streamable HTTP per the 2025-03-26 spec, stateless: every request builds its
+ * own transport and tears it down. No session map means no session leak, which
+ * matters far more than the reconnect support a stateful server would buy.
+ *
+ * Bound to 127.0.0.1 by default. This server reads a public archive, so the risk
+ * is not stolen data: it is that binding 0.0.0.0 hands anyone on the network a
+ * free browser to drive, or a provider key to spend. FBADS_HTTP_TOKEN adds bearer
+ * auth, and FBADS_HTTP_HOST is there for people who mean it.
+ */
+import type { BuiltServer } from "../server.js";
+export type HttpOptions = {
+    port: number;
+    host: string;
+    /** When set, every request must send `Authorization: Bearer <token>`. */
+    token?: string;
+};
+export declare function httpOptionsFromEnv(argv?: string[]): HttpOptions;
+export declare function startHttpServer(built: BuiltServer, options: HttpOptions): Promise<{
+    close: () => Promise<void>;
+}>;

package/dist/transport/http.js

@@ -0,0 +1,88 @@
+/**
+ * HTTP transport, for running the server somewhere always on.
+ *
+ * Streamable HTTP per the 2025-03-26 spec, stateless: every request builds its
+ * own transport and tears it down. No session map means no session leak, which
+ * matters far more than the reconnect support a stateful server would buy.
+ *
+ * Bound to 127.0.0.1 by default. This server reads a public archive, so the risk
+ * is not stolen data: it is that binding 0.0.0.0 hands anyone on the network a
+ * free browser to drive, or a provider key to spend. FBADS_HTTP_TOKEN adds bearer
+ * auth, and FBADS_HTTP_HOST is there for people who mean it.
+ */
+import { createServer } from "node:http";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+export function httpOptionsFromEnv(argv = []) {
+    const flag = argv.find((a) => a.startsWith("--port="));
+    const port = Number(flag?.split("=")[1] ?? process.env.FBADS_HTTP_PORT ?? 8787);
+    return {
+        port: Number.isFinite(port) && port > 0 ? port : 8787,
+        host: process.env.FBADS_HTTP_HOST || "127.0.0.1",
+        token: process.env.FBADS_HTTP_TOKEN || undefined,
+    };
+}
+async function readBody(req) {
+    const chunks = [];
+    for await (const chunk of req)
+        chunks.push(chunk);
+    const raw = Buffer.concat(chunks).toString("utf8");
+    if (!raw)
+        return undefined;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function startHttpServer(built, options) {
+    const http = createServer((req, res) => {
+        void handle(built, options, req, res).catch((error) => {
+            if (!res.headersSent)
+                res.writeHead(500, { "content-type": "application/json" });
+            res.end(JSON.stringify({
+                jsonrpc: "2.0",
+                error: { code: -32603, message: error?.message ?? "internal error" },
+                id: null,
+            }));
+        });
+    });
+    await new Promise((resolve) => http.listen(options.port, options.host, resolve));
+    process.stderr.write(`[facebook-ad-library-mcp] listening on http://${options.host}:${options.port}/mcp${options.token ? " (bearer token required)" : ""}\n`);
+    return {
+        close: () => new Promise((resolve) => {
+            http.close(() => resolve());
+        }),
+    };
+}
+async function handle(built, options, req, res) {
+    if (req.url === "/health") {
+        res.writeHead(200, { "content-type": "application/json" });
+        res.end(JSON.stringify({
+            ok: true,
+            tools: built.toolCount,
+            backend: built.backend.name,
+        }));
+        return;
+    }
+    if (options.token) {
+        const header = req.headers.authorization ?? "";
+        if (header !== `Bearer ${options.token}`) {
+            res.writeHead(401, { "content-type": "application/json" });
+            res.end(JSON.stringify({ error: "unauthorized" }));
+            return;
+        }
+    }
+    if (req.method === "DELETE") {
+        // Stateless: there is no session to end, and saying so beats a 404.
+        res.writeHead(204).end();
+        return;
+    }
+    // A fresh transport per request. `sessionIdGenerator: undefined` is what puts
+    // the SDK in stateless mode.
+    const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+    res.on("close", () => void transport.close());
+    await built.server.connect(transport);
+    await transport.handleRequest(req, res, await readBody(req));
+}
+//# sourceMappingURL=http.js.map

package/dist/transport/http.js.map

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

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@thenavidm/facebook-ad-library-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Meta's public Ad Library. Reads the real ad JSON rather than scraping rendered text, so it returns every creative, the true landing URL and the platform list. Free by default with no API key, with optional provider backends. Works with Claude Code, Claude Desktop, Cursor, Windsurf and any MCP-compatible client.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "facebook-ad-library-mcp": "./dist/index.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^3.25.76"
+  },
+  "optionalDependencies": {
+    "playwright": "^1.62.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "license": "MIT",
+  "author": "Navid Moazzez <https://navid.me>",
+  "homepage": "https://navid.me",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thenavidm/facebook-ad-library-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/thenavidm/facebook-ad-library-mcp/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "facebook-ads",
+    "meta-ad-library",
+    "ad-library",
+    "competitive-research",
+    "ad-intelligence",
+    "mcp-server",
+    "claude",
+    "claude-code",
+    "ai-agents",
+    "llm-tools"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "SKILL.md",
+    "LICENSE"
+  ]
+}