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

package/.actor/actor.json

@@ -0,0 +1,17 @@
+{
+  "actorSpecification": 1,
+  "name": "google-ads-transparency-mcp-actor",
+  "title": "RevClamp AdPulse - For Google Ads Transparency Center (MCP & Apify Actor)",
+  "description": "Find verified Google Ads advertiser entities from any brand or domain (e.g. nike.com -> Nike, Inc.) and extract active and historical ad creatives (Text, Image, Video), preview URLs, and run dates with zero browser or proxy overhead. Independent intelligence tool by RevClamp; not affiliated with or endorsed by Google LLC.",
+  "version": "1.0",
+  "buildTag": "latest",
+  "minMemoryMbytes": 256,
+  "maxMemoryMbytes": 512,
+  "defaultRunOptions": {
+    "build": "latest",
+    "timeoutSecs": 25,
+    "memoryMbytes": 256
+  },
+  "input": "./input_schema.json",
+  "dockerfile": "../Dockerfile"
+}

package/.actor/input_schema.json

@@ -0,0 +1,76 @@
+{
+  "title": "RevClamp AdPulse - For Google Ads Transparency Center (MCP & Apify Actor)",
+  "type": "object",
+  "schemaVersion": 1,
+  "properties": {
+    "query": {
+      "title": "Brand Name or Domain",
+      "type": "string",
+      "description": "Brand name or domain to match against verified Google Ads Transparency advertiser entities (e.g. 'nike.com', 'Stripe', 'shopify.com').",
+      "maxLength": 512,
+      "editor": "textfield",
+      "example": "nike.com"
+    },
+    "advertiserId": {
+      "title": "Advertiser ID (Optional)",
+      "type": "string",
+      "description": "Optional Google Ads Transparency Advertiser ID (e.g. 'AR16735076323512287233'). When provided, queries this exact advertiser directly.",
+      "editor": "textfield"
+    },
+    "countryCode": {
+      "title": "Country Filter (Optional)",
+      "type": "string",
+      "description": "Optional 2-letter ISO country code filter (e.g. 'US'). Leave blank for all regions.",
+      "editor": "textfield"
+    },
+    "formatFilter": {
+      "title": "Ad Format",
+      "type": "string",
+      "description": "Filter returned ad creatives by format (ALL, TEXT, IMAGE, or VIDEO).",
+      "enum": ["ALL", "TEXT", "IMAGE", "VIDEO"],
+      "default": "ALL"
+    },
+    "includeSubsidiaries": {
+      "title": "Include Regional Subsidiaries",
+      "type": "boolean",
+      "description": "When enabled, matches up to 3 verified regional legal entities for the same brand (e.g. Stripe, Inc. US and Stripe Payments Europe, Limited IE).",
+      "default": true
+    },
+    "includeCreativeDetails": {
+      "title": "Include Creative Region & Legal Details",
+      "type": "boolean",
+      "description": "When enabled, fetches detailed regional presence and legal entity records for up to 10 returned creatives (default 5).",
+      "default": false
+    },
+    "includeAdCopy": {
+      "title": "Include Static Ad Copy (Optional)",
+      "type": "boolean",
+      "description": "When enabled alongside Include Creative Region & Legal Details, extracts static headline, body text, CTA, and destination domain from allowlisted preview scripts without eval.",
+      "default": false
+    },
+    "maxEntities": {
+      "title": "Max Advertiser Entities",
+      "type": "integer",
+      "description": "Maximum number of verified advertiser entities to query when regional subsidiaries are included (1 to 3).",
+      "minimum": 1,
+      "maximum": 3,
+      "default": 3
+    },
+    "maxResults": {
+      "title": "Max Creatives to Extract",
+      "type": "integer",
+      "description": "Maximum number of deduplicated ad creatives to extract in this run (1 to 200).",
+      "minimum": 1,
+      "maximum": 200,
+      "default": 40
+    },
+    "pageToken": {
+      "title": "Next-Page Cursor Token (Optional)",
+      "type": "string",
+      "description": "Optional continuation token returned by a previous run to resume from the next creative.",
+      "maxLength": 2048,
+      "editor": "textfield"
+    }
+  },
+  "required": []
+}

package/.well-known/glama.json

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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RevClamp Enterprise (https://revclamp.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,40 @@
-# Temporary Holding Version
+# RevClamp AdPulse - For Google Ads Transparency Center (MCP & Apify Actor)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> **Disclaimer:** Independent intelligence tool by RevClamp; not affiliated with or endorsed by Google LLC.
+
+Find verified Google Ads advertiser entities and extract active or historical ad creatives (Text, Image, Video), preview links, and run dates directly from the Google Ads Transparency Center (`adstransparency.google.com`) with zero browser or residential proxy overhead. Available as both an Apify Pay-per-Event Actor and a Model Context Protocol (MCP) server (`@revclamp/google-ads-transparency-mcp-actor`).
+
+- **Canonical Publisher Website:** [https://revclamp.com](https://revclamp.com)
+- **Official MCP Package:** `@revclamp/google-ads-transparency-mcp-actor` (`com.revclamp/google-ads-transparency-mcp-actor`)
+
+## Key Capabilities
+
+1. **Smart Advertiser Entity Matching (`SearchSuggestions`):**
+   - Matches internationalized domains (`nike.com`, `stripe.com`, `shopify.co.uk`, `brand.myshopify.com`, `on-running.com`, `bankofamerica.com`, `thenorthface.com`) and multi-token or Unicode brand queries (CJK/Hangul corporate names, `"The Coca-Cola Company"`, `L'Oréal`) to verified Google Ads Transparency legal entities (`AR...`).
+   - Prevents substring lookalike mismatches where querying `nike.com` selects `NIKETA'S COMPANY S.R.L.` instead of `Nike, Inc.` (`AR16735076323512287233`), and enforces a strict leading-word identity gate so middle-word lookalikes (`Big Apple Pizza LLC`) or unrelated same-first-word companies (`Nike AI Solutions`) are never admitted as corporate subsidiaries.
+   - Supports regional subsidiary inclusion (`includeSubsidiaries: true`, up to 3 verified regional corporate entities such as `Stripe, Inc.` US + `Stripe Payments Europe, Limited` IE).
+2. **Paginated Creative & Asset Extraction (`SearchCreatives` & `LookupService/GetCreativeById`):**
+   - Maps ISO-2 `countryCode` filters to Google Ads Geo Target Criterion IDs (`US -> 2840`, `GB -> 2826`, `DE -> 2276`, `SG -> 2702`, `VN -> 2704`) and extracts normalized `TEXT`, `IMAGE`, and `VIDEO` ad creatives with decoded `previewUrl`, `archiveImageUrls`, `firstSeenAtIso`, `lastSeenAtIso`, `daysActive`, `timestampsRepaired`, `regionalPresence`, and `transparencyUrl`.
+   - Preserves mid-page pagination resume via opaque continuation cursors (`rcp1_...`, `maxLength: 2048`, with query-scope hash `qh`, raw page length `rl`, and anchor `creativeId` `ac`) and automatically rewinds `pagination.nextPageToken` whenever `maxResults`, Apify `CHARGE_LIMIT_REACHED`, `DEADLINE_EXCEEDED_BEFORE_CHARGE`, or the 30,000-byte MCP response ceiling truncates a page. Pass the returned `pagination.nextPageToken` back as `pageToken` in the next Actor input or MCP tool call to resume without duplicate charges or skipped creatives.
+3. **Zero-Charge Schema Guard, Rate-Limit Safety & Crash-Safe Apify Billing:**
+   - Separates legitimate empty results (`EMPTY_RESULT`) from upstream HTTP errors (`UPSTREAM_ERROR`), rate-limiting/CAPTCHA challenges (`UPSTREAM_RATE_LIMITED`), and protobuf-JSON schema changes (`SCHEMA_DRIFT_HALT`), halting before any Pay-per-Event billing charge is emitted.
+   - Integrates natively with Apify Cloud (`ACTOR_RUN_ID`, `ACTOR_DEFAULT_DATASET_ID`, `ACTOR_DEFAULT_KEY_VALUE_STORE_ID`, `ACTOR_MEMORY_MBYTES`, with fallback to `APIFY_*` legacy aliases), writes the run summary and `pagination.nextPageToken` to the default Key-Value Store `OUTPUT` record on every exit path as well as stdout, and tracks `inFlightIds`, `chargedIds`, `deliveredIds`, `unknownOutcomeIds`, and `stagedItemsById` with bounded `pushData` retry so transient failures or same-run resumptions never double-charge or lose staged paid payloads.
+
+## CLI & Verification
+
+```bash
+# Run MCP stdio server
+npx @revclamp/google-ads-transparency-mcp-actor --mcp-stdio
+
+# Start local interactive web playground on http://127.0.0.1:4410
+npm run playground
+
+# Run full unit, golden-corpus, metamorphic, mutation, and CDP E2E test suites
+npm test
+```
+
+## Terms of Use, Data Provenance & Independent Tool Disclaimer
+
+- **Public Transparency Records Only:** RevClamp AdPulse queries publicly accessible transparency disclosures published on the Google Ads Transparency Center (`adstransparency.google.com`) for research, brand-safety auditing, regulatory compliance, and competitive ad intelligence.
+- **No Circumvention or Personal Data:** This tool operates strictly against unauthenticated public transparency endpoints, enforces a strict hostname allowlist (`adstransparency.google.com`, `displayads-formats.googleusercontent.com`, `tpc.googlesyndication.com`), strips cookies and credentials on egress, and halts immediately (`UPSTREAM_RATE_LIMITED`) if upstream rate limits or CAPTCHA challenges (`HTTP 429` / `/sorry/`) are encountered.
+- **Trademark & Affiliation Notice:** "Google" and "Google Ads" are trademarks of Google LLC. RevClamp AdPulse is an independent software tool developed by RevClamp and is not affiliated with, sponsored by, or endorsed by Google LLC.

package/actor_config.json

@@ -0,0 +1,29 @@
+{
+  "actorType": "apify_actor",
+  "pricingModel": {
+    "type": "pay_per_event",
+    "priceUsdc": 0.0012,
+    "costCeilingUsdc": 0.0001,
+    "platformFeeRate": 0.2,
+    "minMarginMultiplier": 2.5
+  },
+  "resourceLimits": {
+    "maxTimeoutSec": 25,
+    "maxMemoryMb": 256,
+    "maxPayloadBytes": 30000
+  },
+  "allowedEgressUrls": [
+    "https://adstransparency.google.com/anji/_/rpc/SearchService/SearchSuggestions",
+    "https://adstransparency.google.com/anji/_/rpc/SearchService/SearchCreatives",
+    "https://adstransparency.google.com/anji/_/rpc/LookupService/GetCreativeById",
+    "https://displayads-formats.googleusercontent.com/ads/preview/content.js",
+    "https://tpc.googlesyndication.com/archive/simgad/1"
+  ],
+  "manifest": {
+    "name": "google-ads-transparency-mcp-actor",
+    "version": "1.0.1",
+    "title": "RevClamp AdPulse - For Google Ads Transparency Center (MCP & Apify Actor)",
+    "websiteUrl": "https://revclamp.com",
+    "description": "Find verified Google Ads advertiser entities and extract active or historical ad creatives (Text, Image, Video), preview links, and run dates without browser or proxy overhead. Independent intelligence tool by RevClamp; not affiliated with or endorsed by Google LLC."
+  }
+}

package/assets/icon.svg

@@ -0,0 +1,26 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-labelledby="rc-title">
+  <title id="rc-title">RevClamp AdPulse</title>
+  <defs>
+    <linearGradient id="rc-fill" gradientUnits="userSpaceOnUse" x1="32" y1="6" x2="32" y2="58">
+      <stop offset="0" stop-color="#111C38"/>
+      <stop offset="1" stop-color="#0B1020"/>
+    </linearGradient>
+    <linearGradient id="rc-edge" gradientUnits="userSpaceOnUse" x1="11" y1="6" x2="53" y2="58">
+      <stop offset="0" stop-color="#10B981"/>
+      <stop offset="1" stop-color="#06B6D4"/>
+    </linearGradient>
+  </defs>
+  <rect width="64" height="64" rx="14" fill="#0B1020"/>
+  <path d="M32 6L53 13.5V31C53 44 44.5 52.5 32 58C19.5 52.5 11 44 11 31V13.5Z" fill="url(#rc-fill)" stroke="url(#rc-edge)" stroke-width="2" stroke-linejoin="round"/>
+  <path d="M38.5 36.5L44.5 42.5" stroke="#F59E0B" stroke-width="4" stroke-linecap="round" fill="none"/>
+  <circle cx="30.5" cy="28.5" r="12.5" fill="#0B1020"/>
+  <path d="M30.5 17.5V39.5M19.5 28.5H41.5" stroke="#06B6D4" stroke-opacity="0.35" stroke-width="1.2" fill="none"/>
+  <circle cx="30.5" cy="28.5" r="6" stroke="#06B6D4" stroke-opacity="0.5" stroke-width="1.2" fill="none"/>
+  <path d="M30.5 28.5V17.5A11 11 0 0 1 40.03 23Z" fill="#10B981" fill-opacity="0.38"/>
+  <path d="M30.5 28.5V17.5" stroke="#10B981" stroke-width="1.6" stroke-linecap="round" fill="none"/>
+  <circle cx="34" cy="22.4" r="4" fill="#F59E0B" fill-opacity="0.25"/>
+  <circle cx="34" cy="22.4" r="2.4" fill="#F59E0B"/>
+  <circle cx="25.5" cy="33" r="4.2" fill="#10B981"/>
+  <path d="M23.4 33.2L24.9 34.7L27.7 31.4" stroke="#0B1020" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
+  <circle cx="30.5" cy="28.5" r="12.5" stroke="#F8FAFC" stroke-width="2.5" fill="none"/>
+</svg>

package/assets/playground.css

@@ -0,0 +1,468 @@
+:root {
+  --bg-obsidian: #0b1020;
+  --bg-panel: #111c38;
+  --bg-card: #162344;
+  --border-subtle: #243560;
+  --text-primary: #f8fafc;
+  --text-secondary: #cbd5e1;
+  --text-muted: #94a3b8;
+  --accent-emerald: #10b981;
+  --accent-emerald-hover: #059669;
+  --accent-cyan: #06b6d4;
+  --accent-amber: #f59e0b;
+  --danger-rose: #f43f5e;
+  --font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+  --font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+}
+
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+html {
+  scroll-padding-top: 80px;
+  background-color: var(--bg-obsidian);
+  color: var(--text-primary);
+  font-family: var(--font-sans);
+  line-height: 1.5;
+  -webkit-text-size-adjust: 100%;
+}
+
+body {
+  margin: 0;
+  padding: 0;
+  min-height: 100vh;
+  display: flex;
+  flex-direction: column;
+  overflow-x: hidden;
+  background: radial-gradient(circle at 15% 0%, #15254b 0%, var(--bg-obsidian) 65%);
+}
+
+.site-header {
+  background: rgba(11, 16, 32, 0.96);
+  border-bottom: 1px solid var(--border-subtle);
+  padding: 12px 16px;
+}
+
+.header-inner {
+  max-width: 1360px;
+  margin: 0 auto;
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+}
+
+.brand-group {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  min-width: 0;
+}
+
+.brand-logo {
+  width: 36px;
+  height: 36px;
+  flex-shrink: 0;
+  border-radius: 8px;
+}
+
+.brand-titles {
+  min-width: 0;
+}
+
+.brand-title {
+  margin: 0;
+  font-size: 1.05rem;
+  font-weight: 700;
+  letter-spacing: -0.01em;
+  color: var(--text-primary);
+  overflow-wrap: anywhere;
+}
+
+.brand-subtitle {
+  margin: 2px 0 0;
+  font-size: 0.8rem;
+  color: var(--text-secondary);
+  overflow-wrap: anywhere;
+}
+
+.header-badges {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px;
+}
+
+.badge {
+  display: inline-flex;
+  align-items: center;
+  padding: 4px 10px;
+  border-radius: 999px;
+  font-size: 0.75rem;
+  font-weight: 600;
+  border: 1px solid var(--border-subtle);
+  background: var(--bg-panel);
+  color: var(--text-secondary);
+}
+
+.badge-emerald {
+  border-color: rgba(16, 185, 129, 0.45);
+  background: rgba(16, 185, 129, 0.14);
+  color: #6ee7b7;
+}
+
+.badge-cyan {
+  border-color: rgba(6, 182, 212, 0.45);
+  background: rgba(6, 182, 212, 0.14);
+  color: #67e8f9;
+}
+
+.badge-amber {
+  border-color: rgba(245, 158, 11, 0.45);
+  background: rgba(245, 158, 11, 0.14);
+  color: #fde68a;
+}
+
+.workbench-main {
+  flex: 1;
+  width: 100%;
+  max-width: 1360px;
+  margin: 0 auto;
+  padding: 16px;
+  display: grid;
+  grid-template-columns: 1fr;
+  gap: 16px;
+}
+
+@media (min-width: 720px) {
+  .workbench-main {
+    grid-template-columns: minmax(290px, 380px) minmax(0, 1fr);
+    align-items: start;
+  }
+}
+
+.panel {
+  background: var(--bg-panel);
+  border: 1px solid var(--border-subtle);
+  border-radius: 12px;
+  padding: 16px;
+  min-width: 0;
+}
+
+.panel-heading {
+  margin: 0 0 12px;
+  font-size: 0.95rem;
+  font-weight: 600;
+  color: var(--text-primary);
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+}
+
+.panel-heading-title {
+  margin: 0;
+  font-size: 0.95rem;
+  font-weight: 600;
+  color: var(--text-primary);
+}
+
+.export-actions-row {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px;
+}
+
+.btn:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+.form-stack {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  min-width: 0;
+}
+
+.field-group {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  min-width: 0;
+}
+
+.field-label {
+  font-size: 0.82rem;
+  font-weight: 600;
+  color: var(--text-secondary);
+}
+
+.field-hint {
+  font-size: 0.74rem;
+  color: var(--text-muted);
+  overflow-wrap: anywhere;
+}
+
+.input-control,
+.select-control {
+  width: 100%;
+  min-height: 44px;
+  padding: 8px 12px;
+  border-radius: 8px;
+  border: 1px solid var(--border-subtle);
+  background: var(--bg-obsidian);
+  color: var(--text-primary);
+  font-size: 0.9rem;
+  font-family: var(--font-sans);
+}
+
+.input-control:focus,
+.select-control:focus,
+.btn:focus {
+  outline: 2px solid var(--accent-cyan);
+  outline-offset: 2px;
+}
+
+.checkbox-row {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  min-height: 44px;
+  padding: 4px 0;
+  cursor: pointer;
+  font-size: 0.85rem;
+  color: var(--text-secondary);
+}
+
+.checkbox-input {
+  width: 22px;
+  height: 22px;
+  accent-color: var(--accent-emerald);
+  cursor: pointer;
+  flex-shrink: 0;
+}
+
+.button-row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 10px;
+  margin-top: 4px;
+}
+
+.btn {
+  min-height: 44px;
+  min-width: 44px;
+  padding: 10px 16px;
+  border-radius: 8px;
+  border: 1px solid transparent;
+  font-size: 0.88rem;
+  font-weight: 600;
+  cursor: pointer;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 8px;
+  text-decoration: none;
+  transition: background-color 0.15s ease, border-color 0.15s ease;
+}
+
+.btn-primary {
+  background: var(--accent-emerald);
+  color: #04130e;
+  flex: 1;
+}
+
+.btn-primary:hover {
+  background: var(--accent-emerald-hover);
+}
+
+.btn-secondary {
+  background: var(--bg-card);
+  border-color: var(--border-subtle);
+  color: var(--text-primary);
+}
+
+.btn-secondary:hover {
+  border-color: var(--accent-cyan);
+}
+
+.btn[ hidden ],
+.hidden {
+  display: none !important;
+}
+
+.status-banner {
+  padding: 10px 12px;
+  border-radius: 8px;
+  border: 1px solid var(--border-subtle);
+  background: var(--bg-obsidian);
+  font-size: 0.84rem;
+  color: var(--text-secondary);
+  margin-bottom: 12px;
+  overflow-wrap: anywhere;
+}
+
+.status-banner[data-state="ok"] {
+  border-color: rgba(16, 185, 129, 0.5);
+  color: #a7f3d0;
+}
+
+.status-banner[data-state="warn"] {
+  border-color: rgba(245, 158, 11, 0.55);
+  color: #fde68a;
+}
+
+.status-banner[data-state="error"] {
+  border-color: rgba(244, 63, 94, 0.55);
+  color: #fecdd3;
+}
+
+.telemetry-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(130px, 1fr));
+  gap: 10px;
+  margin-bottom: 14px;
+}
+
+.telemetry-card {
+  background: var(--bg-obsidian);
+  border: 1px solid var(--border-subtle);
+  border-radius: 8px;
+  padding: 10px;
+  min-width: 0;
+}
+
+.telemetry-label {
+  font-size: 0.72rem;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: var(--text-muted);
+}
+
+.telemetry-value {
+  margin-top: 4px;
+  font-size: 0.92rem;
+  font-weight: 700;
+  color: var(--text-primary);
+  font-family: var(--font-mono);
+  overflow-wrap: anywhere;
+}
+
+.cards-stack {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  min-width: 0;
+}
+
+.creative-card {
+  background: var(--bg-card);
+  border: 1px solid var(--border-subtle);
+  border-radius: 10px;
+  padding: 14px;
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+.creative-card-header {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+}
+
+.creative-title {
+  font-weight: 700;
+  font-size: 0.92rem;
+  color: var(--text-primary);
+  overflow-wrap: anywhere;
+}
+
+.creative-meta {
+  font-size: 0.8rem;
+  color: var(--text-secondary);
+  font-family: var(--font-mono);
+  overflow-wrap: anywhere;
+}
+
+.creative-ad-copy {
+  background: rgba(11, 16, 32, 0.72);
+  border: 1px solid var(--border-subtle);
+  border-radius: 8px;
+  padding: 10px 12px;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  min-width: 0;
+}
+
+.creative-ad-copy-header {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 6px;
+}
+
+.creative-ad-headline {
+  font-size: 0.88rem;
+  font-weight: 600;
+  color: var(--text-primary);
+  overflow-wrap: anywhere;
+}
+
+.creative-ad-body {
+  font-size: 0.82rem;
+  color: var(--text-secondary);
+  overflow-wrap: anywhere;
+}
+
+.creative-ad-dest {
+  font-size: 0.76rem;
+  font-family: var(--font-mono);
+  color: var(--text-muted);
+  overflow-wrap: anywhere;
+}
+
+.creative-links {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin-top: 4px;
+}
+
+.raw-json-box {
+  margin-top: 14px;
+  background: var(--bg-obsidian);
+  border: 1px solid var(--border-subtle);
+  border-radius: 8px;
+  padding: 12px;
+  font-family: var(--font-mono);
+  font-size: 0.78rem;
+  color: var(--text-secondary);
+  max-height: 360px;
+  overflow-y: auto;
+  overflow-x: auto;
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  word-break: break-word;
+}
+
+.site-footer {
+  border-top: 1px solid var(--border-subtle);
+  background: rgba(11, 16, 32, 0.95);
+  padding: 14px 16px;
+  text-align: center;
+  font-size: 0.78rem;
+  color: var(--text-muted);
+  overflow-wrap: anywhere;
+}