@superagnt/seo-data 2.0.3

package/README.md

@@ -0,0 +1,75 @@
+# SEO data for OpenClaw — superagnt plugin
+
+Live Google results in classic and AI Mode, keyword volume and difficulty, competitor gap analysis, backlink profiles, instant page audits and AI answer visibility. One API key, MCP tools or REST. Live Google results, keyword research, competitor and backlink gaps, page audits and AI answer visibility, all as agent tools.
+
+## Install
+
+```bash
+openclaw plugins install @superagnt/seo-data
+```
+
+This package is the official **OpenClaw** plugin for **SEO** social and public data via [superagnt](https://superagnt.com). Pair it with the [documentation](https://superagnt.com/docs) and your superagnt API key.
+
+## Want the live MCP surface instead?
+
+This plugin ships a fixed, baked-in toolset that only needs your
+`SUPERAGNT_API_KEY`. For the live workspace tool surface — the full value
+layer (data sources plus workspace Postgres, schedules, canvases,
+enrichment), growing server-side with no plugin update — install the
+primary superagnt plugin instead:
+
+```bash
+openclaw plugins install @superagnt/superagnt
+```
+
+## Overview
+
+SEO and search intelligence through the superagnt unified API.
+
+### Highlights
+
+- Live Google organic results with positions, snippets and SERP features
+- Google AI Mode answers with cited sources
+- Keyword ideas, volume, CPC, difficulty and search intent
+- Ranked keywords and keyword gap for any domain
+- Backlink summaries, referring domains and link gap prospecting
+- Instant on-page audits with every detected issue
+- LLM mention metrics for answer engine optimization
+- Technology stack lookup and reverse technology search
+
+### Example use cases
+
+- Weekly rank tracking and SEO ops digests
+- Content gap research against competitors
+- Backlink gap outreach lists chained into email finding
+- Site audits page by page
+- AI answer visibility tracking for a brand
+- Prospect lists built from technology stacks
+
+## Authentication
+
+Use a single **superagnt API key** (Bearer token). Set `SUPERAGNT_API_KEY` in your environment, or complete browser login when the gateway prompts you. Create and manage keys in the [superagnt dashboard](https://app.superagnt.com/dashboard).
+
+## API coverage
+
+| | |
+| --- | --- |
+| **Platform** | `seo` |
+| **REST base** | `https://api.superagnt.com/v1/data/seo` |
+| **OpenAPI operations** | 16 |
+| **OpenClaw tools** | 16 |
+
+## Documentation
+
+- [Documentation](https://superagnt.com/docs) — getting started and concepts
+- [API reference (SEO)](https://superagnt.com/docs/apis/seo) — endpoints and schemas
+- [Dashboard](https://app.superagnt.com/dashboard) — API keys and usage
+
+## Related
+
+- **Skill (curl-oriented):** `clawhub install seo-data` on [ClawHub](https://clawhub.ai/superagnt/skills/seo-data)
+- **All platforms plugin:** `@superagnt/openclaw-agnt-data` if you need LinkedIn, YouTube, TikTok, X, Instagram, Reddit, and Facebook in one package.
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,660 @@
+/**
+ * SEO Data — OpenClaw plugin
+ * Auto-generated by @superagnt/clawhub. Do not edit by hand.
+ */
+
+import { homedir as _homedir } from 'node:os'
+import { join as _join } from 'node:path'
+import { existsSync as _existsSync, readFileSync as _readFileSync } from 'node:fs'
+
+const BASE_URL = 'https://api.superagnt.com/v1/data/seo'
+
+
+// ── Auth Module (inlined) ────────────────────────────────────────────────────
+
+function getConfigPath() {
+  return _join(_homedir(), '.superagnt', 'config.json')
+}
+
+function readAgntConfig() {
+  const configFile = getConfigPath()
+  if (!_existsSync(configFile)) return null
+  try {
+    return JSON.parse(_readFileSync(configFile, 'utf-8'))
+  } catch {
+    return null
+  }
+}
+
+// ── End Auth Module ──────────────────────────────────────────────────────────
+
+function parseToolInput(input) {
+  if (input == null) return {}
+  if (typeof input === 'object' && !Array.isArray(input)) return input
+  if (typeof input === 'string') {
+    const trimmed = input.trim()
+    if (trimmed.startsWith('{')) {
+      try { const parsed = JSON.parse(trimmed); if (typeof parsed === 'object' && parsed && !Array.isArray(parsed)) return parsed } catch {}
+    }
+    throw new Error('Invalid tool input: expected a JSON object with named parameters, got string: ' + trimmed.slice(0, 80))
+  }
+  throw new Error('Invalid tool input: expected a JSON object, got ' + typeof input)
+}
+
+function substitutePathParams(path, source) {
+  if (!source || typeof source !== 'object' || Array.isArray(source)) {
+    return { path, consumed: new Set() }
+  }
+  const consumed = new Set()
+  const next = path.replace(/\{([^/{}]+)\}/g, (_, name) => {
+    const v = source[name]
+    if (v === undefined || v === null || v === '') return `{${name}}`
+    consumed.add(name)
+    return encodeURIComponent(String(v))
+  })
+  return { path: next, consumed }
+}
+
+async function callSuperagnt(apiKey, method, path, query, body) {
+  const params = (query && typeof query === 'object' && !Array.isArray(query)) ? query : body
+  const { path: resolvedPath, consumed } = substitutePathParams(path, params)
+  const url = new URL(`${BASE_URL}${resolvedPath}`)
+  if (query && typeof query === 'object' && !Array.isArray(query)) {
+    for (const [k, v] of Object.entries(query)) {
+      if (consumed.has(k)) continue
+      if (v !== undefined && v !== '') url.searchParams.set(k, String(v))
+    }
+  }
+  const filteredBody = body && typeof body === 'object' && !Array.isArray(body)
+    ? Object.fromEntries(Object.entries(body).filter(([k]) => !consumed.has(k)))
+    : body
+  const res = await fetch(url.toString(), {
+    method,
+    headers: { Authorization: `Bearer ${apiKey}`, 'Content-Type': 'application/json' },
+    body: filteredBody ? JSON.stringify(filteredBody) : undefined,
+  })
+  if (res.status === 401) {
+    return { error: 'Invalid or expired API key. Get a new key at https://app.superagnt.com/dashboard' }
+  }
+  return res.json()
+}
+
+export default function register(api) {
+  const apiKey = api.pluginConfig.apiKey || process.env.SUPERAGNT_API_KEY || readAgntConfig()?.apiKey
+
+  function ensureApiKey() {
+    if (apiKey) return apiKey
+    throw new Error(
+      '[seo-data] No API key configured. ' +
+      'Get your key at https://app.superagnt.com/dashboard and either:\n' +
+      '  1. Export it as SUPERAGNT_API_KEY, or\n' +
+      '  2. Add apiKey to your plugin config'
+    )
+  }
+
+  api.registerTool({
+    name: 'superagnt_seo_google_search',
+    description: "Live Google search results",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "keyword": {
+                "type": "string",
+                "description": "The search query. Supports Google search operators (site:, inurl:, filetype:), which cost roughly 5x."
+            },
+            "location_code": {
+                "type": "integer",
+                "description": "Geo target as a location code. Common values: 2840 United States (default), 2826 United Kingdom, 2124 Canada, 2036 Australia, 2276 Germany, 2250 France, 2724 Spain, 2356 India, 2076 Brazil."
+            },
+            "language_code": {
+                "type": "string",
+                "description": "Two-letter language code, e.g. 'en' (default), 'de', 'es', 'fr', 'pt'."
+            },
+            "device": {
+                "type": "string",
+                "description": "Device type to emulate. Default 'desktop'."
+            },
+            "depth": {
+                "type": "integer",
+                "description": "Number of results to return, in steps of 10. Default 10 (cheapest). Each additional 10 results bills as one more results page."
+            }
+        },
+        "required": [
+            "keyword"
+        ]
+    },
+    execute: async (input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/serp', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_google_ai_mode_search',
+    description: "Google AI Mode results",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "keyword": {
+                "type": "string",
+                "description": "The question or query to run through Google AI Mode."
+            },
+            "location_code": {
+                "type": "integer",
+                "description": "Geo target as a location code. Common values: 2840 United States (default), 2826 United Kingdom, 2124 Canada, 2036 Australia, 2276 Germany."
+            },
+            "language_code": {
+                "type": "string",
+                "description": "Two-letter language code, e.g. 'en' (default)."
+            }
+        },
+        "required": [
+            "keyword"
+        ]
+    },
+    execute: async (input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/serp-ai-mode', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_keyword_ideas',
+    description: "Keyword ideas from seed keywords",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "keywords": {
+                "type": "array",
+                "description": "Seed keywords to expand (1-200)."
+            },
+            "location_code": {
+                "type": "integer",
+                "description": "Geo target as a location code. Default 2840 (United States)."
+            },
+            "language_code": {
+                "type": "string",
+                "description": "Two-letter language code. Default 'en'."
+            },
+            "limit": {
+                "type": "integer",
+                "description": "Max keyword ideas to return. Default 100. Cost scales with rows, so raise only when needed."
+            },
+            "offset": {
+                "type": "integer",
+                "description": "Pagination offset."
+            },
+            "filters": {
+                "type": "array",
+                "description": "Optional filter expression as [field, operator, value] triples joined by 'and'/'or'. Operators: =, <>, <, <=, >, >=, in, not_in, like, not_like (use %% wildcards with like). Recipes: [[\"keyword_info.search_volume\",\">\",100]] · keep only on-topic ideas: [[\"keyword\",\"like\",\"%deliverability%\"]] · combine: [[\"keyword_info.search_volume\",\">\",100],\"and\",[\"keyword_properties.keyword_difficulty\",\"<\",40]]."
+            },
+            "order_by": {
+                "type": "array",
+                "description": "Sort rules, e.g. [\"keyword_info.search_volume,desc\"]."
+            }
+        },
+        "required": [
+            "keywords"
+        ]
+    },
+    execute: async (input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/keyword-ideas', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_keyword_overview',
+    description: "Metrics for specific keywords",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "keywords": {
+                "type": "array",
+                "description": "The exact keywords to look up (1-700). Cost scales with the number of keywords."
+            },
+            "location_code": {
+                "type": "integer",
+                "description": "Geo target as a location code. Default 2840 (United States)."
+            },
+            "language_code": {
+                "type": "string",
+                "description": "Two-letter language code. Default 'en'."
+            }
+        },
+        "required": [
+            "keywords"
+        ]
+    },
+    execute: async (input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/keyword-overview', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_search_intent',
+    description: "Classify keyword search intent",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "keywords": {
+                "type": "array",
+                "description": "Keywords to classify (1-1000). Cost scales with the number of keywords."
+            },
+            "language_code": {
+                "type": "string",
+                "description": "Two-letter language code. Default 'en'."
+            }
+        },
+        "required": [
+            "keywords"
+        ]
+    },
+    execute: async (input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/search-intent', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_ranked_keywords',
+    description: "Keywords a domain ranks for",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "target": {
+                "type": "string",
+                "description": "Domain (e.g. 'example.com', no protocol) or full page URL to analyze."
+            },
+            "location_code": {
+                "type": "integer",
+                "description": "Geo target as a location code. Default 2840 (United States)."
+            },
+            "language_code": {
+                "type": "string",
+                "description": "Two-letter language code. Default 'en'."
+            },
+            "limit": {
+                "type": "integer",
+                "description": "Max keywords to return. Default 100. Cost scales with rows."
+            },
+            "offset": {
+                "type": "integer",
+                "description": "Pagination offset."
+            },
+            "filters": {
+                "type": "array",
+                "description": "Optional filter expression, e.g. [[\"ranked_serp_element.serp_item.rank_absolute\", \"<=\", 20]]."
+            },
+            "order_by": {
+                "type": "array",
+                "description": "Sort rules, e.g. [\"keyword_data.keyword_info.search_volume,desc\"]."
+            }
+        },
+        "required": [
+            "target"
+        ]
+    },
+    execute: async (input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/ranked-keywords', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_keyword_gap',
+    description: "Keyword gap between two domains",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "target1": {
+                "type": "string",
+                "description": "First domain (e.g. your domain), no protocol."
+            },
+            "target2": {
+                "type": "string",
+                "description": "Second domain (e.g. a competitor), no protocol."
+            },
+            "location_code": {
+                "type": "integer",
+                "description": "Geo target as a location code. Default 2840 (United States)."
+            },
+            "language_code": {
+                "type": "string",
+                "description": "Two-letter language code. Default 'en'."
+            },
+            "limit": {
+                "type": "integer",
+                "description": "Max intersecting keywords to return. Default 100."
+            },
+            "offset": {
+                "type": "integer",
+                "description": "Pagination offset."
+            },
+            "filters": {
+                "type": "array",
+                "description": "Optional filter expression as [field, operator, value] triples joined by 'and'/'or'. Operators: =, <>, <, <=, >, >=, in, not_in, like, not_like. Recipe (their wins, your gaps): [[\"first_domain_serp_element.rank_absolute\",\">\",20],\"and\",[\"second_domain_serp_element.rank_absolute\",\"<=\",10]]."
+            },
+            "order_by": {
+                "type": "array",
+                "description": "Sort rules."
+            }
+        },
+        "required": [
+            "target1",
+            "target2"
+        ]
+    },
+    execute: async (input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/keyword-gap', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_competitors',
+    description: "Find a domain's organic competitors",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "target": {
+                "type": "string",
+                "description": "Domain to find competitors for, no protocol."
+            },
+            "location_code": {
+                "type": "integer",
+                "description": "Geo target as a location code. Default 2840 (United States)."
+            },
+            "language_code": {
+                "type": "string",
+                "description": "Two-letter language code. Default 'en'."
+            },
+            "limit": {
+                "type": "integer",
+                "description": "Max competitor domains to return. Default 100."
+            },
+            "filters": {
+                "type": "array",
+                "description": "Optional filter expression as [field, operator, value] triples. Recipe: [[\"intersections\",\">\",50]] keeps only domains sharing 50+ keywords with the target."
+            },
+            "order_by": {
+                "type": "array",
+                "description": "Sort rules, e.g. [\"intersections,desc\"]."
+            }
+        },
+        "required": [
+            "target"
+        ]
+    },
+    execute: async (input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/competitors', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_domain_overview',
+    description: "Domain rank and traffic overview",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "target": {
+                "type": "string",
+                "description": "Domain to summarize, no protocol."
+            },
+            "location_code": {
+                "type": "integer",
+                "description": "Geo target as a location code. Default 2840 (United States)."
+            },
+            "language_code": {
+                "type": "string",
+                "description": "Two-letter language code. Default 'en'."
+            }
+        },
+        "required": [
+            "target"
+        ]
+    },
+    execute: async (input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/domain-overview', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_backlinks_summary',
+    description: "Backlink profile summary",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "target": {
+                "type": "string",
+                "description": "Domain, subdomain or full page URL. Domains without protocol; pages with protocol."
+            },
+            "include_subdomains": {
+                "type": "boolean",
+                "description": "Count links to subdomains too. Default true."
+            },
+            "exclude_internal_backlinks": {
+                "type": "boolean",
+                "description": "Ignore links from the target to itself. Default true."
+            }
+        },
+        "required": [
+            "target"
+        ]
+    },
+    execute: async (input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/backlinks-summary', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_referring_domains',
+    description: "Referring domains for a target",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "target": {
+                "type": "string",
+                "description": "Domain, subdomain or full page URL to list referring domains for."
+            },
+            "limit": {
+                "type": "integer",
+                "description": "Max referring domains to return. Default 100. Cost scales with rows."
+            },
+            "offset": {
+                "type": "integer",
+                "description": "Pagination offset."
+            },
+            "exclude_internal_backlinks": {
+                "type": "boolean",
+                "description": "Ignore links from the target to itself. Default true."
+            },
+            "filters": {
+                "type": "array",
+                "description": "Optional filter expression as [field, operator, value] triples. Operators: =, <>, <, <=, >, >=, in, not_in, like, not_like. Recipe: [[\"rank\",\">\",100]] keeps stronger referring domains (rank is the referring domain's authority, higher is better)."
+            },
+            "order_by": {
+                "type": "array",
+                "description": "Sort rules, e.g. [\"rank,desc\"]."
+            }
+        },
+        "required": [
+            "target"
+        ]
+    },
+    execute: async (input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/referring-domains', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_backlink_gap',
+    description: "Domains linking to competitors but not you",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "targets": {
+                "type": "array",
+                "description": "Competitor domains whose backlink sources to intersect (1-20)."
+            },
+            "exclude_targets": {
+                "type": "array",
+                "description": "Domains the referring sites must NOT already link to. Put your own domain here."
+            },
+            "limit": {
+                "type": "integer",
+                "description": "Max referring domains to return. Default 100."
+            },
+            "offset": {
+                "type": "integer",
+                "description": "Pagination offset."
+            },
+            "filters": {
+                "type": "array",
+                "description": "Optional filter expression, e.g. minimum domain rank."
+            },
+            "order_by": {
+                "type": "array",
+                "description": "Sort rules, e.g. [\"1.rank,desc\"]."
+            }
+        },
+        "required": [
+            "targets"
+        ]
+    },
+    execute: async (input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/backlink-gap', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_page_audit',
+    description: "Instant on-page audit of a URL",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "url": {
+                "type": "string",
+                "description": "The page URL to audit (with protocol)."
+            },
+            "enable_javascript": {
+                "type": "boolean",
+                "description": "Render JavaScript before auditing. Slower; only for JS-rendered pages."
+            }
+        },
+        "required": [
+            "url"
+        ]
+    },
+    execute: async (input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/page-audit', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_ai_visibility',
+    description: "How often LLMs mention a domain",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "targets": {
+                "type": "array",
+                "description": "Domains to measure LLM mention metrics for, no protocol. Pass at least one of targets or keywords."
+            },
+            "keywords": {
+                "type": "array",
+                "description": "Keyword phrases to measure LLM mention metrics for, as an alternative or addition to domains."
+            },
+            "limit": {
+                "type": "integer",
+                "description": "Max rows to return. Default 100. Cost scales with rows."
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/ai-visibility', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_tech_stack',
+    description: "Technologies a website runs",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "target": {
+                "type": "string",
+                "description": "Domain to inspect, no protocol."
+            }
+        },
+        "required": [
+            "target"
+        ]
+    },
+    execute: async (input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/tech-stack', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_tech_search',
+    description: "Find websites by technology",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "technologies": {
+                "type": "array",
+                "description": "Technology names the sites must run, e.g. [\"Shopify\", \"Klaviyo\"]. Multiple entries intersect."
+            },
+            "limit": {
+                "type": "integer",
+                "description": "Max domains to return. Default 100. Per-row cost is high; raise deliberately."
+            },
+            "offset": {
+                "type": "integer",
+                "description": "Pagination offset."
+            },
+            "filters": {
+                "type": "array",
+                "description": "Optional filter expression, e.g. [[\"country_iso_code\", \"=\", \"US\"]]."
+            },
+            "order_by": {
+                "type": "array",
+                "description": "Sort rules, e.g. [\"domain_rank,desc\"]."
+            }
+        },
+        "required": [
+            "technologies"
+        ]
+    },
+    execute: async (input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/tech-search', undefined, params)
+    },
+  })
+}

package/openclaw.plugin.json

@@ -0,0 +1,36 @@
+{
+  "id": "seo-data",
+  "name": "SEO Data",
+  "description": "SEO and search intelligence through the superagnt unified API.",
+  "version": "2.0.3",
+  "contracts": {
+    "tools": [
+      "superagnt_seo_google_search",
+      "superagnt_seo_google_ai_mode_search",
+      "superagnt_seo_keyword_ideas",
+      "superagnt_seo_keyword_overview",
+      "superagnt_seo_search_intent",
+      "superagnt_seo_ranked_keywords",
+      "superagnt_seo_keyword_gap",
+      "superagnt_seo_competitors",
+      "superagnt_seo_domain_overview",
+      "superagnt_seo_backlinks_summary",
+      "superagnt_seo_referring_domains",
+      "superagnt_seo_backlink_gap",
+      "superagnt_seo_page_audit",
+      "superagnt_seo_ai_visibility",
+      "superagnt_seo_tech_stack",
+      "superagnt_seo_tech_search"
+    ]
+  },
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "apiKey": {
+        "type": "string",
+        "description": "Your superagnt API key. Get one at https://app.superagnt.com/dashboard or store in ~/.superagnt/config.json via CLI login."
+      }
+    },
+    "additionalProperties": false
+  }
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@superagnt/seo-data",
+  "version": "2.0.3",
+  "type": "module",
+  "description": "SEO and search intelligence through the superagnt unified API.",
+  "main": "index.js",
+  "license": "MIT",
+  "homepage": "https://superagnt.com/r/npm-seo-data-docs",
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "superagnt",
+    "mcp",
+    "seo",
+    "social-data",
+    "api",
+    "ai-agent",
+    "seo api",
+    "serp api",
+    "keyword research api",
+    "backlink api",
+    "rank tracking api",
+    "ai agent seo tools",
+    "answer engine optimization"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "index.js",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "openclaw": {
+    "extensions": [
+      "./index.js"
+    ],
+    "compat": {
+      "pluginApi": ">=2026.3.24-beta.2",
+      "minGatewayVersion": "2026.3.24-beta.2"
+    },
+    "build": {
+      "openclawVersion": "2026.3.24-beta.2",
+      "pluginSdkVersion": "2026.3.24-beta.2"
+    }
+  }
+}