@adobe/mysticat-shared-seo-client 1.2.3 → 1.3.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [@adobe/mysticat-shared-seo-client-v1.3.0](https://github.com/adobe/spacecat-shared/compare/@adobe/mysticat-shared-seo-client-v1.2.3...@adobe/mysticat-shared-seo-client-v1.3.0) (2026-04-28)
+
+### Features
+
+* **seo-client:** return keywords[] array from getPaidPages() ([#1564](https://github.com/adobe/spacecat-shared/issues/1564)) ([71be968](https://github.com/adobe/spacecat-shared/commit/71be968ac133fc3c0d547d70e9663fcf2fe90437))
+
 ## [@adobe/mysticat-shared-seo-client-v1.2.3](https://github.com/adobe/spacecat-shared/compare/@adobe/mysticat-shared-seo-client-v1.2.2...@adobe/mysticat-shared-seo-client-v1.2.3) (2026-04-15)
 
 ### Bug Fixes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/mysticat-shared-seo-client",
-  "version": "1.2.3",
+  "version": "1.3.0",
   "description": "Shared modules of the SpaceCat Services - SEO Client",
   "type": "module",
   "engines": {

package/src/client.js

@@ -340,6 +340,23 @@ export default class SeoClient {
     };
   }
 
+  /**
+   * Fetch paid (PPC) pages and their keyword data from Semrush.
+   *
+   * Per-keyword CPC is returned as float dollars (e.g., 3.95) with null for unknown.
+   * This deliberately differs from getOrganicKeywords() which returns CPC as integer
+   * cents (e.g., 395) with 0 for unknown. The float-dollars convention was chosen for
+   * the keywords[] array because downstream consumers (import-worker, Mystique) expect
+   * dollars and the per-keyword CPC should not go through the cents round-trip used by
+   * the aggregate `value` field.
+   *
+   * @param {string} url - Domain to query
+   * @param {Object} [opts] - Options
+   * @param {string} [opts.date] - Report date
+   * @param {number} [opts.limit=200] - Max pages to return
+   * @param {string} [opts.region] - Limit to specific region
+   * @returns {Promise<{result: {pages: Array}, fullAuditRef: string}>}
+   */
   async getPaidPages(url, opts = {}) {
     if (typeof opts !== 'object' || opts === null) {
       throw new Error('Second argument must be an options object, not a positional value');
@@ -420,6 +437,15 @@ export default class SeoClient {
             ),
             0,
           ),
+          keywords: page.keywords.map((kw) => ({
+            keyword: kw.Ph,
+            traffic: kw.kwTraffic,
+            cpc: coerceValue(kw.Cp, 'float') ?? null,
+            serp_title: kw.Tt || null,
+            position: coerceValue(kw.Po, 'int') ?? null,
+            volume: coerceValue(kw.Nq, 'int') ?? null,
+            country: kw.db.toUpperCase(),
+          })),
         };
       });