@revclamp/google-ads-transparency-mcp-actor 0.0.0-stage → 1.0.0

package/glama.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://glama.ai/mcp/schemas/server.json",
+  "maintainers": [
+    "lhphong09t2"
+  ]
+}

package/index.mjs

@@ -0,0 +1,222 @@
+#!/usr/bin/env node
+
+/**
+ * Entrypoint & Barrel Export for RevClamp AdPulse - Google Ads Transparency MCP & Apify Actor (`index.mjs`)
+ */
+
+import fs from 'node:fs';
+import readline from 'node:readline';
+import { fileURLToPath } from 'node:url';
+import {
+  ALLOWED_GOOGLE_ADS_RPC_HOSTS,
+  verifyEgressUrlSsrfSafe,
+  assertAllowedGoogleAdsEgress,
+} from './src/egress_guard.mjs';
+
+import {
+  GOOGLE_ADS_RPC_ENDPOINTS,
+  ADVERTISER_ID_RE,
+  CREATIVE_ID_RE,
+  ISO_COUNTRY_RE,
+  ISO_COUNTRY_TO_GOOGLE_GEO_ID,
+  GOOGLE_GEO_ID_TO_ISO_COUNTRY,
+  MAX_RPC_RESPONSE_BYTES,
+  DEFAULT_RUN_DEADLINE_MS,
+  COMPOSITE_CURSOR_PREFIX,
+  MAX_CURSOR_LENGTH,
+  MAX_QUERY_LENGTH,
+  CORPORATE_LEGAL_SUFFIX_TOKENS,
+  collapseDottedAcronyms,
+  foldBrandText,
+  parseBrandQueryTokens,
+  validateBoundedIntegerParam,
+  computePaginationScopeHash,
+  encodeCompositeCursor,
+  decodePaginationCursor,
+  computeRewoundCursorForDeliveredPrefix,
+  verifyRpcResponseSchemaCanary,
+  scoreAdvertiserCandidate,
+  executeGoogleAdsRpcPost,
+  resolveAdvertiserEntities,
+  extractCreativeAssetUrls,
+  sanitizeUntrustedAdText,
+  createEmptyUntrustedAdContent,
+  extractStaticAdCopyFromContentJs,
+  fetchAndExtractStaticAdCopy,
+  normalizeCreativeRecord,
+  fetchAdvertiserCreatives,
+  getCreativeDetailsById,
+} from './src/rpc_client.mjs';
+
+import {
+  ACTOR_PRICING_CONTRACT,
+  computeChunkIdempotencyKey,
+  computeRunEconomicsTelemetry,
+  createApifyPlatformHooks,
+  loadApifyActorInput,
+  runGoogleAdsTransparencyActor,
+} from './src/apify_actor.mjs';
+
+import {
+  MCP_MAX_ENVELOPE_BYTES,
+  MCP_MAX_ITEMS_LIMIT,
+  MCP_MAX_REQ_ID_BYTES,
+  SUPPORTED_MCP_PROTOCOL_VERSIONS,
+  ENCODED_BRAND_ICON_DATA_URI,
+  MCP_SERVER_INFO,
+  MCP_TOOLS_MANIFEST,
+  sliceUtf8Safe,
+  truncateMcpResponseEnvelope,
+  validateMcpToolArguments,
+  handleMcpJsonRpcRequest,
+} from './src/mcp_server.mjs';
+
+import {
+  PLAYGROUND_CSP_HEADER,
+  MAX_PLAYGROUND_BODY_BYTES,
+  PLAYGROUND_REQUEST_TIMEOUT_MS,
+  createAdPulsePreviewServer,
+} from './src/web_preview_server.mjs';
+
+export {
+  ALLOWED_GOOGLE_ADS_RPC_HOSTS,
+  verifyEgressUrlSsrfSafe,
+  assertAllowedGoogleAdsEgress,
+  GOOGLE_ADS_RPC_ENDPOINTS,
+  ADVERTISER_ID_RE,
+  CREATIVE_ID_RE,
+  ISO_COUNTRY_RE,
+  ISO_COUNTRY_TO_GOOGLE_GEO_ID,
+  GOOGLE_GEO_ID_TO_ISO_COUNTRY,
+  MAX_RPC_RESPONSE_BYTES,
+  DEFAULT_RUN_DEADLINE_MS,
+  COMPOSITE_CURSOR_PREFIX,
+  MAX_CURSOR_LENGTH,
+  MAX_QUERY_LENGTH,
+  CORPORATE_LEGAL_SUFFIX_TOKENS,
+  collapseDottedAcronyms,
+  foldBrandText,
+  parseBrandQueryTokens,
+  validateBoundedIntegerParam,
+  computePaginationScopeHash,
+  encodeCompositeCursor,
+  decodePaginationCursor,
+  computeRewoundCursorForDeliveredPrefix,
+  verifyRpcResponseSchemaCanary,
+  scoreAdvertiserCandidate,
+  executeGoogleAdsRpcPost,
+  resolveAdvertiserEntities,
+  extractCreativeAssetUrls,
+  sanitizeUntrustedAdText,
+  createEmptyUntrustedAdContent,
+  extractStaticAdCopyFromContentJs,
+  fetchAndExtractStaticAdCopy,
+  normalizeCreativeRecord,
+  fetchAdvertiserCreatives,
+  getCreativeDetailsById,
+  ACTOR_PRICING_CONTRACT,
+  computeChunkIdempotencyKey,
+  computeRunEconomicsTelemetry,
+  createApifyPlatformHooks,
+  loadApifyActorInput,
+  runGoogleAdsTransparencyActor,
+  MCP_MAX_ENVELOPE_BYTES,
+  MCP_MAX_ITEMS_LIMIT,
+  MCP_MAX_REQ_ID_BYTES,
+  SUPPORTED_MCP_PROTOCOL_VERSIONS,
+  ENCODED_BRAND_ICON_DATA_URI,
+  MCP_SERVER_INFO,
+  MCP_TOOLS_MANIFEST,
+  sliceUtf8Safe,
+  truncateMcpResponseEnvelope,
+  validateMcpToolArguments,
+  handleMcpJsonRpcRequest,
+  PLAYGROUND_CSP_HEADER,
+  MAX_PLAYGROUND_BODY_BYTES,
+  PLAYGROUND_REQUEST_TIMEOUT_MS,
+  createAdPulsePreviewServer,
+};
+
+export async function runCli(argv = process.argv.slice(2)) {
+  const args = Array.isArray(argv) ? argv : [];
+  if (args.includes('--playground')) {
+    const portArg = Number(process.env.PORT || 4410);
+    const srv = await createAdPulsePreviewServer({ port: portArg });
+    process.stdout.write(`RevClamp AdPulse Web Playground listening on ${srv.url}\n`);
+    return srv;
+  }
+
+  if (args.includes('--mcp-stdio')) {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      terminal: false,
+    });
+    for await (const line of rl) {
+      const trimmed = line.trim();
+      if (!trimmed) {
+        continue;
+      }
+      let parsedReq;
+      try {
+        parsedReq = JSON.parse(trimmed);
+      } catch {
+        process.stdout.write(
+          `${JSON.stringify({
+            jsonrpc: '2.0',
+            id: null,
+            error: { code: -32700, message: 'Parse error' },
+          })}\n`
+        );
+        continue;
+      }
+
+      try {
+        const res = await handleMcpJsonRpcRequest(parsedReq);
+        if (res !== null && res !== undefined) {
+          process.stdout.write(`${JSON.stringify(res)}\n`);
+        }
+      } catch (err) {
+        const hasId =
+          parsedReq &&
+          typeof parsedReq === 'object' &&
+          !Array.isArray(parsedReq) &&
+          Object.prototype.hasOwnProperty.call(parsedReq, 'id') &&
+          parsedReq.id !== undefined;
+        if (hasId) {
+          process.stdout.write(
+            `${JSON.stringify({
+              jsonrpc: '2.0',
+              id: typeof parsedReq.id === 'string' || typeof parsedReq.id === 'number' ? parsedReq.id : null,
+              error: { code: -32603, message: `Internal error: ${err?.message || String(err)}` },
+            })}\n`
+          );
+        }
+      }
+    }
+    return null;
+  }
+
+  const inputObj = await loadApifyActorInput(args, process.env);
+  const platformHooks = createApifyPlatformHooks(process.env);
+  const res = await runGoogleAdsTransparencyActor(inputObj, platformHooks);
+  process.stdout.write(`${JSON.stringify(res, null, 2)}\n`);
+  process.exit(res.ok ? 0 : 1);
+}
+
+function isExecutedAsMainModule(metaUrl) {
+  if (!process.argv[1]) return false;
+  try {
+    const entryPath = fs.realpathSync(process.argv[1]);
+    const selfPath = fs.realpathSync(fileURLToPath(metaUrl));
+    return entryPath === selfPath;
+  } catch {
+    return false;
+  }
+}
+
+if (isExecutedAsMainModule(import.meta.url)) {
+  runCli().catch((err) => {
+    process.stderr.write(`Fatal error in RevClamp AdPulse CLI: ${err?.message || String(err)}\n`);
+    process.exit(1);
+  });
+}

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@revclamp/google-ads-transparency-mcp-actor",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "mcpName": "com.revclamp/google-ads-transparency-mcp-actor",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "RevClamp AdPulse - For Google Ads Transparency Center (MCP & Apify Actor). Independent intelligence tool by RevClamp; not affiliated with or endorsed by Google LLC.",
+  "homepage": "https://revclamp.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lhphong09t2/revclamp-mcp.git",
+    "directory": "products/google-ads-transparency-mcp-actor"
+  },
+  "license": "MIT",
+  "main": "./index.mjs",
+  "bin": {
+    "google-ads-transparency-mcp-actor": "./index.mjs",
+    "google-ads-transparency-mcp": "./index.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "src/",
+    "assets/",
+    "actor_config.json",
+    "server.json",
+    "glama.json",
+    ".well-known/",
+    ".actor/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node ./index.mjs",
+    "mcp": "node ./index.mjs --mcp-stdio",
+    "playground": "node ./src/web_preview_server.mjs",
+    "test": "node --test ./test/google_ads_transparency.test.mjs ./test/metamorphic_and_mutation.test.mjs ./test/cdp_zero_false_green_e2e.test.mjs"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/server.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
+  "name": "com.revclamp/google-ads-transparency-mcp-actor",
+  "title": "RevClamp AdPulse (Google Ads Transparency MCP)",
+  "description": "Find verified Google Ads advertiser entities and extract active or historical ad creatives (Text, Image, Video), preview links, and run dates. Independent intelligence tool by RevClamp; not affiliated with or endorsed by Google LLC.",
+  "version": "1.0.0",
+  "websiteUrl": "https://revclamp.com",
+  "repository": {
+    "url": "https://github.com/lhphong09t2/revclamp-mcp",
+    "source": "github",
+    "subfolder": "products/google-ads-transparency-mcp-actor"
+  },
+  "icons": [
+    {
+      "src": "https://revclamp.com/apple-touch-icon.png",
+      "mimeType": "image/png",
+      "sizes": ["180x180"]
+    },
+    {
+      "src": "https://revclamp.com/favicon.png",
+      "mimeType": "image/png",
+      "sizes": ["32x32"]
+    }
+  ],
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@revclamp/google-ads-transparency-mcp-actor",
+      "version": "1.0.0",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}