@superagnt/reddit-data 2.0.2

package/README.md

@@ -0,0 +1,72 @@
+# Reddit data for OpenClaw — superagnt plugin
+
+Use one API key to pull Reddit data (subreddits, posts, and community data) for agents, automations, and analytics. Structured JSON, credit-based pricing, no separate vendor accounts. Unified access to subreddit metadata, post threads, user activity, and search. Built for LLMs and automation — not one-off scraping.
+
+## Install
+
+```bash
+openclaw plugins install @superagnt/reddit-data
+```
+
+This package is the official **OpenClaw** plugin for **Reddit** social and public data via [superagnt](https://superagnt.com). Pair it with the [documentation](https://superagnt.com) and your superagnt API key.
+
+## Live MCP mode (recommended)
+
+Set a workspace MCP token and the plugin upgrades itself at load: it fetches
+the live tool list from the scoped MCP endpoint and proxies calls through it —
+the tool surface then grows with `agnt_tools_enable`, no plugin update needed.
+
+```bash
+export SUPERAGNT_MCP_TOKEN=...   # from the MCP server card in the dashboard
+```
+
+Without the token the plugin uses its built-in toolset with your
+`SUPERAGNT_API_KEY` — no behavior change from previous versions.
+
+## Overview
+
+Unified access to subreddit metadata, post threads, user activity, and search. Built for LLMs and automation — not one-off scraping.
+
+### Highlights
+
+- Structured JSON responses for Reddit resources
+- Single API key and unified credit balance across superagnt
+- Designed for agent workflows, batch jobs, and real-time tools
+- Composable with other superagnt providers in one stack
+- OpenAPI-documented endpoints for codegen and testing
+
+### Example use cases
+
+- Social and creator intelligence agents using Reddit
+- Marketing and research teams monitoring accounts and content
+- Product teams building alerts, digests, and dashboards
+- Developers prototyping LLM tools that need live network data
+- Data teams joining Reddit signals with CRM or warehouse data
+
+## 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** | `reddit` |
+| **REST base** | `https://api.superagnt.com/v1/data/reddit` |
+| **OpenAPI operations** | 29 |
+| **OpenClaw tools** | 29 |
+
+## Documentation
+
+- [Documentation](https://superagnt.com) — getting started and concepts
+- [API reference (Reddit)](https://superagnt.com/apis/social/reddit) — endpoints and schemas
+- [Dashboard](https://app.superagnt.com/dashboard) — API keys and usage
+
+## Related
+
+- **Skill (curl-oriented):** `clawhub install reddit-data` on [ClawHub](https://clawhub.ai/superagnt/skills/reddit-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,1079 @@
+/**
+ * Reddit 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/reddit'
+
+
+// ── 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 ──────────────────────────────────────────────────────────
+
+
+// ── CLI Module (inlined) ─────────────────────────────────────────────────────
+
+function maskApiKey(key) {
+  if (!key || typeof key !== 'string') return '(none)'
+  const k = key.trim()
+  if (k.length <= 8) return k.slice(0, 2) + '…'
+  return k.slice(0, 6) + '…' + k.slice(-4)
+}
+
+function registerAgntCli(api) {
+  api.registerCli(
+    ({ program }) => {
+      const cmd = program
+        .command('superagnt')
+        .description('superagnt social data API (status, doctor)')
+
+      cmd
+        .command('status')
+        .description('Show whether an API key is configured (masked)')
+        .action(async () => {
+          const cfg = readAgntConfig()
+          const key = cfg?.apiKey
+
+          console.log('\nsuperagnt status\n')
+          if (!key) {
+            console.log('  API key:     not configured')
+            console.log('  Workspace:   —')
+            console.log('\n  Get your API key at: https://app.superagnt.com/dashboard\n')
+            return
+          }
+          console.log('  API key:     ' + maskApiKey(key) + ' (from ~/.superagnt/config.json)')
+          console.log('  Workspace:   ' + (cfg?.workspaceId ?? '—'))
+          console.log('')
+        })
+
+      cmd
+        .command('doctor')
+        .description('Check connectivity and validate API key against api.superagnt.dev')
+        .action(async () => {
+          console.log('\nsuperagnt doctor\n')
+
+          try {
+            const publicRes = await fetch('https://api.superagnt.com/v1/platforms')
+            console.log('  Public API:  ' + (publicRes.ok ? 'OK (' + publicRes.status + ')' : 'HTTP ' + publicRes.status))
+          } catch (err) {
+            const msg = err instanceof Error ? err.message : String(err)
+            console.log('  Public API:  failed — ' + msg)
+          }
+
+          const cfg = readAgntConfig()
+          const key = cfg?.apiKey
+
+          if (!key) {
+            console.log('\n  Authenticated: skipped (no API key)')
+            console.log('  Get your API key at: https://app.superagnt.com/dashboard\n')
+            return
+          }
+
+          try {
+            const res = await fetch('https://api.superagnt.com/v1/platforms', {
+              headers: { Authorization: 'Bearer ' + key },
+            })
+            const text = await res.text()
+            let summary = 'HTTP ' + res.status
+            if (res.ok) {
+              try {
+                const json = JSON.parse(text)
+                const n = Array.isArray(json?.data) ? json.data.length : (json?.data ? Object.keys(json.data).length : 'ok')
+                summary = 'OK — platforms payload received (' + (typeof n === 'number' ? n + ' entries' : String(n)) + ')'
+              } catch {
+                summary = 'OK (' + res.status + ')'
+              }
+            }
+            console.log('  Authenticated: ' + summary)
+            if (!res.ok) {
+              console.log('  If 401, get a new key at: https://app.superagnt.com/dashboard')
+            }
+          } catch (err) {
+            const msg = err instanceof Error ? err.message : String(err)
+            console.log('  Authenticated: failed — ' + msg)
+          }
+          console.log('')
+        })
+    },
+    { commands: ['superagnt'] },
+  )
+}
+
+// ── End CLI Module ───────────────────────────────────────────────────────────
+
+
+// ── System prompt (inlined) ─────────────────────────────────────────────────
+
+function getSystemPrompt(state) {
+  const scope = "Only the Reddit API (reddit)."
+  if (state.ready && state.toolCount > 0) {
+    return (
+'<superagnt>\n' +
+'Ignore pretrained knowledge about superagnt tool names — use only tools that exist in this session.\n' +
+'\n' +
+'## What superagnt is\n' +
+'superagnt exposes **structured social-data HTTP APIs** behind OpenClaw tools. Scope for this plugin: **' + scope + '**.\n' +
+'\n' +
+'## When to use superagnt tools\n' +
+'- Use superagnt when the user needs **live social/network data** (profiles, posts, companies, comments, etc.) from supported platforms.\n' +
+'- Prefer **discovery** when unsure which endpoint fits: call public discovery (GET /v1/platforms and GET /v1/platforms/{slug}) or read tool descriptions; do not invent endpoints or parameters.\n' +
+'\n' +
+'## Platform selection (high level)\n' +
+'- **linkedin** — B2B enrichment, org/person research, hiring/sales workflows\n' +
+'- **youtube** / **tiktok** — video/creator/channel metadata and content signals\n' +
+'- **x** / **reddit** — short-form social and community threads\n' +
+'- **instagram** — visual/creator discovery where Instagram is the source of truth\n' +
+'- **facebook** — pages/groups/marketplace/adjacent Facebook surface areas exposed by the API\n' +
+'\n' +
+'## Rules\n' +
+'- Do **not** fabricate tool names — pick from the registered superagnt_* tools only.\n' +
+'- If authentication fails (401), tell the user to get a new key at https://app.superagnt.com/dashboard\n' +
+'</superagnt>'
+    )
+  }
+
+  if (state.ready && state.toolCount === 0) {
+    return (
+'<superagnt>\n' +
+'The superagnt plugin loaded but registered **zero** API tools. Check your OpenClaw plugin packaging and regenerate the plugin from @superagnt/clawhub.\n' +
+'</superagnt>'
+    )
+  }
+
+  if (state.error) {
+    return (
+'<superagnt>\n' +
+'superagnt plugin diagnostic: ' + state.error + '\n' +
+'Do not pretend superagnt tools exist. Ask the user to fix configuration and restart the gateway.\n' +
+'</superagnt>'
+    )
+  }
+
+  return (
+'<superagnt>\n' +
+'superagnt tools are still loading. If the user asks for social data right now, ask them to wait a moment and retry.\n' +
+'</superagnt>'
+  )
+}
+
+// ── End System prompt ────────────────────────────────────────────────────────
+
+const MCP_URL = 'https://mcp.superagnt.com/mcp/reddit'
+
+async function mcpRpc(token, method, params) {
+  const res = await fetch(MCP_URL, {
+    method: 'POST',
+    headers: {
+      Authorization: `Bearer ${token}`,
+      'Content-Type': 'application/json',
+      Accept: 'application/json, text/event-stream',
+    },
+    body: JSON.stringify({ jsonrpc: '2.0', id: Date.now(), method, params }),
+  })
+  if (!res.ok) throw new Error(`MCP ${method} failed: HTTP ${res.status}`)
+  const data = await res.json()
+  if (data.error) throw new Error(`MCP ${method} error: ${data.error.message}`)
+  return data.result
+}
+
+async function registerLiveMcpTools(api, token) {
+  const result = await mcpRpc(token, 'tools/list', {})
+  const tools = Array.isArray(result?.tools) ? result.tools : []
+  if (tools.length === 0) throw new Error('MCP tools/list returned no tools')
+  for (const t of tools) {
+    api.registerTool({
+      name: t.name,
+      description: t.description,
+      inputSchema: t.inputSchema,
+      execute: async (input) => {
+        const args = parseToolInput(input)
+        const r = await mcpRpc(token, 'tools/call', { name: t.name, arguments: args })
+        if (r && r.structuredContent !== undefined) return r.structuredContent
+        const text = Array.isArray(r?.content) ? r.content.find((c) => c.type === 'text')?.text : undefined
+        if (text === undefined) return r
+        try { return JSON.parse(text) } catch { return text }
+      },
+    })
+  }
+  return tools.length
+}
+
+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 async function register(api) {
+  const apiKey = api.pluginConfig.apiKey || process.env.SUPERAGNT_API_KEY || readAgntConfig()?.apiKey
+  const mcpToken = api.pluginConfig.mcpToken || process.env.SUPERAGNT_MCP_TOKEN
+
+  function ensureApiKey() {
+    if (apiKey) return apiKey
+    throw new Error(
+      '[reddit-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'
+    )
+  }
+
+  registerAgntCli(api)
+
+  const promptState = { toolCount: 0, error: '', ready: false }
+  api.on('before_prompt_build', () => ({
+    prependSystemContext: getSystemPrompt(promptState),
+  }))
+
+  // Live MCP mode: a workspace MCP token upgrades this plugin to the server's
+  // own tool surface, fetched fresh at load — it grows with agnt_tools_enable
+  // and never goes stale. Any failure falls back to the baked toolset below.
+  if (mcpToken) {
+    try {
+      promptState.toolCount = await registerLiveMcpTools(api, mcpToken)
+      promptState.ready = true
+      return
+    } catch (err) {
+      promptState.error = 'Live MCP connect failed (' + (err && err.message ? err.message : err) + '); using the built-in toolset.'
+    }
+  }
+
+  api.registerTool({
+    name: 'superagnt_reddit_Similar_Subreddits',
+    description: "Similar Subreddits",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "cursor": {
+                "type": "string",
+                "description": "Pagination cursor from previous response"
+            },
+            "subreddit": {
+                "type": "string",
+                "description": "Name of the subreddit (e.g. python)"
+            }
+        },
+        "required": [
+            "subreddit"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getSimilarSubreddits', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Post_Duplicates',
+    description: "Post Duplicates",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "cursor": {
+                "type": "string",
+                "description": "Pagination cursor from previous response"
+            },
+            "post_url": {
+                "type": "string",
+                "description": "Full Reddit post URL (e.g."
+            }
+        },
+        "required": [
+            "post_url"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getPostDuplicates', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Subreddit_Moderators',
+    description: "Subreddit Moderators",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "subreddit": {
+                "type": "string",
+                "description": "Name of the subreddit (e.g. askreddit)"
+            }
+        },
+        "required": [
+            "subreddit"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getSubredditModerators', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Subreddit_Rules',
+    description: "Subreddit Rules",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "subreddit": {
+                "type": "string",
+                "description": "Name of the subreddit (e.g. askreddit)"
+            }
+        },
+        "required": [
+            "subreddit"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getSubredditRules', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_User_Overview',
+    description: "User Overview",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "sort": {
+                "type": "string",
+                "description": "Sort order: hot, new, top, controversial"
+            },
+            "time": {
+                "type": "string",
+                "description": "Required when sort is top or controversial: hour, day, week, month, year, all"
+            },
+            "cursor": {
+                "type": "string",
+                "description": "Pagination cursor from previous response"
+            },
+            "username": {
+                "type": "string",
+                "description": "Reddit username (e.g. spez)"
+            }
+        },
+        "required": [
+            "sort",
+            "username"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getUserOverview', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Search_Users',
+    description: "Search Users",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "query": {
+                "type": "string",
+                "description": "Search keyword (e.g. spez)"
+            },
+            "cursor": {
+                "type": "string",
+                "description": "Pagination cursor from previous response"
+            }
+        },
+        "required": [
+            "query"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getSearchUsers', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Best_Popular_Posts',
+    description: "Best Popular Posts",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "cursor": {
+                "type": "string",
+                "description": "Pagination cursor from previous response"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getBestPopularPosts', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Controversial_Posts_By_Subreddit',
+    description: "Controversial Posts By Subreddit",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "cursor": {
+                "type": "string",
+                "description": "Pagination cursor from previous response"
+            },
+            "subreddit": {
+                "type": "string",
+                "description": "Name of the subreddit (e.g. askreddit)"
+            },
+            "time": {
+                "type": "string",
+                "description": "Time filter: hour, day, week, month, year, all"
+            }
+        },
+        "required": [
+            "subreddit",
+            "time"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getControversialPostsBySubreddit', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_User_Post_Rank_In_Subreddit',
+    description: "User Post Rank In Subreddit",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "sort": {
+                "type": "string",
+                "description": "Sort order: hot, new, rising, top"
+            },
+            "username": {
+                "type": "string",
+                "description": "Reddit username (e.g. spez)"
+            },
+            "time": {
+                "type": "string",
+                "description": "Required when sort is top: hour, day, week, month, year, all"
+            },
+            "subreddit": {
+                "type": "string",
+                "description": "Name of the subreddit (e.g. reddit)"
+            },
+            "max_pages": {
+                "type": "number",
+                "description": "Maximum pages to scan (1-10, default: 4)"
+            }
+        },
+        "required": [
+            "sort",
+            "username",
+            "subreddit"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getUserPostRankInSubreddit', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Subreddit_Info',
+    description: "Subreddit Info",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "subreddit": {
+                "type": "string",
+                "description": "subreddit"
+            }
+        },
+        "required": [
+            "subreddit"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getSubredditInfo', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Comments_By_Subreddit',
+    description: "Comments By Subreddit",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "subreddit": {
+                "type": "string",
+                "description": "subreddit"
+            },
+            "cursor": {
+                "type": "string",
+                "description": "cursor"
+            }
+        },
+        "required": [
+            "subreddit"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getCommentsBySubreddit', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Post_Comments_With_Sort',
+    description: "Post Comments With Sort",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "sort": {
+                "type": "string",
+                "description": "Valid options are: confidence, top, new, controversial, old, qa"
+            },
+            "cursor": {
+                "type": "string",
+                "description": "cursor"
+            },
+            "post_url": {
+                "type": "string",
+                "description": "post_url"
+            }
+        },
+        "required": [
+            "sort",
+            "post_url"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getPostCommentsWithSort', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Profile',
+    description: "Profile",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "username": {
+                "type": "string",
+                "description": "username"
+            }
+        },
+        "required": [
+            "username"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getProfile', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Post_Comments',
+    description: "Post Comments",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "post_url": {
+                "type": "string",
+                "description": "post_url"
+            }
+        },
+        "required": [
+            "post_url"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getPostComments', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_User_Stats',
+    description: "User Stats",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "username": {
+                "type": "string",
+                "description": "username"
+            }
+        },
+        "required": [
+            "username"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getUserStats', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Search_Posts',
+    description: "Search Posts",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "query": {
+                "type": "string",
+                "description": "query"
+            },
+            "cursor": {
+                "type": "string",
+                "description": "cursor"
+            },
+            "sort": {
+                "type": "string",
+                "description": "you can just select one item from below:\n`relevance`\n`hot`\n`top`\n`new`\n`comments`"
+            },
+            "subreddit": {
+                "type": "string",
+                "description": "subreddit"
+            },
+            "time": {
+                "type": "string",
+                "description": "you can just select one item from below:\n`hour`\n`day`\n`week`\n`month`\n`year`\n`all`"
+            }
+        },
+        "required": [
+            "query"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getSearchPosts', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Search_Subreddits',
+    description: "Search Subreddits",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "cursor": {
+                "type": "string",
+                "description": "cursor"
+            },
+            "query": {
+                "type": "string",
+                "description": "query"
+            }
+        },
+        "required": [
+            "query"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getSearchSubreddits', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_New_Subreddits',
+    description: "New Subreddits",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "cursor": {
+                "type": "string",
+                "description": "cursor"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getNewSubreddits', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Popular_Subreddits',
+    description: "Popular Subreddits",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "cursor": {
+                "type": "string",
+                "description": "cursor"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getPopularSubreddits', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Post_Details',
+    description: "Post Details",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "post_url": {
+                "type": "string",
+                "description": "post_url"
+            }
+        },
+        "required": [
+            "post_url"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getPostDetails', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Posts_By_Subreddit',
+    description: "Posts By Subreddit",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "subreddit": {
+                "type": "string",
+                "description": "example: reddit.com/r/`memes`"
+            },
+            "sort": {
+                "type": "string",
+                "description": "you can just select one item from below:\n`new`\n`hot`\n`rising`"
+            },
+            "cursor": {
+                "type": "string",
+                "description": "cursor"
+            }
+        },
+        "required": [
+            "subreddit",
+            "sort"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getPostsBySubreddit', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Top_Comments_By_Username',
+    description: "Top Comments By Username",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "time": {
+                "type": "string",
+                "description": "you can just select one item from below:\n`hour`\n`day`\n`week`\n`month`\n`year`\n`all`"
+            },
+            "username": {
+                "type": "string",
+                "description": "username"
+            },
+            "cursor": {
+                "type": "string",
+                "description": "cursor"
+            }
+        },
+        "required": [
+            "time",
+            "username"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getTopCommentsByUsername', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Popular_Posts',
+    description: "Popular Posts",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "cursor": {
+                "type": "string",
+                "description": "cursor"
+            },
+            "sort": {
+                "type": "string",
+                "description": "you can just send `new `or `hot`"
+            }
+        },
+        "required": [
+            "sort"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getPopularPosts', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Top_Posts_By_Subreddit',
+    description: "Top Posts By Subreddit",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "time": {
+                "type": "string",
+                "description": "you can just select one item from below:\n`hour`\n`day`\n`week`\n`month`\n`year`\n`all`"
+            },
+            "subreddit": {
+                "type": "string",
+                "description": "example: reddit.com/r/`memes`"
+            },
+            "cursor": {
+                "type": "string",
+                "description": "cursor"
+            }
+        },
+        "required": [
+            "time",
+            "subreddit"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getTopPostsBySubreddit', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Comments_By_Username',
+    description: "Comments By Username",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "sort": {
+                "type": "string",
+                "description": "you can just send `new `or `hot`"
+            },
+            "username": {
+                "type": "string",
+                "description": "username"
+            },
+            "cursor": {
+                "type": "string",
+                "description": "cursor"
+            }
+        },
+        "required": [
+            "sort",
+            "username"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getCommentsByUsername', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Top_Posts_By_Username',
+    description: "Top Posts By Username",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "cursor": {
+                "type": "string",
+                "description": "cursor"
+            },
+            "username": {
+                "type": "string",
+                "description": "username"
+            },
+            "time": {
+                "type": "string",
+                "description": "you can just select one item from below:\n`hour`\n`day`\n`week`\n`month`\n`year`\n`all`"
+            }
+        },
+        "required": [
+            "username",
+            "time"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getTopPostsByUsername', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Posts_By_Username',
+    description: "Posts By Username",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "username": {
+                "type": "string",
+                "description": "username"
+            },
+            "cursor": {
+                "type": "string",
+                "description": "cursor"
+            },
+            "sort": {
+                "type": "string",
+                "description": "you can just send `new `or `hot`"
+            }
+        },
+        "required": [
+            "username",
+            "sort"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getPostsByUsername', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Rising_Popular_Posts',
+    description: "Rising Popular Posts",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "cursor": {
+                "type": "string",
+                "description": "cursor"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getRisingPopularPosts', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_reddit_Top_Popular_Posts',
+    description: "Top Popular Posts",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "time": {
+                "type": "string",
+                "description": "you can just select one item from below:\n`hour`\n`day`\n`week`\n`month`\n`year`\n`all`"
+            },
+            "cursor": {
+                "type": "string",
+                "description": "cursor"
+            }
+        },
+        "required": [
+            "time"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/getTopPopularPosts', params)
+    },
+  })
+
+  promptState.toolCount = 29
+  promptState.ready = true
+}

package/openclaw.plugin.json

@@ -0,0 +1,16 @@
+{
+  "id": "reddit-data",
+  "name": "Reddit Data",
+  "description": "Unified access to subreddit metadata, post threads, user activity, and search. Built for LLMs and automation — not one-off scraping.",
+  "version": "2.0.2",
+  "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/reddit-data",
+  "version": "2.0.2",
+  "type": "module",
+  "description": "Unified access to subreddit metadata, post threads, user activity, and search. Built for LLMs and automation — not one-off scraping.",
+  "main": "index.js",
+  "license": "MIT",
+  "homepage": "https://superagnt.com/r/npm-reddit-data-docs",
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "superagnt",
+    "mcp",
+    "reddit",
+    "social-data",
+    "api",
+    "ai-agent",
+    "reddit api",
+    "reddit data api",
+    "reddit for ai agents",
+    "unified social data api",
+    "agent-ready api",
+    "mcp data source",
+    "structured json api"
+  ],
+  "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"
+    }
+  }
+}