@superagnt/seo-data 2.0.5 → 2.0.7

package/README.md

@@ -10,17 +10,11 @@ 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?
+## What this plugin contains
 
-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:
+A fixed, baked-in toolset for the **SEO** endpoints listed below — nothing else. It authenticates with your `SUPERAGNT_API_KEY` and calls the superagnt REST API directly. It does not add tools for other platforms and does not change after install; new capabilities only arrive through an explicit plugin update.
 
-```bash
-openclaw plugins install @superagnt/superagnt
-```
+Prefer MCP? The `@superagnt/superagnt` plugin connects the workspace MCP server instead, whose tool surface is managed by the user in the superagnt app.
 
 ## Overview
 
@@ -48,7 +42,7 @@ SEO and search intelligence through the superagnt unified API.
 
 ## 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).
+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 app](https://app.superagnt.com/dashboard).
 
 ## API coverage
 
@@ -56,19 +50,19 @@ Use a single **superagnt API key** (Bearer token). Set `SUPERAGNT_API_KEY` in yo
 | --- | --- |
 | **Platform** | `seo` |
 | **REST base** | `https://api.superagnt.com/v1/data/seo` |
-| **OpenAPI operations** | 16 |
-| **OpenClaw tools** | 16 |
+| **OpenAPI operations** | 22 |
+| **OpenClaw tools** | 22 |
 
 ## 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
+- [superagnt app](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.
+- **Skill (curl-oriented):** `clawhub install superagnt/seo-data` on [ClawHub](https://clawhub.ai/superagnt/skills/seo-data)
+- **All platforms plugin:** `@superagnt/social-data` if you need LinkedIn, YouTube, TikTok, X, Instagram, Reddit, and Facebook in one package.
 
 ## License
 

package/index.js

@@ -118,6 +118,10 @@ export default function register(api) {
             "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."
+            },
+            "load_async_ai_overview": {
+                "type": "boolean",
+                "description": "Set to true to load AI Overviews that Google renders asynchronously, so the `ai_overview` item comes back with its text and cited sources (`markdown`, `items`, `references`). Left off, an async overview still appears, flagged `asynchronous_ai_overview: true`, but with those fields null: you can tell an overview exists, not what it cites. In the default markdown view, the overview row lists its cited sources as `cited_domains`. Adds up to about 0.36 cents per call (roughly double the default-depth price), charged only when an overview actually had to be loaded; the response's `meta.costCents` shows what the call billed. Default false."
             }
         },
         "required": [
@@ -599,6 +603,222 @@ export default function register(api) {
     },
   })
 
+  api.registerTool({
+    name: 'superagnt_seo_chatgpt_app_answer',
+    description: "ChatGPT app answer",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "keyword": {
+                "type": "string",
+                "description": "The question to ask ChatGPT, as a user would type it."
+            },
+            "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)."
+            },
+            "force_web_search": {
+                "type": "boolean",
+                "description": "Push ChatGPT to search the web and cite current sources. Citations are still not guaranteed."
+            }
+        },
+        "required": [
+            "keyword"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/chatgpt-app-answer', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_gemini_app_answer',
+    description: "Gemini app answer",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "keyword": {
+                "type": "string",
+                "description": "The question to ask Gemini, as a user would type it."
+            },
+            "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 (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/gemini-app-answer', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_chatgpt_api_answer',
+    description: "OpenAI API answer with citations",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "user_prompt": {
+                "type": "string",
+                "description": "The question to ask the model."
+            },
+            "model_name": {
+                "type": "string",
+                "description": "The model to ask: gpt-4o-mini, gpt-4o, gpt-5-mini (default gpt-4o-mini)."
+            },
+            "max_output_tokens": {
+                "type": "integer",
+                "description": "Cap on the answer's length in tokens, 16-2048 (default 1024). Web search can push a model slightly past it. gpt-5-mini needs at least 1024."
+            },
+            "web_search": {
+                "type": "boolean",
+                "description": "Let the model search the web and cite sources (default true). Citations are still not guaranteed."
+            },
+            "force_web_search": {
+                "type": "boolean",
+                "description": "Push the model to search the web before answering. Needs `web_search`; citations are still not guaranteed."
+            },
+            "web_search_country_iso_code": {
+                "type": "string",
+                "description": "Two-letter country code the web search runs from, e.g. 'US'."
+            }
+        },
+        "required": [
+            "user_prompt"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/chatgpt-api-answer', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_claude_api_answer',
+    description: "Claude API answer with citations",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "user_prompt": {
+                "type": "string",
+                "description": "The question to ask the model."
+            },
+            "model_name": {
+                "type": "string",
+                "description": "The model to ask: claude-haiku-4-5, claude-sonnet-4-5 (default claude-haiku-4-5)."
+            },
+            "max_output_tokens": {
+                "type": "integer",
+                "description": "Cap on the answer's length in tokens, 16-2048 (default 1024). Web search can push a model slightly past it."
+            },
+            "web_search": {
+                "type": "boolean",
+                "description": "Let the model search the web and cite sources (default true). Citations are still not guaranteed."
+            },
+            "force_web_search": {
+                "type": "boolean",
+                "description": "Push the model to search the web before answering. Needs `web_search`; citations are still not guaranteed."
+            },
+            "web_search_country_iso_code": {
+                "type": "string",
+                "description": "Two-letter country code the web search runs from, e.g. 'US'."
+            }
+        },
+        "required": [
+            "user_prompt"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/claude-api-answer', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_gemini_api_answer',
+    description: "Gemini API answer with citations",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "user_prompt": {
+                "type": "string",
+                "description": "The question to ask the model."
+            },
+            "model_name": {
+                "type": "string",
+                "description": "The model to ask: gemini-2.5-flash-lite, gemini-2.5-flash, gemini-2.0-flash (default gemini-2.5-flash-lite)."
+            },
+            "max_output_tokens": {
+                "type": "integer",
+                "description": "Cap on the answer's length in tokens, 16-2048 (default 1024). Web search can push a model slightly past it."
+            },
+            "web_search": {
+                "type": "boolean",
+                "description": "Let the model search the web and cite sources (default true). Citations are still not guaranteed."
+            }
+        },
+        "required": [
+            "user_prompt"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/gemini-api-answer', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_seo_perplexity_api_answer',
+    description: "Perplexity API answer with citations",
+    parameters: {
+        "type": "object",
+        "properties": {
+            "user_prompt": {
+                "type": "string",
+                "description": "The question to ask the model."
+            },
+            "model_name": {
+                "type": "string",
+                "description": "The model to ask: sonar, sonar-pro (default sonar)."
+            },
+            "max_output_tokens": {
+                "type": "integer",
+                "description": "Cap on the answer's length in tokens, 16-2048 (default 1024). Web search can push a model slightly past it."
+            },
+            "web_search_country_iso_code": {
+                "type": "string",
+                "description": "Two-letter country code the web search runs from, e.g. 'US'. Sonar models always search the web."
+            }
+        },
+        "required": [
+            "user_prompt"
+        ]
+    },
+    execute: async (_toolCallId, input) => {
+      const key = ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/perplexity-api-answer', undefined, params)
+    },
+  })
+
   api.registerTool({
     name: 'superagnt_seo_tech_stack',
     description: "Technologies a website runs",

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "seo-data",
   "name": "SEO Data",
   "description": "SEO and search intelligence through the superagnt unified API.",
-  "version": "2.0.5",
+  "version": "2.0.7",
   "contracts": {
     "tools": [
       "superagnt_seo_google_search",
@@ -19,6 +19,12 @@
       "superagnt_seo_backlink_gap",
       "superagnt_seo_page_audit",
       "superagnt_seo_ai_visibility",
+      "superagnt_seo_chatgpt_app_answer",
+      "superagnt_seo_gemini_app_answer",
+      "superagnt_seo_chatgpt_api_answer",
+      "superagnt_seo_claude_api_answer",
+      "superagnt_seo_gemini_api_answer",
+      "superagnt_seo_perplexity_api_answer",
       "superagnt_seo_tech_stack",
       "superagnt_seo_tech_search"
     ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superagnt/seo-data",
-  "version": "2.0.5",
+  "version": "2.0.7",
   "type": "module",
   "description": "SEO and search intelligence through the superagnt unified API.",
   "main": "index.js",