suparank 1.2.5 → 1.2.7

package/credentials.example.json

@@ -1,8 +1,24 @@
 {
+  "wordpress": {
+    "site_url": "https://your-site.com",
+    "secret_key": "YOUR_KEY_FROM_SUPARANK_CONNECTOR_PLUGIN"
+  },
+
+  "ghost": {
+    "api_url": "https://your-site.ghost.io",
+    "admin_api_key": "your-key-id:your-secret-in-hex"
+  },
+
   "image_provider": "fal",
 
   "fal": {
-    "api_key": "your-fal-api-key"
+    "api_key": "your-fal-api-key",
+    "model": "fal-ai/flux-pro/v1.1"
+  },
+
+  "gemini": {
+    "api_key": "your-google-api-key",
+    "model": "gemini-2.0-flash-preview-image-generation"
   },
 
   "wiro": {
@@ -11,24 +27,26 @@
     "model": "google/nano-banana-pro"
   },
 
-  "gemini": {
-    "api_key": "your-google-ai-api-key"
-  },
-
-  "wordpress": {
-    "site_url": "https://your-site.com",
-    "secret_key": "from-suparank-connector-plugin"
+  "webhooks": {
+    "default_url": "https://your-default-webhook.com/endpoint",
+    "make_url": "https://hook.eu1.make.com/xxxxx",
+    "n8n_url": "https://your-n8n.com/webhook/xxxxx",
+    "zapier_url": "https://hooks.zapier.com/hooks/catch/xxxxx",
+    "slack_url": "https://hooks.slack.com/services/T00/B00/xxxxx"
   },
 
-  "ghost": {
-    "api_url": "https://your-ghost-site.com",
-    "admin_api_key": "your-admin-api-key"
-  },
+  "external_mcps": [
+    {
+      "name": "seo-research-mcp",
+      "description": "Provides real keyword data from SEO APIs",
+      "available_tools": ["get_keyword_data", "analyze_serp", "get_backlinks"]
+    }
+  ],
 
-  "webhooks": {
-    "slack_url": "https://hooks.slack.com/services/xxx",
-    "make_url": "https://hook.make.com/xxx",
-    "n8n_url": "https://your-n8n.com/webhook/xxx",
-    "zapier_url": "https://hooks.zapier.com/xxx"
-  }
+  "tool_instructions": [
+    {
+      "tool_name": "keyword_research",
+      "composition_hints": "For accurate search volume data, use seo-research-mcp's get_keyword_data tool."
+    }
+  ]
 }

package/mcp-client/config.js

@@ -0,0 +1,37 @@
+/**
+ * Suparank MCP - Configuration
+ *
+ * Centralized configuration and constants
+ */
+
+// Parse command line arguments
+export const projectSlug = process.argv[2]
+export const apiKey = process.argv[3]
+export const apiUrl = process.env.SUPARANK_API_URL || 'https://api.suparank.io'
+
+// External API endpoints - configurable via environment variables
+export const API_ENDPOINTS = {
+  fal: process.env.FAL_API_URL || 'https://fal.run/fal-ai/nano-banana-pro',
+  gemini: process.env.GEMINI_API_URL || 'https://generativelanguage.googleapis.com/v1beta/models',
+  wiro: process.env.WIRO_API_URL || 'https://api.wiro.ai/v1',
+  wiroTaskDetail: process.env.WIRO_TASK_URL || 'https://api.wiro.ai/v1/Task/Detail'
+}
+
+// Session expiration (24 hours)
+export const SESSION_EXPIRY_MS = 24 * 60 * 60 * 1000
+
+// Tools that are visible in the MCP tool list
+export const VISIBLE_TOOLS = [
+  // Essential (5) - Main workflow
+  'create_content', 'keyword_research', 'generate_image', 'publish_content', 'get_session',
+  // Session Management (5) - Content lifecycle
+  'save_content', 'list_content', 'load_content', 'remove_article', 'clear_session'
+]
+
+// Default stats object
+export const DEFAULT_STATS = {
+  tool_calls: 0,
+  images_generated: 0,
+  articles_created: 0,
+  words_written: 0
+}

package/mcp-client/handlers/action.js

@@ -0,0 +1,33 @@
+/**
+ * Suparank MCP - Action Tool Handler
+ *
+ * Dispatches action tools that run locally using credentials
+ */
+
+import {
+  executeImageGeneration,
+  executeWordPressPublish,
+  executeGhostPublish,
+  executeSendWebhook
+} from '../publishers/index.js'
+
+/**
+ * Execute an action tool locally using credentials
+ * @param {string} toolName - Name of the action tool
+ * @param {object} args - Tool arguments
+ * @returns {Promise<object>} MCP response
+ */
+export async function executeActionTool(toolName, args) {
+  switch (toolName) {
+    case 'generate_image':
+      return await executeImageGeneration(args)
+    case 'publish_wordpress':
+      return await executeWordPressPublish(args)
+    case 'publish_ghost':
+      return await executeGhostPublish(args)
+    case 'send_webhook':
+      return await executeSendWebhook(args)
+    default:
+      throw new Error(`Unknown action tool: ${toolName}`)
+  }
+}

package/mcp-client/handlers/backend.js

@@ -0,0 +1,43 @@
+/**
+ * Suparank MCP - Backend Tool Handler
+ *
+ * Executes tools via the Suparank API backend
+ */
+
+import { log } from '../utils/logging.js'
+import { apiUrl, apiKey, projectSlug } from '../config.js'
+
+/**
+ * Call a tool on the Suparank backend API
+ * @param {string} toolName - Name of the tool to execute
+ * @param {object} args - Tool arguments
+ * @returns {Promise<object>} Tool result from backend
+ */
+export async function callBackendTool(toolName, args) {
+  try {
+    const response = await fetch(`${apiUrl}/tools/${projectSlug}/${toolName}`, {
+      method: 'POST',
+      headers: {
+        'Authorization': `Bearer ${apiKey}`,
+        'Content-Type': 'application/json'
+      },
+      body: JSON.stringify({ arguments: args })
+    })
+
+    if (!response.ok) {
+      const error = await response.text()
+
+      if (response.status === 401) {
+        throw new Error(`Invalid or expired API key. Please create a new one in the dashboard.`)
+      }
+
+      throw new Error(`Tool execution failed: ${error}`)
+    }
+
+    const result = await response.json()
+    return result
+  } catch (error) {
+    log('Error calling tool:', error.message)
+    throw error
+  }
+}

package/mcp-client/handlers/index.js

@@ -0,0 +1,9 @@
+/**
+ * Suparank MCP - Handlers Module
+ *
+ * Re-exports all tool handlers
+ */
+
+export { callBackendTool } from './backend.js'
+export { executeActionTool } from './action.js'
+export { executeOrchestratorTool } from './orchestrator.js'